ユーザー プロファイルの属性

Azure Active Directory B2C (Azure AD B2C) ディレクトリ ユーザー プロファイルには、名前、姓、市区町村、郵便番号、電話番号などの一連の組み込み属性が付属しています。 外部データ ストアを必要とせずに、独自のアプリケーション データを使用してユーザー プロファイルを拡張できます。

Microsoft Graph API では、Azure で使用できるほとんどの属性がサポートされています。この記事では、Azure AD B2C でサポートされるユーザー プロファイル属性について説明します。 また、Microsoft Graph でサポートされていない属性と、Azure AD B2C で使用すべきではない Microsoft Graph API 属性についても説明します。

外部システムと統合することもできます。 たとえば、認証には Azure AD B2C を使用できますが、顧客データの権限のあるソースとして外部の顧客関係管理 (CRM) または顧客ロイヤルティ データベースに委任できます。 詳細については、 リモート プロファイル ソリューションを参照してください。

Microsoft Entra ユーザー リソースの種類

Azure AD B2C ディレクトリ ユーザー プロファイルでは、次の表に示す ユーザー リソースの種類 の属性がサポートされています。 各属性に関する次の情報が提供されます。

• Azure AD B2C で使用される属性名 (異なる場合は後に Microsoft Graph の名で括弧内に記載)
• 属性のデータ型
• 属性の説明
• 属性が Azure portal で使用できるかどうか
• 属性をユーザー フローで使用できるかどうか
• 属性をカスタム ポリシー Microsoft Entra ID 技術プロファイル で使用できるかどうか、およびセクション (<InputClaims>、 <OutputClaims>、または <PersistedClaims>)

¹ Microsoft Graph ではサポートされていません
² 詳細については、「MFA 電話番号属性」を参照してください。
³ Azure AD B2C では使用しないでください

必須の属性

Azure AD B2C ディレクトリにユーザー アカウントを作成するには、次の必須属性を指定します。

• 表示名

• ID - 少なくとも 1 つのエンティティ (ローカルまたはフェデレーション アカウント) を使用します。

• パスワード プロファイル - ローカル アカウントを作成する場合は、パスワード プロファイルを指定します。

表示名属性

displayNameは、ユーザーの Azure portal ユーザー管理と、Azure AD B2C がアプリケーションに返すアクセス トークンに表示する名前です。 このプロパティが必要です。

ID 属性

コンシューマー、パートナー、または市民である可能性のある顧客アカウントは、次の ID の種類に関連付けることができます。

• ローカル ID - ユーザー名とパスワードは、Azure AD B2C ディレクトリにローカルに格納されます。 多くの場合、これらの ID は "ローカル アカウント" と見なされます。
• フェデレーション ID - ソーシャル アカウントまたは エンタープライズ アカウントとも呼ばれ、ユーザーの ID は、Facebook、Microsoft、ADFS、Salesforce などのフェデレーション ID プロバイダーによって管理されます。

顧客アカウントを持つユーザーは、複数の ID でサインインできます。 たとえば、ユーザー名、電子メール、従業員 ID、政府 ID などです。 1 つのアカウントには、同じパスワードを使用して、ローカルとソーシャルの両方の複数の ID を持つことができます。

Microsoft Graph API では、ローカル ID とフェデレーション ID の両方が、identities 型のユーザー 属性に格納されます。 identities コレクションは、ユーザー アカウントへのサインインに使用される ID のセットを表します。 このコレクションを使用すると、ユーザーは関連付けられている任意の ID を使用してユーザー アカウントにサインインできます。 ID 属性には、最大 10 個の objectIdentity オブジェクトを含めることができます。 各オブジェクトには次のプロパティが含まれます。

次の JSON スニペットは、 サインイン 名を持つローカル アカウント ID、サインインとしての電子メール アドレス、およびソーシャル ID を持つ ID 属性を示しています。

"identities": [
  {
    "signInType": "userName",
    "issuer": "contoso.onmicrosoft.com",
    "issuerAssignedId": "johnsmith"
  },
  {
    "signInType": "emailAddress",
    "issuer": "contoso.onmicrosoft.com",
    "issuerAssignedId": "jsmith@yahoo.com"
  },
  {
    "signInType": "federated",
    "issuer": "facebook.com",
    "issuerAssignedId": "5eecb0cd"
  }
]

フェデレーション ID の場合、id プロバイダーに応じて、 issuerAssignedId は、アプリケーションまたは開発アカウントごとの特定のユーザーの一意の値です。 ソーシャル プロバイダーまたは同じ開発アカウント内の別のアプリケーションが割り当てるのと同じアプリケーション ID で Azure AD B2C ポリシーを構成します。

パスワード プロファイル プロパティ

ローカル ID の場合、 passwordProfile 属性が必要であり、ユーザーのパスワードが含まれています。 forceChangePasswordNextSignIn属性は、ユーザーが次回のサインイン時にパスワードをリセットする必要があるかどうかを示します。 強制パスワード リセットを処理するには、 強制パスワード リセット フローの設定に関する手順を使用します。

フェデレーション (ソーシャル) ID の場合、 passwordProfile 属性は必要ありません。

"passwordProfile" : {
    "password": "password-value",
    "forceChangePasswordNextSignIn": false
  }

パスワード ポリシー属性

Azure AD B2C パスワード ポリシー (ローカル アカウントの場合) は、Microsoft Entra ID の強力なパスワード強度 ポリシーに基づいています。 Azure AD B2C のサインアップまたはサインインとパスワードリセットのポリシーには、この強力なパスワード強度が必要であり、パスワードの有効期限は切れない。

ユーザー移行シナリオでは、移行するアカウントのパスワード強度が、Azure AD B2C によって適用される 強力なパスワード強度 よりも弱い場合は、強力なパスワード要件を無効にすることができます。 既定のパスワード ポリシーを変更するには、 passwordPolicies 属性を DisableStrongPassword に設定します。 たとえば、作成されたユーザー要求を次のように変更できます。

"passwordPolicies": "DisablePasswordExpiration, DisableStrongPassword"

MFA 電話番号属性

多要素認証 (MFA) に電話を使用する場合、携帯電話はユーザー ID の確認に使用されます。 新しい電話番号をプログラムで 追加 、 更新、 取得、または 削除 するには、MS Graph API の電話認証方法を使用します。

Azure AD B2C のカスタム ポリシーでは、電話番号はstrongAuthenticationPhoneNumber クレームの種類を通じて利用可能です。

拡張属性

顧客向けアプリケーションには、収集する情報に固有の要件があります。 Azure AD B2C テナントには、指定された名前、姓、郵便番号などのプロパティに格納されている情報の組み込みセットが付属しています。 Azure AD B2C では、各顧客アカウントに格納されている一連のプロパティを拡張できます。 詳細については、「Azure Active Directory B2C でのユーザー属性の追加とユーザー入力のカスタマイズ」を参照してください。

拡張属性は、ディレクトリ内のユーザー オブジェクトの スキーマを拡張 します。 拡張属性は、ユーザーのデータが含まれている場合でも、アプリケーション オブジェクトにのみ登録できます。 拡張属性は、 b2c-extensions-appというアプリケーションにアタッチされます。 このアプリケーションは、ユーザー データを格納するために Azure AD B2C によって使用されるため、変更しないでください。 このアプリケーションは、Microsoft Entra アプリの登録で確認できます。 。

Microsoft Graph API の拡張属性には、次のような規則 extension_ApplicationClientID_AttributeNameを使用して名前が付けられます。

• ApplicationClientIDは、 です。 拡張機能アプリを見つける方法について説明します。
• AttributeNameは拡張属性の名前です。

拡張属性の名前の作成に使用される アプリケーション (クライアント) ID には、ハイフンは含まれません。 例えば次が挙げられます。

"extension_831374b3bd5041bfaa54263ec9e050fc_loyaltyNumber": "212342"

スキーマ拡張機能で属性を定義する場合は、次のデータ型がサポートされます。

関連コンテンツ

拡張属性の詳細については、以下を参照してください。

• スキーマ拡張機能
• カスタム属性を定義する