定義使用者流程的自定義屬性

提示

本文適用於 B2B 共同作業使用者流程。 如果您的租用戶已針對客戶身分識別和存取管理進行設定，請參閱 在註冊 客戶期間收集用戶屬性。

針對每個應用程式，您可能對註冊期間想要收集的資訊有不同的需求。 Microsoft Entra 外部 ID 隨附一組內建的信息，儲存在屬性中，例如指定名稱、姓氏、城市和郵遞區區編碼。 透過 Microsoft Entra 外部 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. 在 [新增屬性] 窗格中，輸入下列值：

   • 名稱 - 提供自定義屬性的名稱（例如「鞋大小」）。
   • 數據類型 - 選擇數據類型（String、 Boolean 或 Int）。
   • 描述 - 選擇性地輸入自訂屬性的描述，以供內部使用。 使用者看不到此描述。

   

6. 選取 建立。

當您將自定義屬性新增至使用者屬性清單時，它就會變成可供使用者流程使用。 不過，屬性只會在第一次用於任何使用者流程時建立。 一旦您透過包含新新增自定義屬性的使用者流程建立新使用者，就可以在 Microsoft Graph 總管中查詢物件。 您現在應該會在使用者物件註冊旅程圖期間收集的屬性清單中看到 ShoeSize 。 您可以在將圖形 API 新增至使用者物件之後，從您的應用程式呼叫圖形 API，以從此屬性取得數據。

下一步

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