在 Azure Active Directory B2C 中添加用户属性和自定义用户输入

开始之前,请使用此页顶部的“选择策略类型”选择器来选择要设置的策略类型。 Azure Active Directory B2C 提供了两种定义用户如何与应用程序交互的方法:通过预定义的用户流,或者通过可完全配置的自定义策略。 对于每种方法,本文中所需的步骤都不同。

在本文中,你将在 Azure Active Directory B2C (Azure AD B2C) 的注册过程中收集一个新属性,如 city。 你将获得用户的“city”,将其配置为下拉列表,并定义是否需要提供此项。

重要

此示例使用内置声明“city”。 相反,你可以选择一个受支持的 Azure AD B2C 内置属性或自定义属性。 若要使用自定义属性,请启用自定义属性。 若要使用不同的内置或自定义属性,请将“city”替换为所选的属性,例如内置属性“jobTitle”或“extension_loyaltyId”之类的自定义属性。

先决条件

为用户流添加用户属性

  1. 登录 Azure 门户
  2. 如果有权访问多个租户,请选择顶部菜单中的“设置”图标,从“目录 + 订阅”菜单切换到你的 Azure AD B2C 租户。
  3. 在“Azure 服务”下,选择“Azure AD B2C”。 或者,使用搜索框查找并选择“Azure AD B2C”。
  4. 在 Azure AD B2C 租户中,选择“用户流” 。
  5. 选择策略(例如,“B2C_1_SignupSignin”)将其打开。
  6. 选择“用户属性”,然后选择用户属性(例如,“City”)。
  7. 选择“保存”。

向应用提供可选声明

应用程序声明是返回给应用程序的值。 更新用户流以包含所需的声明:

  1. 选择策略(例如,“B2C_1_SignupSignin”)将其打开。
  2. 选择“应用程序声明” 。
  3. 选择要发送回应用程序的属性(例如“City”)。
  4. 选择“保存”。

配置用户属性输入类型

  1. 选择策略(例如,“B2C_1_SignupSignin”)将其打开。

  2. 选择“页面布局”。

  3. 选择“本地帐户注册页”

  4. 在“用户属性”下,选择“City”。

    1. 在“可选”下拉列表中,选择“否”。
    2. 在“用户输入类型”中,选择当前用户输入类型,例如“TextBox”,以打开“用户输入类型编辑器”窗格。
    3. 在“用户输入类型”下拉列表中,选择“DropdownSingleSelect”。
    4. 在“文本”和“值”中,输入构成属性响应集的文本和值对。 “文本”将显示在你的流的 Web 界面中,并且“值”将存储到 Azure AD B2C 以用于选定的“文本”。 可选:使用“上移/下移”按钮对下拉项重新排序。
  5. 选择“确定”。 可选:使用“上移/下移”按钮对注册页中的用户属性重新排序。

  6. 选择“保存”。

    调用绿色 API 的网页。

使用本地化集合提供值列表

若要为 city 属性提供一组值列表,请执行以下操作:

  1. 在用户流上启用语言自定义
  2. 选择策略(例如,“B2C_1_SignupSignin”)将其打开。
  3. 在用户流的“语言”页面,选择想要自定义的语言 。
  4. 在“页面级别资源文件”下,选择“本地帐户注册页”。
  5. 选择“下载默认值”(如果以前已编辑这种语言,则选择“下载重写”)。
  6. 创建 LocalizedCollections 属性。

LocalizedCollectionsNameValue 对的数组。 项目的顺序是它们显示的顺序。

  • ElementId 是此 LocalizedCollections 属性响应的用户属性。
  • Name 是向用户显示的值。
  • Value 是选择此选项时要在声明中返回的内容。
{
  "LocalizedStrings": [...],
  "LocalizedCollections": [
    {
      "ElementType": "ClaimType",
      "ElementId": "city",
      "TargetCollection": "Restriction",
      "Override": true,
      "Items": [
        {
          "Name": "Berlin",
          "Value": "Berlin"
        },
        {
          "Name": "London",
          "Value": "London"
        },
        {
          "Name": "Seattle",
          "Value": "Seattle"
        }
      ]
    }
  ]
}

上传更改

  1. 完成对 JSON 文件的更改后,返回到 B2C 租户。
  2. 选择“用户流”,并选择策略(例如,“B2C_1_SignupSignin”)将其打开。
  3. 选择“语言” 。
  4. 选择要翻译成的语言。
  5. 在“页面-级别-资源文件”下,选择“本地帐户注册页”。
  6. 选择文件夹图标,选择要上传的 JSON 文件。 更改将自动保存到用户流。

测试用户流

  1. 选择策略(例如,“B2C_1_SignupSignin”)将其打开。
  2. 若要测试策略,请选择“运行用户流”。
  3. 对于“应用程序”,请选择前面已注册的名为“testapp1”的 Web 应用程序。 “回复 URL”应显示为 https://jwt.ms
  4. 选择“运行用户流”

概述

可以通过注册或登录用户旅程从用户那里收集初始数据。 稍后可以使用配置文件编辑用户旅程来收集更多声明。 每当 Azure AD B2C 以交互方式直接从用户收集信息时,都会使用自断言技术配置文件。 在此示例中,你将执行以下操作:

  1. 定义“city”声明。
  2. 请求用户输入其所在城市。
  3. 将城市保存到 Azure AD B2C 目录中的用户配置文件。
  4. 每次登录时,请从 Azure AD B2C 目录中读取 city 声明。
  5. 登录或注册后,将 city 返回给信赖方应用。

定义声明

声明可在 Azure AD B2C 策略执行过程中提供数据的临时存储。 声明架构是发出声明的位置。 以下元素用于定义声明:

  • DisplayName - 一个字符串,用于定义面向用户的标签。
  • DataType - 声明类型。
  • UserHelpText - 帮助用户了解需要提供哪些信息。
  • UserInputType - 输入控件类型(如文本框、单选按钮选择、下拉列表或多重选择)。

打开策略的扩展文件, 例如 SocialAndLocalAccounts/TrustFrameworkExtensions.xml

  1. 搜索 BuildingBlocks 元素。 如果该元素不存在,请添加该元素。
  2. 找到 ClaimsSchema 元素。 如果该元素不存在,请添加该元素。
  3. 将 city 声明添加到 ClaimsSchema 元素。
<!-- 
<BuildingBlocks>
  <ClaimsSchema> -->
    <ClaimType Id="city">
      <DisplayName>City where you work</DisplayName>
      <DataType>string</DataType>
      <UserInputType>DropdownSingleSelect</UserInputType>
      <Restriction>
        <Enumeration Text="Berlin" Value="berlin" />
        <Enumeration Text="London" Value="london" />
        <Enumeration Text="Seattle" Value="seattle" />
      </Restriction>
    </ClaimType>
  <!-- 
  </ClaimsSchema>
</BuildingBlocks>-->

Enumeration 元素上包含 SelectByDefault 属性,使其在页面首次加载时默认选中。 例如,若要预先选择 London 项,请更改 Enumeration 元素,如以下示例所示:

<Restriction>
  <Enumeration Text="Berlin" Value="berlin" />
  <Enumeration Text="London" Value="london" SelectByDefault="true" />
  <Enumeration Text="Seattle" Value="seattle" />
</Restriction>

向用户界面添加声明

以下技术配置文件为自断言,在用户需要提供输入时调用:

  • LocalAccountSignUpWithLogonEmail - 本地帐户注册流。
  • SelfAsserted-Social - 联合帐户首次用户登录。
  • SelfAsserted-ProfileUpdate - 编辑配置文件流。

若要在注册期间收集 city 声明,则必须将其作为输出声明添加到 LocalAccountSignUpWithLogonEmail 技术配置文件。 在扩展文件中覆盖此技术配置文件。 指定输出声明的整个列表,以控制声明在屏幕上的显示顺序。 找到 ClaimsProviders 元素。 添加一个新的 ClaimsProviders,如下所示:

<ClaimsProvider>
  <DisplayName>Local Account</DisplayName>
  <TechnicalProfiles>
    <!--Local account sign-up page-->
    <TechnicalProfile Id="LocalAccountSignUpWithLogonEmail">
      <OutputClaims>
       <OutputClaim ClaimTypeReferenceId="email" PartnerClaimType="Verified.Email" Required="true" />
       <OutputClaim ClaimTypeReferenceId="newPassword" Required="true" />
       <OutputClaim ClaimTypeReferenceId="reenterPassword" Required="true" />
       <OutputClaim ClaimTypeReferenceId="displayName" />
       <OutputClaim ClaimTypeReferenceId="givenName" />
       <OutputClaim ClaimTypeReferenceId="surName" />
       <OutputClaim ClaimTypeReferenceId="city"/>
     </OutputClaims>
   </TechnicalProfile>
  </TechnicalProfiles>
</ClaimsProvider>

若要在使用联合帐户初次登录后收集 city 声明,必须将其作为输出声明添加到 SelfAsserted-Social 技术配置文件。 为了使本地和联合帐户用户以后能够编辑其配置文件数据,请将输入和输出声明添加到 SelfAsserted-ProfileUpdate 技术配置文件。 在扩展文件中覆盖这些技术配置文件。 指定输出声明的整个列表,以控制声明在屏幕上的显示顺序。 找到 ClaimsProviders 元素。 添加一个新的 ClaimsProviders,如下所示:

<ClaimsProvider>
  <DisplayName>Self Asserted</DisplayName>
  <TechnicalProfiles>
    <!--Federated account first-time sign-in page-->
    <TechnicalProfile Id="SelfAsserted-Social">
      <InputClaims>
        <InputClaim ClaimTypeReferenceId="city" />
      </InputClaims>
      <OutputClaims>
        <OutputClaim ClaimTypeReferenceId="displayName"/>
        <OutputClaim ClaimTypeReferenceId="givenName"/>
        <OutputClaim ClaimTypeReferenceId="surname"/>
        <OutputClaim ClaimTypeReferenceId="city"/>
      </OutputClaims>
    </TechnicalProfile>
    <!--Edit profile page-->
    <TechnicalProfile Id="SelfAsserted-ProfileUpdate">
      <InputClaims>
        <InputClaim ClaimTypeReferenceId="city" />
      </InputClaims>
      <OutputClaims>
        <OutputClaim ClaimTypeReferenceId="displayName"/>
        <OutputClaim ClaimTypeReferenceId="givenName" />
        <OutputClaim ClaimTypeReferenceId="surname" />
        <OutputClaim ClaimTypeReferenceId="city"/>
      </OutputClaims>
    </TechnicalProfile>
  </TechnicalProfiles>
</ClaimsProvider>

读取和写入声明

以下技术配置文件是 Active Directory 技术配置文件,它们会在 Microsoft Entra ID 中读写数据。
使用 PersistedClaims 将数据写入用户配置文件,使用 OutputClaims 从相应的 Active Directory 技术配置文件的用户配置文件中读取数据。

在扩展文件中覆盖这些技术配置文件。 找到 ClaimsProviders 元素。 添加一个新的 ClaimsProviders,如下所示:

<ClaimsProvider>
  <DisplayName>Azure Active Directory</DisplayName>
  <TechnicalProfiles>
    <!-- Write data during a local account sign-up flow. -->
    <TechnicalProfile Id="AAD-UserWriteUsingLogonEmail">
      <PersistedClaims>
        <PersistedClaim ClaimTypeReferenceId="city"/>
      </PersistedClaims>
    </TechnicalProfile>
    <!-- Write data during a federated account first-time sign-in flow. -->
    <TechnicalProfile Id="AAD-UserWriteUsingAlternativeSecurityId">
      <PersistedClaims>
        <PersistedClaim ClaimTypeReferenceId="city"/>
      </PersistedClaims>
    </TechnicalProfile>
    <!-- Write data during edit profile flow. -->
    <TechnicalProfile Id="AAD-UserWriteProfileUsingObjectId">
      <PersistedClaims>
        <PersistedClaim ClaimTypeReferenceId="city"/>
      </PersistedClaims>
    </TechnicalProfile>
    <!-- Read data after user resets the password. -->
    <TechnicalProfile Id="AAD-UserReadUsingEmailAddress">
      <OutputClaims>  
        <OutputClaim ClaimTypeReferenceId="city" />
      </OutputClaims>
    </TechnicalProfile>
    <!-- Read data after user authenticates with a local account. -->
    <TechnicalProfile Id="AAD-UserReadUsingObjectId">
      <OutputClaims>  
        <OutputClaim ClaimTypeReferenceId="city" />
      </OutputClaims>
    </TechnicalProfile>
    <!-- Read data after user authenticates with a federated account. -->
    <TechnicalProfile Id="AAD-UserReadUsingAlternativeSecurityId">
      <OutputClaims>  
        <OutputClaim ClaimTypeReferenceId="city" />
      </OutputClaims>
    </TechnicalProfile>
  </TechnicalProfiles>
</ClaimsProvider>

在令牌中包括声明

若要将 city 声明返回到信赖方应用,请将输出声明添加到 SocialAndLocalAccounts/SignUpOrSignIn.xml 文件。 输出声明将在用户旅程成功后添加到令牌,并发送到应用程序。 修改信赖方部分中的技术配置文件元素,以将 city 添加为输出声明。

<RelyingParty>
  <DefaultUserJourney ReferenceId="SignUpOrSignIn" />
  <TechnicalProfile Id="PolicyProfile">
    <DisplayName>PolicyProfile</DisplayName>
    <Protocol Name="OpenIdConnect" />
    <OutputClaims>
      <OutputClaim ClaimTypeReferenceId="displayName" />
      <OutputClaim ClaimTypeReferenceId="givenName" />
      <OutputClaim ClaimTypeReferenceId="surname" />
      <OutputClaim ClaimTypeReferenceId="email" />
      <OutputClaim ClaimTypeReferenceId="objectId" PartnerClaimType="sub"/>
      <OutputClaim ClaimTypeReferenceId="identityProvider" />
      <OutputClaim ClaimTypeReferenceId="tenantId" AlwaysUseDefaultValue="true" DefaultValue="{Policy:TenantObjectId}" />
      <OutputClaim ClaimTypeReferenceId="city" DefaultValue="" />
    </OutputClaims>
    <SubjectNamingInfo ClaimType="sub" />
  </TechnicalProfile>
</RelyingParty>

上传并测试已更新的自定义策略

  1. 如果有权访问多个租户,请选择顶部菜单中的“设置”图标,切换到“目录 + 订阅”菜单中的 Azure AD B2C 租户
  2. 搜索并选择“Azure AD B2C”。
  3. 在“策略”下,选择“Identity Experience Framework”。
  4. 选择“上传自定义策略”。
  5. 上传之前更改的策略文件。

测试自定义策略

  1. 选择信赖方策略,例如 B2C_1A_signup_signin
  2. 对于“应用程序”,请选择前面注册的 Web 应用程序。 “回复 URL”应显示为 https://jwt.ms
  3. 选择“立即运行”按钮。
  4. 从注册或登录页面,选择“立即注册”进行注册。 完成输入用户信息(包括城市名称),然后选择“创建”。 应看到返回的令牌的内容。

注册屏幕应类似于以下屏幕快照:

修改后的注册选项屏幕截图

发送回应用程序的令牌包含 city 声明。

{
  "typ": "JWT",
  "alg": "RS256",
  "kid": "X5eXk4xyojNFum1kl2Ytv8dlNP4-c57dO6QGTVBwaNk"
}.{
  "exp": 1583500140,
  "nbf": 1583496540,
  "ver": "1.0",
  "iss": "https://contoso.b2clogin.cn/f06c2fe8-709f-4030-85dc-38a4bfd9e82d/v2.0/",
  "aud": "e1d2612f-c2bc-4599-8e7b-d874eaca1ee1",
  "acr": "b2c_1a_signup_signin",
  "nonce": "defaultNonce",
  "iat": 1583496540,
  "auth_time": 1583496540,
  "name": "Emily Smith",
  "email": "joe@outlook.com",
  "given_name": "Emily",
  "family_name": "Smith",
  "city": "Berlin"
  ...
}

[可选] UI 本地化

Azure AD B2C 允许你根据不同的语言调整策略。 有关详细信息,请参阅了解如何自定义语言体验。 若要本地化注册页面,请参阅设置支持语言列表提供特定于语言的标签

注意

LocalizedCollection 与特定于语言的标签一起使用时,可以从声明定义中删除 Restriction 集合。

以下示例演示如何提供适用于英语和西班牙语的城市列表。 这两个元素都设置了声明 city 的 Restriction 集合,以及适用于英语和西班牙语的项列表。 SelectByDefault 在页面首次加载时默认选中一个项目。

<!-- 
<BuildingBlocks>-->
  <Localization Enabled="true">
    <SupportedLanguages DefaultLanguage="en" MergeBehavior="Append">
      <SupportedLanguage>en</SupportedLanguage>
      <SupportedLanguage>es</SupportedLanguage>
    </SupportedLanguages>
    <LocalizedResources Id="api.localaccountsignup.en">
      <LocalizedCollections>
        <LocalizedCollection ElementType="ClaimType" ElementId="city" TargetCollection="Restriction">
          <Item Text="Berlin" Value="Berlin"></Item>
          <Item Text="London" Value="London" SelectByDefault="true"></Item>
          <Item Text="Seattle" Value="Seattle"></Item>
        </LocalizedCollection>
      </LocalizedCollections>
    </LocalizedResources>
    <LocalizedResources Id="api.localaccountsignup.es">
      <LocalizedCollections>
        <LocalizedCollection ElementType="ClaimType" ElementId="city" TargetCollection="Restriction">
          <Item Text="Berlina" Value="Berlin"></Item>
          <Item Text="Londres" Value="London" SelectByDefault="true"></Item>
          <Item Text="Seattle" Value="Seattle"></Item>
        </LocalizedCollection>
      </LocalizedCollections>
    </LocalizedResources>
  </Localization>
<!-- 
</BuildingBlocks>-->

添加本地化元素后,使用本地化编辑内容定义。 在以下示例中,英语 (en) 和西班牙语 (es) 自定义本地化资源已添加到注册页面:

<!-- 
<BuildingBlocks>
  <ContentDefinitions> -->
   <ContentDefinition Id="api.localaccountsignup">
    <LocalizedResourcesReferences MergeBehavior="Prepend">
        <LocalizedResourcesReference Language="en" LocalizedResourcesReferenceId="api.localaccountsignup.en" />
        <LocalizedResourcesReference Language="es" LocalizedResourcesReferenceId="api.localaccountsignup.es" />
    </LocalizedResourcesReferences>
   </ContentDefinition>
  <!-- 
  </ContentDefinitions>
</BuildingBlocks>-->

后续步骤