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

在 Azure Active Directory B2C 自定义策略中定义 OpenID Connect 技术配置文件

项目
01/11/2024

注意

在 Azure Active Directory B2C 中，自定义策略主要用于解决复杂的情况。在大多数情况下，建议你使用内置用户流。如果尚未这样做，请从 Active Directory B2C 中的自定义策略入门了解自定义策略新手包。

Azure Active Directory B2C (Azure AD B2C) 为 OpenID Connect 协议标识提供者提供支持。 OpenID Connect 1.0 在 OAuth 2.0 基础上提供一个标识层，代表现代身份验证协议的最新技术。使用 OpenID Connect 技术配置文件，可以与基于 OpenID Connect 的标识提供者（如 Microsoft Entra ID）联合。与标识提供者联合允许用户使用其现有的社交或企业标识登录。

协议

“Protocol”元素的“Name”属性必须设置为 OpenIdConnect。例如，MSA-OIDC 技术配置文件的协议为 OpenIdConnect：

<TechnicalProfile Id="MSA-OIDC">
  <DisplayName>Microsoft Account</DisplayName>
  <Protocol Name="OpenIdConnect" />
  ...

输入声明

InputClaims 和 InputClaimsTransformations 元素不是必需的。但是，你可能需要向标识提供者发送更多参数。以下示例将值为的 domain_hint 查询字符串参数添加到授权请求。

<InputClaims>
  <InputClaim ClaimTypeReferenceId="domain_hint" DefaultValue="contoso.com" />
</InputClaims>

输出声明

OutputClaims 元素包含 OpenID Connect 标识提供者返回的声明列表。可能需要将策略中定义的声明名称映射到标识提供者中定义的名称。如果设置了 DefaultValue 属性，则还可以包含标识提供者不会返回的声明。

OutputClaimsTransformations 元素可能包含用于修改输出声明或生成新输出声明的 OutputClaimsTransformation 元素集合。

以下示例演示 Microsoft Account 标识提供者返回的声明：

映射到 issuerUserId 声明的 sub 声明。
映射到 displayName 声明的 name 声明。
没有名称映射的 email。

技术配置文件还会返回标识提供者不返回的声明：

identityProvider 声明，其中包含标识提供者的名称。
authenticationSource 声明，其默认值为 socialIdpAuthentication。

<OutputClaims>
  <OutputClaim ClaimTypeReferenceId="identityProvider" DefaultValue="live.com" />
  <OutputClaim ClaimTypeReferenceId="authenticationSource" DefaultValue="socialIdpAuthentication" />
  <OutputClaim ClaimTypeReferenceId="issuerUserId" PartnerClaimType="sub" />
  <OutputClaim ClaimTypeReferenceId="displayName" PartnerClaimType="name" />
  <OutputClaim ClaimTypeReferenceId="email" />
</OutputClaims>

元数据

Attribute	必须	说明
client_id	是	标识提供者的应用程序标识符。
IdTokenAudience	否	id_token 的受众。如果指定了此项，Azure AD B2C 将检查标识提供者返回的令牌中的 `aud` 声明是否与 IdTokenAudience 元数据中指定的声明相同。
METADATA	是	指向 OpenID Connect 标识提供者配置文档的 URL，也称为 OpenID 众所周知的配置终结点。 URL 可以包含 `{tenant}` 表达式，该表达式将替换为租户名称。
authorization_endpoint	否	指向 OpenID Connect 标识提供者配置授权终结点的 URL。 authorization_endpoint 元数据的值优先于 OpenID 众所周知的配置终结点中指定的 `authorization_endpoint`。 URL 可以包含 `{tenant}` 表达式，该表达式将替换为租户名称。
end_session_endpoint	否	结束会话终结点的 URL。 `end_session_endpoint` 元数据的值优先于 OpenID 众所周知的配置终结点中指定的 `end_session_endpoint`。
颁发者	否	OpenID Connect 标识提供者的唯一标识符。颁发者元数据的值优先于 OpenID 众所周知的配置终结点中指定的 `issuer`。如果指定了此项，Azure AD B2C 将检查标识提供者返回的令牌中的 `iss` 声明是否与颁发者元数据中指定的声明相同。
ProviderName	否	标识提供者的名称。
response_types	否	符合 OpenID Connect Core 1.0 规范的响应类型。可能的值：`id_token`、`code` 或 `token`。
response_mode	否	标识提供者在将结果发送回 Azure AD B2C 时使用的方法。可能的值：`query`、`form_post`（默认值）或 `fragment`。
scope	否	根据 OpenID Connect Core 1.0 规范定义的请求的范围。例如 `openid`、`profile` 和 `email`。
HttpBinding	否	预期的 HTTP 绑定，绑定到访问令牌和声明令牌终结点。可能的值：`GET` 或 `POST`。
ValidTokenIssuerPrefixes	否	一个密钥，可以在使用多租户标识提供者（例如 Microsoft Entra ID）时用于登录到每个租户。
UsePolicyInRedirectUri	否	指示在构造重定向 URI 时是否要使用策略。在标识提供者中配置应用程序时，需指定重定向 URI。重定向 URI 指向 Azure AD B2C `https://{your-tenant-name}.b2clogin.com/{your-tenant-name}.onmicrosoft.com/oauth2/authresp`。如果指定 `true`，需为每个使用的策略添加重定向 URI。例如：`https://{your-tenant-name}.b2clogin.com/{your-tenant-name}.onmicrosoft.com/{policy-name}/oauth2/authresp`。
MarkAsFailureOnStatusCode5xx	否	指示在 Http 状态代码处于 5xx 范围内的情况下，是否应将对外部服务的请求标记为失败。默认为 `false`。
DiscoverMetadataByTokenIssuer	否	指示是否应使用 JWT 令牌中的颁发者来发现 OIDC 元数据。如果需要基于颁发者生成元数据终结点 URL，请将此设置为 `true`。
IncludeClaimResolvingInClaimsHandling	否	对于输入和输出声明，指定声明解析是否包含在技术配置文件中。可能的值：`true` 或 `false`（默认值）。若要使用技术配置文件中的声明解析程序，请将此项设为 `true`。
token_endpoint_auth_method	否	指定 Azure AD B2C 如何向令牌终结点发送身份验证标头。可能的值：`client_secret_post`（默认值）和 `client_secret_basic`、`private_key_jwt`。有关详细信息，请参阅 OpenID Connect 客户端身份验证部分。
token_signing_algorithm	否	指定 `token_endpoint_auth_method` 设置为 `private_key_jwt` 时要使用的签名算法。可能的值：`RS256`（默认值）或 `RS512`。
SingleLogoutEnabled	否	指示在登录过程中技术配置文件是否尝试从联合标识提供者注销。有关详细信息，请参阅 Azure AD B2C 会话注销。可能的值：（默认）或 `false`。
ReadBodyClaimsOnIdpRedirect	否	设置为 `true` 可从标识提供者重定向的响应正文中读取声明。此元数据与 Apple ID 一起使用，其中声明返回到响应有效负载中。

<Metadata>
  <Item Key="ProviderName">https://login.live.com</Item>
  <Item Key="METADATA">https://login.live.com/.well-known/openid-configuration</Item>
  <Item Key="response_types">code</Item>
  <Item Key="response_mode">form_post</Item>
  <Item Key="scope">openid profile email</Item>
  <Item Key="HttpBinding">POST</Item>
  <Item Key="UsePolicyInRedirectUri">false</Item>
  <Item Key="client_id">Your Microsoft application client ID</Item>
</Metadata>

UI 元素

以下设置可用于配置失败时显示的错误消息。元数据应在 OpenID Connect 技术配置文件中进行配置。可以将错误消息本地化。

Attribute	必须	说明
UserMessageIfClaimsPrincipalDoesNotExist	否	在目录中找不到具有所提供用户名的帐户时要向用户显示的消息。
UserMessageIfInvalidPassword	否	密码不正确时要向用户显示的消息。
UserMessageIfOldPasswordUsed	否	使用旧密码时要向用户显示的消息。

加密密钥

CryptographicKeys 元素包含以下属性：

Attribute	必须	说明
client_secret	是	标识提供者应用程序的客户端机密。仅当 response_types 元数据设置为且 token_endpoint_auth_method 设置为或 `client_secret_basic` 时，才需要此加密密钥。在这种情况下，Azure AD B2C 会再次进行调用，以便用授权代码来交换访问令牌。如果元数据已设置为 `id_token`，则可省略加密密钥。
assertion_signing_key	是	将用于为客户端断言签名的 RSA 私钥。只有在将 token_endpoint_auth_method 元数据设置为的情况下，才需要此加密密钥。

重定向 URI

配置标识提供者的重定向 URI 时，请输入 https://{your-tenant-name}.b2clogin.com/{your-tenant-name}.onmicrosoft.com/oauth2/authresp。确保将 {your-tenant-name} 替换为你的租户名称。重定向 URI 需要采用全小写形式。

示例:

通过