在 Microsoft Entra 外部 ID 中定義自助註冊流程的自定義屬性

適用於： 員工租用戶 外部租用戶 (深入了解)

提示

本文適用於員工租用戶中的 B2B 共同作業使用者流程。 如需外部租用戶的相關資訊，請參閱在註冊期間收集使用者屬性。

對於各個應用程式，您要在註冊期間收集的資訊可能會有不同的需求。 Microsoft Entra External ID 隨附一組儲存於屬性中的內建資訊集，例如指定名稱、姓氏、城市和郵遞區編碼。 使用 Microsoft Entra External ID，您可以擴充在外部使用者透過使用者流程註冊時儲存在來賓帳戶上的屬性集。

您可以在 Microsoft Entra 系統管理中心建立自訂屬性，並在您的自助式註冊使用者流程中加以使用。 您也可以使用 Microsoft Graph API 來讀取和寫入這些屬性。 Microsoft Graph API 支援以擴充屬性建立和更新使用者。 圖形 API 中的擴充屬性會使用 extension_<extensions-app-id>_attributename 慣例來命名。 例如：

"extension_831374b3bd5041bfaa54263ec9e050fc_loyaltyNumber": "212342"

<extensions-app-id> 專屬於您的租用戶。 若要尋找此識別碼，請導覽至 [身分識別]>[應用程式]>[應用程式註冊]>[所有應用程式]。 搜尋開頭為 "aad-extensions-app" 的應用程式，並加以選取。 在應用程式的 [概觀] 頁面上，記下 [應用程式 (用戶端) 識別碼]。

建立自訂屬性

提示

根據您開始使用的入口網站，本文中的步驟可能略有不同。

1. 以至少是使用者管理員的身分登入 Microsoft Entra 系統管理中心。

2. 瀏覽至 [身分識別]>[外部身分識別]>[概觀]。

3. 選取 [自訂使用者屬性]。 列出可用的使用者屬性。

   

4. 若要新增屬性，請選取 [新增]。

5. 在 [新增屬性] 窗格中，輸入下列值：

   • 名稱 - 提供自訂屬性的名稱 (例如 "Shoe size")。
   • 資料類型 - 選擇資料類型 (字串、布林值或 Int)。
   • 描述 - 選擇性地輸入自訂屬性的描述，以供內部使用。 使用者看不到此描述。

   

6. 選取 建立。

當您將自訂屬性新增至使用者屬性清單中，則其可在使用者流程中使用。 不過，該屬性僅於首次在任何使用者流程中使用時建立。 在您透過包含新增自訂屬性的使用者流程建立新的使用者後，即可在 Microsoft Graph 總管中查詢物件。 您現在應該會在使用者物件上的註冊旅程期間所收集的屬性清單中看到 ShoeSize。 您可以從應用程式呼叫圖形 API，以在將資料新增至使用者物件之後，從這個屬性取得資料。

下一步

• 將自助式註冊使用者流程新增至應用程式
• 自訂使用者流程語言