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

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

• 「Active Directory B2C でのカスタム ポリシーの概要」の手順を完了してください。 このチュートリアルでは、Azure AD B2C テナント構成を使用するようにカスタム ポリシー ファイルを更新する方法について説明します。
• Web アプリケーションを登録します。

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

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

ユーザー フローを使用して新しいユーザーを作成したら、ユーザー フロー の [ユーザー フローの実行 ] 機能を使用して、カスタマー エクスペリエンスを確認できます。 サインアップの過程で収集された属性のリストに ShoeSize が表示され、アプリケーションに返送されるトークンにも 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] をコピーします。 例: 00001111-aaaa-2222-bbbb-3333cccc4444。

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

1. Azure portal にサインインします。
2. 複数のテナントにアクセスできる場合、上部のメニューの [設定] アイコンを選択し、[ディレクトリとサブスクリプション] メニューからお使いの Azure AD B2C テナントに切り替えます。
3. 左側のメニューで、 Azure AD B2C を選択します。 または、[ すべてのサービス ] を選択し、 Azure AD B2C を検索して選択します。
4. アプリの登録 を選択し、すべてのアプリケーション を選択します。
5. b2c-extensions-app を選択します。変更しないでください。AADB2C がユーザーデータを格納するために使用されます。アプリケーション。
6. 次の識別子をクリップボードにコピーして保存します。
   • アプリケーション ID。 例: 00001111-aaaa-2222-bbbb-3333cccc4444。
   • オブジェクト ID。 例: aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb。

カスタムポリシーを変更する

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

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

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

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

4. 前に記録した Application ObjectID を、開始 <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: 00001111-aaaa-2222-bbbb-3333cccc4444-->  
             <Item Key="ClientId"></Item>
             <!--Insert b2c-extensions-app application ObjectId here, for example: aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb-->
             <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 テナントの外部 ID ユーザー フロー属性管理者以上として Azure portal にサインインします。
2. Azure AD B2C テナントを含むディレクトリを使用していることを確認します。
   1. ポータル ツールバーの [Directories + subscriptions](ディレクトリ + サブスクリプション) アイコンを選択します。
   2. ポータル設定 |[ディレクトリ + サブスクリプション] ページで、 [ディレクトリ名] の一覧で Azure AD B2C ディレクトリを見つけて、 [切り替え] を選択します
3. Azure portal の左上隅にある [ すべてのサービス ] を選択し、 Azure AD B2C を検索して選択します。
4. [ユーザー属性] を選択し、削除する属性を選択します。
5. [削除] を選択してから、 [はい] を選択して確定します。

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