Partilhar via


Controle de exibição de verificação

Importante

A partir de 1º de maio de 2025, o Azure AD B2C não estará mais disponível para compra para novos clientes. Saiba mais nas nossas Perguntas Frequentes.

Use um controle de exibição de verificação para verificar uma reivindicação, por exemplo, um endereço de e-mail ou número de telefone, com um código de verificação enviado ao usuário.

Ações de verificaçãoControle

O controle de exibição de verificação consiste em duas etapas (ações):

  1. Solicite um destino do usuário, como um endereço de e-mail ou número de telefone, para o qual o código de verificação deve ser enviado. Quando o usuário seleciona o botão Enviar código , a ação SendCode do controle de exibição de verificação é executada. A ação SendCode gera um código, constrói o conteúdo a ser enviado e o envia para o usuário. O valor do endereço pode ser pré-preenchido e servir como uma autenticação de segundo fator.

    Página de exemplo para enviar ação de código

  2. Depois que o código for enviado, o usuário lê a mensagem, insere o código de verificação no controle fornecido pelo controle de exibição e seleciona Verificar código. Ao selecionar Verificar código, a ação VerifyCode é executada para verificar o código associado ao endereço. Se o usuário selecionar Enviar novo código, a primeira ação será executada novamente.

    Página de exemplo para verificar a ação do código

Elementos necessários do Controle de Verificação

O VerificationControl deve conter os seguintes elementos:

  • O tipo do DisplayControl é VerificationControl.
  • DisplayClaims
    • Enviar para - Uma ou mais declarações especificando para onde enviar o código de verificação. Por exemplo, e-mail ou código do país e número de telefone.
    • Código de verificação - A declaração de código de verificação que o usuário fornece após o código ter sido enviado. Esta declaração deve ser definida conforme necessário, e a ControlClaimType deve ser definida como VerificationCode.
  • Declaração de saída (opcional) a ser retornada à página autodeclarada após o usuário concluir o processo de verificação. Por exemplo, e-mail ou código do país e número de telefone. O perfil técnico autodeclarado usa as declarações para persistir os dados ou aumentar as declarações de saída para a próxima etapa de orquestração.
  • Dois Actions com os seguintes nomes:
    • SendCode - Envia um código para o usuário. Esta ação geralmente contém dois perfis técnicos de validação, para gerar um código e enviá-lo.
    • VerifyCode - Verifica o código. Esta ação geralmente contém um único perfil técnico de validação.

No exemplo abaixo, uma caixa de texto de e-mail é exibida na página. Quando o usuário insere seu endereço de email e seleciona SendCode, a ação SendCode é acionada no back-end do Azure AD B2C.

Em seguida, o usuário insere o verificationCode e seleciona VerifyCode para acionar a ação VerifyCode no back-end. Se todas as validações passarem, o VerificationControl será considerado concluído e o usuário poderá continuar para a próxima etapa.

<DisplayControl Id="emailVerificationControl" UserInterfaceControlType="VerificationControl">
  <DisplayClaims>
    <DisplayClaim ClaimTypeReferenceId="email"  Required="true" />
    <DisplayClaim ClaimTypeReferenceId="verificationCode" ControlClaimType="VerificationCode" Required="true" />
  </DisplayClaims>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="email" />
  </OutputClaims>
  <Actions>
    <Action Id="SendCode">
      <ValidationClaimsExchange>
        <ValidationClaimsExchangeTechnicalProfile TechnicalProfileReferenceId="GenerateOtp" />
        <ValidationClaimsExchangeTechnicalProfile TechnicalProfileReferenceId="SendGrid" />
      </ValidationClaimsExchange>
    </Action>
    <Action Id="VerifyCode">
      <ValidationClaimsExchange>
        <ValidationClaimsExchangeTechnicalProfile TechnicalProfileReferenceId="VerifyOtp" />
      </ValidationClaimsExchange>
    </Action>
  </Actions>
</DisplayControl>