Azure Active Directory B2C カスタムポリシーで電話ファクター技術プロファイルを定義する

[アーティクル]
02/24/2024

注意

Azure Active Directory B2C で、カスタムポリシーは、主に、複雑なシナリオに取り組む用途向けに設計されています。ほとんどのシナリオで、組み込みユーザーフローを使用することをお勧めします。まだ行っていない場合は、Active Directory B2C でのカスタムポリシーの概要に関する記事で、カスタムポリシースターターパックの詳細を確認してください。

Azure Active Directory B2C (Azure AD B2C) では、電話番号の登録および検証のサポートを提供しています。この技術プロファイル:

ユーザーとやり取りして、電話番号を検証または登録するためのユーザーインターフェイスを用意します。
電話番号を検証するために、電話とテキストメッセージがサポートされています。
複数の電話番号をサポートしています。ユーザーは、いずれかの電話番号を選択して確認できます。
ユーザーが新しい電話番号を指定したかどうかを示す要求を返します。この要求を使用して、電話番号を Azure AD B2C ユーザープロファイルに保存するかどうかを決定できます。
コンテンツ定義を使用して外観を制御します。

Protocol

Protocol 要素の Name 属性は Proprietary に設定する必要があります。電話ファクターのためにハンドラー属性は、Azure AD B2C で使用されるプロトコルハンドラーのアセンブリの完全修飾名を含める必要があります。Web.TPEngine.Providers.PhoneFactorProtocolProvider, Web.TPEngine, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null

次の例は、登録と検証のための電話ファクター技術プロファイルを示しています。

<TechnicalProfile Id="PhoneFactor-InputOrVerify">
  <DisplayName>PhoneFactor</DisplayName>
  <Protocol Name="Proprietary" Handler="Web.TPEngine.Providers.PhoneFactorProtocolProvider, Web.TPEngine, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" />
</TechnicalProfile>

入力要求変換

InputClaimsTransformations 要素には、入力要求を変更したり新しいものを生成したりために使用される、入力要求変換のコレクションを含めることができます。次の入力要求変換によって、後で入力要求コレクションで使用される UserId 要求が生成されます。

<InputClaimsTransformations>
  <InputClaimsTransformation ReferenceId="CreateUserIdForMFA" />
</InputClaimsTransformations>

入力クレーム

InputClaims 要素には、次の要求が含まれている必要があります。要求の名前を、電話ファクター技術プロファイルで定義されている名前にマップすることもできます。

データ型	Required	Description
string	はい	ユーザーの一意の ID。要求名または PartnerClaimType は `UserId` に設定されている必要があります。この要求には個人を特定できる情報を含めないでください。
string	はい	要求の種類の一覧。各要求には、1 つの電話番号が含まれます。どの入力要求にも電話番号が含まれていない場合、ユーザーは新しい電話番号を登録して検証するように求められます。検証済みの電話番号が、出力要求として返されます。入力要求のいずれかに電話番号が含まれている場合は、ユーザーにその検証を求めるメッセージが表示されます。複数の入力要求に電話番号が含まれている場合、ユーザーは電話番号の 1 つを選択して検証するように求められます。

次の例は、複数の電話番号を使用した場合を示しています。詳細については、サンプルポリシーを参照してください。

<InputClaims>
  <InputClaim ClaimTypeReferenceId="userIdForMFA" PartnerClaimType="UserId" />
  <InputClaim ClaimTypeReferenceId="strongAuthenticationPhoneNumber" />
  <InputClaim ClaimTypeReferenceId="secondaryStrongAuthenticationPhoneNumber" />
</InputClaims>

出力クレーム

OutputClaims 要素には、電話ファクター技術プロファイルによって返された要求の一覧が含まれています。

データ型	Required	Description
boolean	はい	ユーザーによって新しい電話番号が入力されたかどうかを示します。要求名または PartnerClaimType は `newPhoneNumberEntered` に設定されている必要があります
string	はい	検証済みの電話番号。要求名または PartnerClaimType は `Verified.OfficePhone` に設定されている必要があります。

OutputClaimsTransformations 要素には、出力要求を修正したり、新しい要求を生成したりするために使用される、OutputClaimsTransformation 要素のコレクションが含まれている場合があります。

暗号化キー

CryptographicKeys 要素は使用されません。

Metadata

属性	必須	説明
ContentDefinitionReferenceId	はい	コンテンツ定義の識別子は、この技術プロファイルに関連付けられています。
ManualPhoneNumberEntryAllowed	いいえ	ユーザーが手動で電話番号を入力できるようにするかどうかを指定します。指定できる値: `true` または `false` (既定値)。
setting.authenticationMode	いいえ	電話番号を検証するメソッド。指定できる値: `sms`、`phone`、または `mixed` (既定値)。
setting.autodial	いいえ	技術プロファイルで自動ダイヤルするか、SMS を自動送信するかを指定します。指定できる値: `true` または `false` (既定値)。自動ダイヤルには、`setting.authenticationMode` メタデータを `sms` または `phone` に設定する必要があります。入力要求のコレクションには、1 つの電話番号が必要です。
setting.autosubmit	いいえ	技術プロファイルがワンタイムパスワード入力フォームを自動送信するかどうかを指定します。指定可能な値は `true` (既定値) または `false` です。自動送信がオフになっている場合、ユーザーは体験を進めるためにボタンを選択する必要があります。
setting.enableCaptchaChallenge	いいえ	CAPTCHA チャレンジコードを MFA フローに表示するかどうかを指定します。指定できる値: `true` または `false` (既定値)。この設定を機能させるには、 CAPTCHA 表示コントロールを電話要素技術プロファイルの表示要求で参照する必要があります。 CAPTCHA 機能はパブリックプレビュー段階です。

UI 要素

電話ファクター認証ページのユーザーインターフェイス要素は、ローカライズできます。

次のステップ

MFA スターターパックを使用してソーシャルアカウントとローカルアカウントを確認します。

Azure Active Directory B2C カスタム ポリシーで電話ファクター技術プロファイルを定義する