B2B コラボレーションのサインアップ時にカスタム ユーザー属性を収集する

適用対象: ワークフォース テナント (詳細)

アプリケーションごとに、サインアップ中に収集する情報の要件が異なる場合があります。 Microsoft Entra 外部 IDには、名前、姓、市区町村、郵便番号などの属性に格納された情報の組み込みセットが付属しています。 Microsoft Entra 外部 IDを使用すると、外部ユーザーがユーザー フローを介してサインアップするときに、ゲスト アカウントに格納される属性のセットを拡張できます。

Microsoft Entra 管理センターでカスタム属性を作成し、self-service サインアップ ユーザー フローで使用できます。 これらの属性は、Microsoft Graph API を使用して読み書きすることもできます。 Microsoft Graph API では、拡張機能属性を使用したユーザーの作成と更新がサポートされています。 Graph API内の拡張属性には、規則 extension_<extensions-app-id>_attributename を使用して名前が付けられます。 次に例を示します。

"extension_831374b3bd5041bfaa54263ec9e050fc_loyaltyNumber": "212342"

<extensions-app-id> は、ご自身のテナントに固有です。 この識別子を見つけるには、Entra ID>アプリの登録>All applications に移動します。 "aad-extensions-app" で開始されるアプリを検索して、それを選択します。 アプリの [概要] ページの [アプリケーション (クライアント) ID] を書き留めます。

カスタム属性を作成する

1. 少なくとも Microsoft Entra 管理センターUser Administrator としてサインインします。

2. Entra ID>External id>Overview に移動します。

3. [カスタムのユーザー属性] を選択します。 使用可能なユーザー属性が一覧表示されます。

   

4. 属性を追加するには、 [追加] を選択します。

5. [属性の追加] ペインで、次の値を入力します。

   • [名前] - カスタム属性の名前を指定します ("Shoe size" など)。
   • [データ型] - データ型を選択します ( [String] 、 [Boolean] 、または [Int] )。
   • [説明] - 必要に応じて、内部使用のためにカスタム属性の説明を入力します。 この説明は、ユーザーには表示されません。

   

6. ［作成］ を選択します

カスタム属性をユーザー属性の一覧に追加すると、ユーザー フロー内でそれを使用することができるようになります。 ただしその属性は、任意のユーザー フロー内で初めて使用される際にのみ作成されます。 新しく追加されたカスタム属性を含むユーザー フローを使用して新しいユーザーを作成したら、Microsoft Graph Explorer でオブジェクトを照会できます。 これで、ユーザー オブジェクト上でサインアップ中に収集される属性の一覧に、ShoeSize が表示されるようになります。 アプリケーションからGraph APIを呼び出して、ユーザー オブジェクトに追加された後、この属性からデータを取得できます。

次のステップ

• セルフサービス サインアップのユーザー フローをアプリに追加する
• ユーザー フローの言語をカスタマイズする