다음을 통해 공유


확인 표시 컨트롤

중요합니다

2025년 5월 1일부터 새 고객을 위해 Azure AD B2C를 더 이상 구매할 수 없습니다. FAQ에서 자세히 알아보세요.

확인 표시 컨트롤 을 사용하여 사용자에게 전송된 확인 코드를 사용하여 클레임(예: 이메일 주소 또는 전화 번호)을 확인합니다.

VerificationControl 작업

확인 표시 컨트롤은 두 단계(작업)로 구성됩니다.

  1. 확인 코드를 보내야 하는 전자 메일 주소 또는 전화 번호와 같은 사용자의 대상을 요청합니다. 사용자가 코드 보내기 단추를 선택하면 확인 표시 컨트롤의 SendCode 동작 이 실행됩니다. SendCode 작업은 코드를 생성하고, 보낼 콘텐츠를 생성하고, 사용자에게 보냅니다. 주소의 값은 미리 채워지고 2단계 인증으로 사용될 수 있습니다.

    코드 보내기 작업에 대한 예제 페이지

  2. 코드를 보낸 후 사용자는 메시지를 읽고, 표시 컨트롤에서 제공하는 컨트롤에 확인 코드를 입력하고, 코드 확인을 선택합니다. 코드 확인을 선택하면 VerifyCode 작업이 실행되어 주소와 연결된 코드를 확인합니다. 사용자가 새 코드 보내기를 선택하면 첫 번째 작업이 다시 실행됩니다.

    코드 확인 작업에 대한 예제 페이지

VerificationControl 필수 요소

VerificationControl에는 다음 요소가 포함되어야 합니다.

  • DisplayControl 형식입니다 VerificationControl.
  • DisplayClaims
    • 보내기 - 확인 코드를 보낼 위치를 지정하는 하나 이상의 클레임입니다. 예를 들어 전자 메일 또는 국가 코드전화 번호입니다.
    • 확인 코드 - 코드가 전송된 후 사용자가 제공하는 확인 코드 클레임입니다. 이 클레임은 필요에 따라 설정해야 하며 이 클레임은 ControlClaimType .로 VerificationCode설정해야 합니다.
  • 사용자가 확인 프로세스를 완료한 후 자체 어설션된 페이지로 반환되는 출력 클레임(선택 사항)입니다. 예를 들어 전자 메일 또는 국가 코드전화 번호입니다. 자체 어설션된 기술 프로필은 클레임을 사용하여 데이터를 유지하거나 출력 클레임을 다음 오케스트레이션 단계로 버블업합니다.
  • 다음 이름을 가진 두 개의 Actions:
    • SendCode - 사용자에게 코드를 보냅니다. 이 작업에는 일반적으로 코드를 생성하고 보내기 위한 두 가지 유효성 검사 기술 프로필이 포함됩니다.
    • VerifyCode - 코드를 확인합니다. 이 작업에는 일반적으로 단일 유효성 검사 기술 프로필이 포함됩니다.

아래 예제에서는 페이지에 전자 메일 텍스트 상자가 표시됩니다. 사용자가 전자 메일 주소를 입력하고 SendCode를 선택하면 Azure AD B2C 백 엔드에서 SendCode 작업이 트리거됩니다.

그런 다음 사용자가 verificationCode 를 입력하고 VerifyCode 를 선택하여 백 엔드에서 VerifyCode 작업을 트리거합니다. 모든 유효성 검사가 통과하면 VerificationControl 이 완료된 것으로 간주되며 사용자는 다음 단계를 계속할 수 있습니다.

<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>