在註冊期間收集自定義用戶屬性

  • 發行項

如果您的應用程式需要比內建用戶屬性所提供的更多資訊，您可以新增自己的屬性。 我們將這些屬性 稱為自定義用戶屬性。

若要定義自定義使用者屬性，您會先在租用戶層級建立屬性，以便在租使用者中的任何使用者流程中使用。 然後將 屬性指派給註冊使用者流程，並設定您希望它出現在註冊頁面上的方式。

在使用者配置檔屬性一文中 深入瞭解自定義用戶屬性 。

建立自訂用戶屬性

  1. 登入 Microsoft Entra 系統管理中心。

  2. 如果您有多個租使用者的存取權，請使用頂端功能表中的 [設定] 圖示，從 [目錄 + 訂用帳戶] 功能表切換至外部租使用者。

  3. 流覽至 [身分>識別外部身分識別概觀]。>

  4. 選取 [自訂使用者屬性]。 此清單包含租使用者中可用的所有用戶屬性，包括已建立的任何自定義用戶屬性。 [ 屬性類型 ] 資料行會指出屬性是內建還是自定義。

  5. 選取 [新增]。 在 [新增屬性] 窗格中，輸入自定義屬性的名稱（例如「使用規定」）。

  6. 在 [數據類型] 中，根據您想要建立的數據類型和使用者輸入控件，選擇 [字串]、[布爾值] 或 [Int]。 字串屬性具有 TextBox 的預設使用者輸入類型值，但您可以在稍後的步驟中變更此值（例如，如果您想要設定單選按鈕或多重選取複選框）。

  7. （選擇性）在 [描述] 中，輸入自定義屬性的描述以供內部使用。 使用者看不到此描述。

    用於新增屬性之窗格的螢幕快照。

  8. 選取 建立。 自訂屬性現在可在使用者屬性清單中取得，並可 新增至您的使用者流程。

在註冊流程中包含自定義用戶屬性

請遵循下列步驟，將自定義使用者屬性新增至您已建立的使用者流程。 （如果您需要建立新的使用者流程，請參閱 為客戶建立註冊和登入使用者流程。

  1. 登入 Microsoft Entra 系統管理中心。

  2. 如果您有多個租使用者的存取權，請使用頂端功能表中的 [設定] 圖示，從 [目錄 + 訂用帳戶] 功能表切換至外部租使用者。

  3. 流覽至 [身分>識別外部身分>識別使用者流程]。

  4. 從清單中選取使用者流程。

  5. 選取 [使用者屬性 ] 。 此清單包含您定義的任何自定義用戶屬性，如上一節所述。 例如，新的 使用 規定屬性現在會出現在清單中。 選擇您想要在註冊期間從使用者收集的所有屬性。

    [建立使用者流程] 頁面上使用者屬性選項的螢幕快照。

  6. 選取 [儲存]。

設定使用者輸入類型和版面配置

在 [ 版面配置 ] 頁面上，您可以指出需要哪些屬性，並排列顯示順序。 您也可以編輯屬性標籤、建立單選按鈕或複選框，以及將超連結新增至更多內容（例如使用規定或隱私策略）。

  1. 登入 Microsoft Entra 系統管理中心。

  2. 流覽至 [身分>識別外部身分>識別使用者流程]。

  3. 從清單中，選取您的使用者流程。

  4. 在 [自訂] 下方，選取 [頁面配置]。 您選擇要收集的屬性隨即出現。

  5. 選取 [標籤] 資料列中的 值並修改文字，以編輯任何屬性的標籤 。

  6. 設定選取框或單選按鈕：

    • 單選複選框：布爾屬性類型會在註冊頁面上轉譯為單一選取複選框。 若要設定複選框旁顯示的文字，請選取並編輯 [卷標] 資料行中的值。 使用 Markdown 語言新增超連結。 如需詳細資訊，請參閱 設定單一選取複選框 （CheckboxSingleSelect）
    • 多重選取複選框：尋找您要設定的 String 數據類型屬性，然後選取 [使用者輸入類型] 資料行中的值，以開啟編輯器窗格。 選擇 CheckboxMultiSelect 使用者輸入類型並輸入值。 如需詳細資訊，請參閱 設定多重選取複選框 （CheckboxMultiSelect） 。
    • 單選按鈕：尋找您要設定的 String 資料類型屬性，然後選取 [使用者輸入類型] 資料行中的值，以開啟編輯器窗格。 選擇 RadioSingleSelect 使用者輸入類型，然後輸入值。 如需詳細資訊，請參閱 設定單選按鈕 （RadioSingleSelect）

  7. 選取屬性並選擇 [上移]、[下移]、[移至頂端] 或 [移至底部] 來變更顯示順序。

  8. 選取 [必要] 資料行中的 複選框，以建立必要的 屬性。 所有屬性都可以標示為必要。 針對多重選取複選框，「必要」表示用戶必須至少選取一個複選框。

  9. 當您的所有變更都完成時，請選取 [ 儲存]。

設定單一選取複選框 （CheckboxSingleSelect）

具有布爾數據類型的屬性具有 CheckboxSingleSelect 的使用者輸入類型。 您可以修改複選框旁顯示的文字，並包含超連結。

提示

立即試用

若要試用這項功能，請移至 Woodgrove Groceries 示範，然後啟動「新增使用規定和隱私策略的連結」使用案例。

若要設定單選複選框，請遵循下列步驟：

  1. 在 [版面配置] 頁面上，尋找具有您要設定之布爾值數據類型的屬性。

  2. 選取 [標籤] 資料列中的值，然後輸入您要顯示在複選框旁的文字。 使用 Markdown 語言新增超連結。 例如：

    • 若要設定使用規定屬性的標籤，您可以輸入：

      I have read and agree to the [terms of use](https://woodgrove.com/terms-of-use).

    • 或者，您可以將使用規定和隱私策略結合成單一必要複選框：

      I have read and agree to the [terms of use](https://woodgrove.com/terms-of-use) and the [privacy policy](https://woodgrove.com/privacy).

  3. 選取 [確定]。

    更新頁面版面配置選項中複選框標籤的螢幕快照。

  4. 在 [ 頁面配置 ] 頁面上，選取 [ 儲存]。

設定多重選取複選框 （CheckboxMultiSelect）

具有 String 數據類型的屬性可以設定為 CheckboxMultiSelect 使用者輸入類型，這是一系列出現在屬性卷標底下的一或多個複選框。 用戶可以選取一或多個複選框。 您可以定義個別複選框的文字，並包含其他內容的超連結。 將此屬性設定為 [必要] 表示用戶必須至少選取其中一個複選框。

  1. 在 [ 版面配置 ] 頁面上，尋找具有您要設定為一系列複選框之 String 數據類型的屬性。

  2. 選擇[捲標] 資料列中的值，然後輸入您想要顯示在一系列複選框上方的標題，例如 How did you hear about us?。

  3. 選取 [ 使用者輸入類型 ] 資料行中的值，以開啟編輯器窗格。

  4. 在編輯器窗格中，於 [使用者輸入類型] 底下，選取 [複選框][選取]。

  5. 針對您要新增的每個複選框，請從新行開始，並輸入下列資訊：

    • 在 [ 文字] 底下，輸入您要顯示在複選框旁的文字。 使用 Markdown 語言新增超連結。

    • 在 [值] 底下，輸入要寫入用戶物件上的值，並在使用者選取複選框時傳回做為宣告。

  6. 選取 [確定]。

    在版面配置選項中將多重選取複選框新增至字串屬性的螢幕快照。

  7. 在 [ 頁面配置 ] 頁面上，選取 [ 儲存]。

設定單選按鈕 （RadioSingleSelect）

具有 String 數據類型的屬性可以設定為 RadioSingleSelect 使用者輸入類型，這是一系列出現在屬性標籤下的單選按鈕。 使用者只能選取一個單選按鈕。 您可以定義個別單選按鈕的文字，並包含其他內容的超連結。

  1. 在 [ 版面配置 ] 頁面上，尋找具有您要設定為單選按鈕或一系列單選按鈕之 String 數據類型的屬性。

  2. 選擇[ 捲標 ] 資料列中的值，然後輸入您想要顯示在單選按鈕數列上方的標題，例如 Sweatshirt size。

  3. 選取 [ 使用者輸入類型 ] 資料行中的值，以開啟編輯器窗格。

  4. 在編輯器窗格中，於 [使用者輸入類型] 底下，選取 [RadioSingleSelect]。

  5. 針對您要新增的每個單選按鈕，請從新行開始，並輸入下列資訊：

    • 在 [ 文字] 底下，輸入您要顯示在單選按鈕旁的文字。 使用 Markdown 語言新增超連結。

    • 在 [值] 底下，輸入要寫入用戶物件上的值，並在用戶選取單選按鈕時傳回做為宣告。

  6. 選取 [確定]。

    在版面配置選項中將單選按鈕新增至字串屬性的螢幕快照。

  7. 在 [ 頁面配置 ] 頁面上，選取 [ 儲存]。

尋找擴充功能應用程式的應用程式識別碼

自定義使用者屬性會儲存在名為 b2c-extensions-app 的應用程式。 當使用者在註冊期間輸入自定義屬性的值之後，它會新增至用戶物件，而且可以使用命名慣例 extension_{appId-without-hyphens}_{custom-attribute-name} 呼叫 Microsoft Graph API，其中：

  • {appId-without-hyphens}是 b2c-extensions-app 用戶端標識符的移除版本。
  • {custom-attribute-name} 是您指派給自訂屬性的名稱。

使用下列步驟來尋找擴充功能應用程式的應用程式識別碼：

  1. 登入 Microsoft Entra 系統管理中心。
  2. 流覽至 [身分>識別 應用程式註冊> 所有應用程式]。
  3. 選取應用程式 b2c-extensions-app。請勿修改。AADB2C 用來儲存用戶數據。
  4. 在 [ 概觀] 頁面上，使用 應用程式 （用戶端） 識別符 值，例如： 12345678-abcd-1234-1234-ab123456789，但移除連字元。

例如，如果您建立名為 loyaltyNumber的自定義屬性，請將它稱為 extension_12345678abcd12341234ab123456789_loyaltyNumber

將自訂使用者屬性新增至標識元令牌

當使用者登入您的應用程式時，應用程式會收到標識元令牌，其中包含使用者詳細數據。 這些詳細數據稱為令牌宣告。 如有需要，您可以將自定義使用者屬性包含在傳回至應用程式的標識碼令牌中做為宣告。 若要這樣做，請遵循將屬性新增至傳回至應用程式文章之標識符令牌中的步驟。

下一步

將屬性新增至傳回至應用程式的標識碼令牌。

為客戶建立註冊和登入使用者流程。