Compartilhar 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 em nossas perguntas frequentes.

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

Ações de VerificationControl

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 email 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 ao usuário. O valor do endereço pode ser preenchido previamente e servir como uma autenticação de segundo fator.

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

  2. Depois que o código for enviado, o usuário lerá a mensagem, inserirá o código de verificação no controle fornecido pelo controle de exibição e selecionará 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 de código

Elementos necessários de VerificationControl

O VerificationControl deve conter os seguintes elementos:

  • O tipo é DisplayControlVerificationControl.
  • DisplayClaims
    • Enviar para – uma ou mais declarações que especificam para onde enviar o código de verificação. Por exemplo, código de país ou email 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 envio do código. Essa declaração deve ser definida como necessária e deve ControlClaimType ser definida como VerificationCode.
  • Declaração de saída (opcional) a ser retornada para a página autodeclarada após o usuário concluir o processo de verificação. Por exemplo, código de país ou email 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 Actioncom os seguintes nomes:
    • SendCode – Envia um código para o usuário. Essa 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. Essa ação geralmente contém um único perfil técnico de validação.

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

Em seguida, o usuário insere o verificationCode e seleciona VerifyCode para disparar a ação VerifyCode no back-end. Se todas as validações forem aprovadas, 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>