设置使用 PingOne 帐户进行注册和登录 - Azure AD B2C

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

项目
11/16/2023

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

必备条件

创建用户流，以便用户能够注册并登录应用程序。
注册 Web 应用程序。

完成 Active Directory B2C 中的自定义策略入门中的步骤
注册 Web 应用程序。

创建 PingOne 应用程序

若要使用户能够在 Azure Active Directory B2C (Azure AD B2C) 中使用 PingOne (PingIdentity) 帐户登录，需在 Ping 标识管理员控制台中创建一个应用程序。有关详细信息，请参阅 Ping 标识文档中的添加或更新 OIDC 应用程序。如果没有 PingOne 帐户，可以在 https://admin.pingone.com/web-portal/register 上注册。

使用 PingOne 帐户凭据登录到 Ping 标识管理员控制台。
在页面的左侧菜单中，选择“连接”，然后选择“应用程序”旁边的 +。
在“新建应用程序”页中，选择“Web 应用”，然后在“OIDC”下选择“配置”。
输入应用程序名称，然后选择“下一步”。
对于“重定向 URL”，请输入 https://your-tenant-name.b2clogin.com/your-tenant-name.onmicrosoft.com/oauth2/authresp。如果使用自定义域，请输入 https://your-domain-name/your-tenant-name.onmicrosoft.com/oauth2/authresp。将 your-domain-name 替换为你的自定义域，将 your-tenant-name 替换为租户的名称。输入租户名称时，全部使用小写字母，即使租户是使用大写字母在 Azure AD B2C 中定义的，也是如此。
选择“保存并继续”。
在“作用域”下，选择“电子邮件”和“配置文件”，然后选择“保存并继续”。
在“OIDC 属性”页下，选择“保存并关闭”。
在应用程序列表中，选择创建的应用程序。
在应用程序“配置文件”页中，执行以下操作：
1. 在应用程序名称旁边，使用切换按钮启用应用。
2. 复制“客户端 ID”的值。
选择“配置”选项卡，然后执行以下操作：
1. 复制 OIDC 发现终结点。
2. 显示并复制客户端密码。
3. 将模式更改为“编辑”。然后，在“令牌终结点身份验证方法”下，将值更改为“客户端密码 Post”，然后选择“保存”

将 PingOne 配置为标识提供者

如果有权访问多个租户，请选择顶部菜单中的“设置”图标，从“目录 + 订阅”菜单切换到你的 Azure AD B2C 租户。
选择 Azure 门户左上角的“所有服务”，然后搜索并选择“Azure AD B2C” 。
选择“标识提供程序”，然后选择“新建 OpenID Connect 提供程序” 。
输入“名称”。例如，输入“PingOne”。

对于“元数据 URL”，请输入之前记录的 OIDC 发现终结点。例如：

https://auth.pingone.eu/00000000-0000-0000-0000-000000000000/as/.well-known/openid-configuration

对于“客户端 ID”，请输入之前记录的客户端 ID。
对于“客户端机密”，请输入之前记录的客户端机密。
对于“作用域”，输入 openid email profile。
对于“响应类型”和“响应模式” ，请保留默认值。
（可选）对于“域提示”，请输入 pingone.com。有关详细信息，请参阅使用 Azure Active Directory B2C 设置直接登录。
在“标识提供者声明映射”下，选择以下声明：
- 用户 ID：sub
- 显示名称：name
- 给定名称：given_name
- 姓氏：family_name
- 电子邮件：email
选择“保存”。

将 PingOne 标识提供者添加到用户流

此时，PingOne 标识提供者已设置，但还不能在任何登录页中使用。若要将 PingOne 标识提供者添加到用户流：

在 Azure AD B2C 租户中，选择“用户流” 。
单击要添加 PingOne 标识提供者的用户流。
在“社交标识提供者”下，选择“PingOne”。
选择“保存”。
若要测试策略，请选择“运行用户流”。
对于“应用程序”，请选择前面已注册的名为“testapp1”的 Web 应用程序。 “回复 URL”应显示为 https://jwt.ms。
选择“运行用户流”按钮。
在注册或登录页面中，选择“PingOne”以使用 PingOne 帐户登录。

如果登录过程成功，则浏览器会重定向到 https://jwt.ms，后者显示 Azure AD B2C 返回的令牌内容。

创建策略密钥

你需要存储前面在 Azure AD B2C 租户中记录的客户端机密。

登录 Azure 门户。
如果有权访问多个租户，请选择顶部菜单中的“设置”图标，从“目录 + 订阅”菜单切换到你的 Azure AD B2C 租户。
选择 Azure 门户左上角的“所有服务”，然后搜索并选择“Azure AD B2C” 。
在“概述”页上选择“标识体验框架”。
选择“策略密钥”，然后选择“添加”。
对于“选项”，请选择 Manual。
输入策略密钥的名称。例如，PingOneSecret。前缀 B2C_1A_ 会自动添加到密钥名称。
在“机密”中，输入前面记录的应用程序机密。
在“密钥用法”处选择 Signature。
单击“创建”。

将 PingOne 配置为标识提供者

要使用户能够使用 PingOne 帐户登录，需将该帐户定义为 Azure AD B2C 可通过终结点与之通信的声明提供程序。该终结点将提供一组声明，Azure AD B2C 使用这些声明来验证特定的用户是否已完成身份验证。

可以通过在策略的扩展文件中将 PingOne 帐户添加到 ClaimsProviders 元素，将该帐户定义为声明提供程序。

打开 TrustFrameworkExtensions.xml。
找到 ClaimsProviders 元素。如果该元素不存在，请在根元素下添加它。

如下所示添加新的 ClaimsProvider：

<ClaimsProvider>
  <Domain>pingone.com</Domain>
  <DisplayName>PingOne</DisplayName>
  <TechnicalProfiles>
    <TechnicalProfile Id="PingOne-OpenIdConnect">
      <DisplayName>Ping Identity</DisplayName>
      <Protocol Name="OpenIdConnect" />
      <Metadata>
        <Item Key="METADATA">Your PingOne OIDC discovery endpoint</Item>
        <Item Key="client_id">Your PingOne client ID</Item>
        <Item Key="response_types">code</Item>
        <Item Key="scope">openid email profile</Item>
        <Item Key="HttpBinding">POST</Item>
        <Item Key="UsePolicyInRedirectUri">0</Item>
      </Metadata>
      <CryptographicKeys>
        <Key Id="client_secret" StorageReferenceId="B2C_1A_PingOneSecret" />
      </CryptographicKeys>
      <OutputClaims>
        <OutputClaim ClaimTypeReferenceId="issuerUserId" PartnerClaimType="sub" />
        <OutputClaim ClaimTypeReferenceId="email" PartnerClaimType="email" />
        <OutputClaim ClaimTypeReferenceId="givenName" PartnerClaimType="given_name" />
        <OutputClaim ClaimTypeReferenceId="surname" PartnerClaimType="family_name" />
        <OutputClaim ClaimTypeReferenceId="displayName" PartnerClaimType="name" />
        <OutputClaim ClaimTypeReferenceId="identityProvider" PartnerClaimType="iss" />
        <OutputClaim ClaimTypeReferenceId="authenticationSource" DefaultValue="socialIdpAuthentication" />
      </OutputClaims>
      <OutputClaimsTransformations>
        <OutputClaimsTransformation ReferenceId="CreateRandomUPNUserName" />
        <OutputClaimsTransformation ReferenceId="CreateUserPrincipalName" />
        <OutputClaimsTransformation ReferenceId="CreateAlternativeSecurityId" />
        <OutputClaimsTransformation ReferenceId="CreateSubjectClaimFromAlternativeSecurityId" />
      </OutputClaimsTransformations>
      <UseTechnicalProfileForSessionManagement ReferenceId="SM-SocialLogin" />
    </TechnicalProfile>
  </TechnicalProfiles>
</ClaimsProvider>

将 METADATA 元数据设置为 PingOne OIDC 发现终结点。
将 client_id 元数据设置为 PingOne 客户端 ID。
保存文件。

添加用户旅程

此时，标识提供者已设置，但还不能在任何登录页中使用。如果你没有自己的自定义用户旅程，请创建现有模板用户旅程的副本，否则，请继续执行下一步。

打开初学者包中的 TrustFrameworkBase.xml 文件。
找到并复制包含 Id="SignUpOrSignIn" 的 UserJourney 元素的完整内容。
打开 TrustFrameworkExtensions.xml 并找到 UserJourneys 元素。如果该元素不存在，请添加一个。
将复制的 UserJourney 元素的完整内容粘贴为 UserJourneys 元素的子级。
对用户旅程的 ID 进行重命名。例如，Id="CustomSignUpSignIn"。

将标识提供者添加到用户旅程

目前你已拥有用户旅程，请将新的标识提供者添加到用户旅程。首先添加一个“登录”按钮，然后将该按钮链接到某个操作。该操作是你之前创建的技术配置文件。

在用户旅程中，查找包含 Type="CombinedSignInAndSignUp" 或 Type="ClaimsProviderSelection" 的业务流程步骤元素。这通常是第一个业务流程步骤。 ClaimsProviderSelections 元素包含用户可以用来登录的标识提供者列表。元素的顺序将决定向用户显示的登录按钮的顺序。添加 ClaimsProviderSelection XML 元素。将 TargetClaimsExchangeId 的值设置为易记名称。
在下一个业务流程步骤中，添加 ClaimsExchange 元素。将 ID 设置为目标声明交换 ID 的值。将 TechnicalProfileReferenceId 的值更新为之前创建的技术配置文件的 ID 。

下面的 XML 演示了使用标识提供者进行用户旅程的前两个业务流程步骤：

<OrchestrationStep Order="1" Type="CombinedSignInAndSignUp" ContentDefinitionReferenceId="api.signuporsignin">
  <ClaimsProviderSelections>
    ...
    <ClaimsProviderSelection TargetClaimsExchangeId="PingOneExchange" />
  </ClaimsProviderSelections>
  ...
</OrchestrationStep>

<OrchestrationStep Order="2" Type="ClaimsExchange">
  ...
  <ClaimsExchanges>
    <ClaimsExchange Id="PingOneExchange" TechnicalProfileReferenceId="PingOne-OpenIdConnect" />
  </ClaimsExchanges>
</OrchestrationStep>

配置信赖方策略

信赖方策略（例如 SignUpSignIn.xml）指定 Azure AD B2C 将执行的用户旅程。在信赖方内查找 DefaultUserJourney 元素。更新 ReferenceId，使其与已在其中添加标识提供者的用户旅程 ID 匹配。

在以下示例中，对于 CustomSignUpSignIn 用户旅程，将 ReferenceId 设置为 CustomSignUpSignIn：

<RelyingParty>
  <DefaultUserJourney ReferenceId="CustomSignUpSignIn" />
  ...
</RelyingParty>

上传自定义策略

登录 Azure 门户。
在门户工具栏中选择“目录 + 订阅”图标，然后选择包含 Azure AD B2C 租户的目录。
在 Azure 门户中，搜索并选择“Azure AD B2C”。
在“策略”下，选择“Identity Experience Framework”。
选择“上传自定义策略”，然后上传已更改的两个策略文件，其顺序为：先上传扩展策略（例如 TrustFrameworkExtensions.xml），然后上传信赖方策略（例如 SignUpSignIn.xml）。

测试自定义策略

选择信赖方策略，例如 B2C_1A_signup_signin。
对于“应用程序”，请选择前面注册的 Web 应用程序。 “回复 URL”应显示为 https://jwt.ms。
选择“立即运行”按钮。
在注册或登录页面中，选择“PingOne”以使用 PingOne 帐户登录。

如果登录过程是成功的，则你的浏览器会被重定向到 https://jwt.ms，其中显示 Azure AD B2C 返回的令牌内容。

后续步骤

了解如何将 PingOne 令牌传递给应用程序。

通过

必备条件

创建 PingOne 应用程序

将 PingOne 配置为标识提供者

将 PingOne 标识提供者添加到用户流

创建策略密钥

将 PingOne 配置为标识提供者

添加用户旅程

将标识提供者添加到用户旅程

配置信赖方策略

上传自定义策略

测试自定义策略

后续步骤

反馈

其他资源

通过

设置使用 Azure Active Directory B2C 通过 PingOne 帐户进行注册和登录

必备条件

创建 PingOne 应用程序

将 PingOne 配置为标识提供者

将 PingOne 标识提供者添加到用户流

创建策略密钥

将 PingOne 配置为标识提供者

添加用户旅程

将标识提供者添加到用户旅程

配置信赖方策略

上传自定义策略

测试自定义策略

后续步骤

反馈

其他资源