Controle de exibição de verificação

  • Artigo

Use um controle de exibição de verificação para conferir uma declaração, por exemplo, um endereço de email ou 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. Solicitação de 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 manda para o usuário. O valor do endereço pode ser preenchido previamente e servir como uma autenticação de dois fatores.

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

  2. Depois do envio do código, 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 confirmar 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 da verificação da ação de código

Elementos necessários do VerificationControl

O VerificationControl deve conter os seguintes elementos:

  • O tipo de DisplayControl é VerificationControl.
  • DisplayClaims
    • Enviar para – uma ou mais declarações especificando para onde enviar o código de verificação. Por exemplo, email 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 depois que o código é enviado. Essa declaração deve ser definida conforme necessário e ControlClaimType deve ser definido como VerificationCode.
  • A declaração de saída (opcional) deve ser retornada à página autodeclarada após o usuário concluir o processo de verificação. Por exemplo, email ou código do país e número de telefone. O perfil técnico autodeclarado usa as declarações para manter os dados ou emitir as declarações de saída para a próxima etapa de orquestração.
  • Duas Action com 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, um para gerar um código e outro para enviá-lo.
    • VerifyCode – verifica o código. Essa ação geralmente contém um único perfil técnico de validação.

No seguinte exemplo, 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 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>