適用対象: 
従業員テナント緑 
外部テナント (詳細)
サインアップ時に収集するユーザー属性は、ユーザーのプロファイルと共にディレクトリに格納されます。 組み込みユーザー属性から選択することも、カスタム ユーザー属性を作成することもできます。
市区町村、国/地域、電子メール アドレスなどの組み込みのユーザー属性は、Microsoft Entra 外部 ID で使用できます。 サインアップ中に収集する組み込みユーザー属性を選択できます。
収集する追加情報については、 カスタム ユーザー属性を作成できます。 テキスト ボックス、ラジオ ボタン、チェック ボックスなど、いくつかのカスタム入力コントロールをサインアップ ページに追加して属性を収集できます。 次の例は、カスタム入力コントロールを使用して、ロイヤルティ番号の属性、使用条件の使用条件の同意、およびプライバシー ポリシーの同意を収集する方法を示しています。
組み込みユーザー属性
Microsoft Entra 外部 ID には、サインアップ中に収集可能な組み込みユーザー属性があります。 これらの属性は、 Microsoft Entra 管理センターでユーザー フローを作成するときに構成します。
次の表は、サインアップ フロー中に収集できる組み込みユーザー属性をまとめたものです。
- Microsoft Entra 管理センターのラベルは、Microsoft Entra 管理 センターに表示されるユーザー属性の名前です。
- プログラム可能な名前 は、Microsoft Graph API のユーザー リソースで使用される ユーザー 属性の名前です。 この名前は、 ネイティブ認証など、プログラムでこのユーザー属性を使用する場合に使用します。
- データ型 は、ユーザー属性のデータ型です。
| Microsoft Entra 管理センターのラベル | プログラミング可能な名前 | データの種類 | 解説 |
|---|---|---|---|
| 都市 | 都市 | 糸 | 最大 128 文字までです。 |
| 国/地域 | 国 | 糸 | 最大 128 文字までです。 |
| 表示名 | 表示名 | 糸 | 最大 256 文字までです。 |
| メール アドレス | メール | 糸 | このプロパティにアクセント文字を含めることはできません。 ネイティブ認証 API では、この属性はユーザー名として参照されます。 |
| 姓 | givenName | 糸 | 最大文字数は 64 文字です。 |
| 役職 | 役職 | 糸 | 最大 128 文字までです。 |
| 郵便番号 | 郵便番号 | 糸 | 最大文字数は 40 文字です。 |
| 都道府県 | 状態 | 糸 | 最大 128 文字までです。 |
| 住所 | 住所 | 糸 | 最大長は 1024 文字です。 |
| 姓 | 姓 | 糸 | 最大文字数は 64 文字です。 |
カスタムのユーザー属性
アプリで、組み込みのユーザー属性よりも多くの情報が必要な場合は、独自の属性を追加できます。 これらの属性を、"カスタム ユーザー属性" と呼びます。
カスタム ユーザー属性を定義するには、まずテナント レベルで属性を作成し、テナント内の任意のユーザー フローでその属性を使用できるようにします。 次に、その属性をサインアップ ユーザー フローに割り当てて、サインアップ ページに属性を表示する方法を構成します。
カスタム ユーザー属性を作成する方法については、 カスタム ユーザー属性の作成に関する記事を 参照してください。
カスタム ユーザー属性の入力の種類
カスタム ユーザー属性を使用する前に、収集するカスタム属性ごとにユーザー入力を収集する最適な方法を決定します。 サインアップ時にユーザーから情報を収集するには、次の入力の種類のコントロールを使用します。
- 文字列テキスト ボックス
- ラジオ ボタン
- 複数選択チェックボックス
- 数値テキスト ボックス
- 単一選択チェック ボックス
適切なデータ型とユーザー入力の種類については、次の表を参照してください。
| データの種類 | ユーザー入力の種類 | 説明 |
|---|---|---|
| 糸 | テキストボックス | 自由形式のテキスト入力フィールド。 |
| 糸 | ラジオシングルセレクト | 1 つだけ選択できる一連のラジオ ボタン。 個々のラジオ ボタンの テキスト には、Markdown 言語で書式設定されたハイパーリンクを含めることができます。 |
| 糸 | チェックボックス複数選択 | 複数選択が可能な一連の 1 つ以上のチェック ボックス。 個々のチェック ボックスの テキスト には、Markdown 言語で書式設定されたハイパーリンクを含めることができます。 |
| ボーリアン | 単一選択チェックボックス | ラベル付きの単一のブール値チェック ボックス。 チェック ボックスの ラベル には、Markdown 言語で書式設定されたハイパーリンクを含めることができます。 |
| int | 数値テキストボックス | 自由形式の整数入力。 |
チェックボックスとラジオ ボタンには、利用規約やプライバシー ポリシーなど、他のコンテンツへのハイパーリンクを含めることができます。 この記事の冒頭の例は、組み込みの属性とカスタム属性を組み合わせたサインアップ ページを示しています。 この例では次のとおりです。
- [表示名] フィールドは組み込みの属性です。
- ロイヤルティ番号は、数値整数を受け入れる自由形式の入力フィールドを持つカスタム属性です。 この形式は、 Int データ型と NumericTextBox ユーザー入力型を使用して構成できます。
- 使用条件とプライバシー ポリシーのカスタム属性は、ハイパーリンクを含むラベルを含む個別の単一選択のチェック ボックスです。 Boolean データ型を使用して 1 つのチェック ボックスを構成できます。既定では、CheckboxSingleSelect ユーザー入力の種類です。 Markdown 言語を使用して、チェックボックスのラベルにハイパーリンクを追加します。
ユーザー属性の入力の種類を構成する方法については、「 ユーザー入力の種類の構成」の記事を参照 してください。
カスタム ユーザー属性が格納されている場所
カスタム ユーザー属性は、ディレクトリに格納されているユーザー プロファイル情報を拡張するため、ディレクトリ拡張属性とも呼ばれます。 外部テナントのすべての拡張機能属性は、 b2c-extensions-app という名前のアプリに格納されます。 ユーザーがサインアップ時にカスタム属性の値を入力すると、その値はユーザー オブジェクトに追加され、名前付け規則 extension_{appId-without-hyphens}_{custom-attribute-name} を使用して Microsoft Graph API 経由で呼び出すことができます。ここでの条件は次のとおりです。
-
{appId-without-hyphens}は、 b2c-extensions-app のクライアント ID の削除されたバージョンです。 -
{custom-attribute-name}は、カスタム属性に割り当てた名前です。
たとえば、 b2c-extensions-app のクライアント ID が 2588a-bcdwh-tfeehj-jeeqw-ertc され、属性名が次の場合です。
-
loyaltyNumber、カスタム属性の名前は
extension_2588abcdwhtfeehjjeeqwertc_loyaltyNumber。 -
その後、ロイヤルティ番号 はカスタム属性の名前として
extension_2588abcdwhtfeehjjeeqwertc_loyaltyNumberされます。 スペースを削除し、キャメル ケースを使用して単語を区切ります。
外部テナントに登録されている b2c-extensions-app のアプリケーション ID を検索する方法については、拡張機能アプリのアプリケーション ID の検索に関する記事を参照してください。
Microsoft Graph API
ユーザー属性は、Microsoft Graph では ユーザー フロー属性 と呼ばれます。 identityUserFlowAttribute リソースの種類とそれに関連付けられているメソッドを使用して、組み込みユーザー フロー属性とカスタム ユーザー フロー属性の両方を管理します。