次の方法で共有


検証表示コントロール

重要

2025 年 5 月 1 日より、Azure AD B2C は新規のお客様向けに購入できなくなります。 詳細については、FAQ を参照してください

確認 表示コントロール を使用して、ユーザーに送信された確認コードを使用して、電子メール アドレスや電話番号などの要求を確認します。

VerificationControl アクション

検証表示コントロールは、次の 2 つの手順 (アクション) で構成されます。

  1. 確認コードの送信先となる電子メール アドレスや電話番号など、ユーザーに送信先を要求します。 ユーザーが [ コードの送信 ] ボタンを選択すると、検証表示コントロールの SendCode アクション が実行されます。 SendCode アクションは、コードを生成し、送信するコンテンツを構築して、ユーザーに送信します。 アドレスの値は事前に設定でき、第 2 要素認証として機能します。

    コードの送信アクションのページ例

  2. コードが送信されると、ユーザーはメッセージを読み取り、表示コントロールによって提供されるコントロールに確認コードを入力し、[ コードの確認] を選択します。 [コードの 確認] を選択すると、 VerifyCode アクション が実行され、アドレスに関連付けられているコードが確認されます。 ユーザーが [ 新しいコードの送信] を選択した場合、最初のアクションが再度実行されます。

    コードの検証アクションのページ例

VerificationControl 必須要素

VerificationControl には、次の要素が含まれている必要があります。

  • DisplayControlの型はVerificationControl
  • DisplayClaims
    • [送信先] - 検証コードの送信先を指定する 1 つ以上の要求。 たとえば、 メール国番号電話番号などです。
    • 確認コード - コードの送信後にユーザーが提供する検証コード要求。 この要求は必要に応じて設定し、 ControlClaimTypeVerificationCode に設定する必要があります。
  • ユーザーが検証プロセスを完了した後にセルフアサート ページに返される出力要求 (省略可能)。 たとえば、 メール国番号電話番号などです。 セルフアサート技術プロファイルでは、要求を使用してデータを保持するか、出力要求を次のオーケストレーション 手順にバブルアップします。
  • 次の名前を持つ 2 つの Action:
    • SendCode - ユーザーにコードを送信します。 通常、このアクションには、コードを生成して送信するための 2 つの検証技術プロファイルが含まれます。
    • VerifyCode - コードを検証します。 このアクションには、通常、1 つの検証技術プロファイルが含まれます。

次の例では、 ページに電子メール テキスト ボックスが表示されます。 ユーザーがメール アドレスを入力して 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>