定义用户流的自定义属性

  • 项目

提示

本文适用于 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”开头的应用并将其选中。 在应用的“概述”页上，记下应用程序（客户端）ID。

创建自定义属性

提示

本文中的步骤可能因开始使用的门户而略有不同。

  1. 至少以用户管理员身份登录到 Microsoft Entra 管理中心。

  2. 浏览到“标识”>“外部标识”>“概述”。

  3. 选择自定义用户属性。 此时会列出可用的用户属性。

    选择用于注册的自定义用户属性的屏幕截图。

  4. 若要添加属性，请选择“添加”。

  5. 在“添加属性”窗格中，输入以下值：

    • 名称 - 输入自定义属性的名称（例如“Shoesize”）。
    • 数据类型 - 选择数据类型（“字符串”、“布尔”或“整数”）。
    • 说明 -（可选）输入自定义属性的说明，以供内部使用。 此说明对用户不可见。

    添加自定义属性的屏幕截图。

  6. 选择创建。

将自定义属性添加到用户属性列表时，该属性可在用户流中使用。 但是，该属性仅在首次在任何用户流中使用时创建。 通过包含了新添加的自定义属性的用户流创建新用户后，可以在 Microsoft Graph Explorer 中查询该对象。 现在，应可在注册期间收集的用户对象属性的列表中看到“ShoeSize”。 在将属性添加到用户对象之后，可从应用程序调用图形 API 以从该属性获取数据。

后续步骤