Azure Active Directory B2C でカスタム属性を定義する

• ユーザー フローを作成して、ユーザーがアプリケーションにサインアップおよびサインインできるようにします。
• Web アプリケーションを登録します。

• 「Active Directory B2C でのカスタム ポリシーの概要」にある手順を完了します。
• Web アプリケーションを登録します。

ユーザー フローでカスタム属性を使用する

1. Azure AD B2C テナントで、 [ユーザー フロー] を選択します。
2. ポリシー ("B2C_1_SignupSignin" など) を選択して開きます。
3. [ユーザー属性] 、カスタム属性 ("ShoeSize" など) の順に選択します。 [保存] を選択します。
4. [アプリケーションの要求] 、カスタム属性の順に選択します。
5. [保存] を選択します。

ユーザー フローを使用して新しいユーザーを作成したら、ユーザー フローでユーザー フローの実行機能を使用してカスタマー エクスペリエンスを確認できます。 これで、ShoeSize がサインアップ中に収集される属性の一覧や、アプリケーションに送り返されるトークンに表示されるようになります。

拡張機能アプリのアプリケーション ID を取得する

1. Azure portal にサインインします。
2. 複数のテナントにアクセスできる場合、上部のメニューの [設定] アイコンを選択し、[ディレクトリとサブスクリプション] メニューからお使いの Azure AD B2C テナントに切り替えます。
3. 左側のメニューで、 [Azure AD B2C] を選択します。 または、 [すべてのサービス] を選択し、 [Azure AD B2C] を検索して選択します。
4. [アプリの登録] を選択してから、 [すべてのアプリケーション] を選択します。
5. b2c-extensions-app. Do not modify. Used by AADB2C for storing user data. アプリケーションを選択します。
6. [アプリケーション ID] をコピーします。 例: 11111111-1111-1111-1111-111111111111.

拡張機能アプリのアプリケーション プロパティを取得する

1. Azure portal にサインインします。
2. 複数のテナントにアクセスできる場合、上部のメニューの [設定] アイコンを選択し、[ディレクトリとサブスクリプション] メニューからお使いの Azure AD B2C テナントに切り替えます。
3. 左側のメニューで、 [Azure AD B2C] を選択します。 または、 [すべてのサービス] を選択し、 [Azure AD B2C] を検索して選択します。
4. [アプリの登録] を選択してから、 [すべてのアプリケーション] を選択します。
5. 「b2c-extensions-app. Do not modify. Used by AADB2C for storing user data.」アプリケーションを選択します。
6. 次の識別子をクリップボードにコピーして保存します。
   • アプリケーション ID。 例: 11111111-1111-1111-1111-111111111111.
   • オブジェクト ID。 例: 22222222-2222-2222-2222-222222222222.

カスタム ポリシーの変更

ポリシーでカスタム属性を有効にするには、AAD-Common 技術プロファイルのメタデータで、アプリケーション ID とアプリケーション オブジェクト ID を指定します。 AAD-Common* 技術プロファイルは、その基盤である Microsoft Entra ID 技術プロファイルに含まれており、Microsoft Entra ユーザー管理のためのサポートを提供するものです。 他の Microsoft Entra ID 技術プロファイルには、AAD-Common が含まれており、その構成が使われています。 拡張ファイルで、AAD-Common 技術プロファイルをオーバーライドしてください。

1. お使いのポリシーの拡張ファイルを開きます。 たとえば、「 SocialAndLocalAccounts/TrustFrameworkExtensions.xml 」のように入力します。

2. ClaimsProviders 要素を見つけます。 ClaimsProviders 要素に新しい ClaimsProvider を追加します。

3. 記録しておいたアプリケーション ID を、開始 <Item Key="ClientId"> と終了 </Item> の要素間に挿入します。

4. 記録しておいたアプリケーション オブジェクト ID を、開始 <Item Key="ApplicationObjectId"> と終了 </Item> の要素間に挿入します。

   <!-- 
   <ClaimsProviders> -->
     <ClaimsProvider>
       <DisplayName>Azure Active Directory</DisplayName>
       <TechnicalProfiles>
         <TechnicalProfile Id="AAD-Common">
           <Metadata>
             <!--Insert b2c-extensions-app application ID here, for example: 11111111-1111-1111-1111-111111111111-->  
             <Item Key="ClientId"></Item>
             <!--Insert b2c-extensions-app application ObjectId here, for example: 22222222-2222-2222-2222-222222222222-->
             <Item Key="ApplicationObjectId"></Item>
           </Metadata>
         </TechnicalProfile>
       </TechnicalProfiles> 
     </ClaimsProvider>
   <!-- 
   </ClaimsProviders> -->
   

カスタム ポリシーのアップロード

1. Azure portal にサインインします。
2. 複数のテナントにアクセスできる場合、上部のメニューの [設定] アイコンを選択し、[ディレクトリとサブスクリプション] メニューからお使いの Azure AD B2C テナントに切り替えます。
3. Azure portal の左上隅にある [すべてのサービス] を選択し、 [アプリの登録] を検索して選択します。
4. [Identity Experience Framework] を選択します。
5. [カスタム ポリシーのアップロード] を選択し、変更した TrustFrameworkExtensions.xml ポリシー ファイルをアップロードします。

Azure portal を使用してカスタム属性を作成する

組み込みポリシーとカスタム ポリシー間では、同じ拡張属性が共有されます。 ポータルのエクスペリエンスを使用してカスタム属性を追加すると、これらの属性が、すべての B2C テナントに存在する b2c-extensions-app を使用して登録されます。

これらの属性は、カスタム ポリシーで使用する前後に、ポータルの UI を使用してを作成できます。 ポータルで属性 loyaltyId を作成するときに、次のようにこの属性を参照する必要があります。

次の例は、Azure AD B2C カスタム ポリシーの要求定義でカスタム属性を使用する方法を示したものです。

<BuildingBlocks>
  <ClaimsSchema>
    <ClaimType Id="extension_loyaltyId">
      <DisplayName>Loyalty Identification</DisplayName>
      <DataType>string</DataType>
      <UserHelpText>Your loyalty number from your membership card</UserHelpText>
      <UserInputType>TextBox</UserInputType>
    </ClaimType>
  </ClaimsSchema>
</BuildingBlocks>

次の例は、技術プロファイル、入力、出力、および永続化された要求の Azure AD B2C カスタム ポリシーで、カスタム属性を使用する方法を示したものです。

<InputClaims>
  <InputClaim ClaimTypeReferenceId="extension_loyaltyId"  />
</InputClaims>
<PersistedClaims>
  <PersistedClaim ClaimTypeReferenceId="extension_loyaltyId" />
</PersistedClaims>
<OutputClaims>
  <OutputClaim ClaimTypeReferenceId="extension_loyaltyId" />
</OutputClaims>

テナントでユーザー フローからカスタム属性を削除するには、次の手順に従います。

1. Azure AD B2C テナントの全体管理者として Azure Portal にサインインします。
2. ご利用の Azure AD B2C テナントが含まれるディレクトリを必ず使用してください。
   1. ポータル ツールバーの [Directories + subscriptions](ディレクトリ + サブスクリプション) アイコンを選択します。
   2. [ポータルの設定] | [Directories + subscriptions](ディレクトリ + サブスクリプション) ページの [ディレクトリ名] の一覧で自分の Azure AD B2C ディレクトリを見つけて、 [切り替え] を選択します。
3. Azure Portal の左上隅の [すべてのサービス] を選択し、 [Azure AD B2C] を検索して選択します。
4. [ユーザー属性] を選択してから、削除する属性を選択します。
5. [削除] を選択してから、 [はい] を選択して確定します。

Microsoft Graph API を使用してカスタム属性を管理します。