在 Azure Active Directory B2C 中使用 SAML 标识提供者设置注册和登录

Azure Active Directory B2C (Azure AD B2C) 支持使用 SAML 2.0 标识提供者进行联合身份验证。 本文介绍如何使用 SAML 标识提供者用户帐户登录,从而允许用户使用其现有的社交或企业标识(例如 ADFSSalesforce)登录。

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

此功能仅适用于自定义策略。 对于设置步骤,请选择上面的“自定义策略”。

方案概述

可以配置 Azure AD B2C,以允许用户使用外部社交或企业 SAML 标识提供者 (IdP) 提供的凭据登录到你的应用程序。 当 Azure AD B2C 使用 SAML 标识提供者进行联合身份验证时,它将充当向 SAML 标识提供者发起 SAML 请求并等待 SAML 响应的服务提供商。 在下图中:

  1. 应用程序向 Azure AD B2C 发起授权请求。 应用程序可以是 OAuth 2.0OpenId Connect 应用程序,也可以是 SAML 服务提供者
  2. 在 Azure AD B2C 登录页上,用户选择使用 SAML 标识提供者帐户(例如 Contoso)登录。 Azure AD B2C 发起 SAML 授权请求,并将用户转到 SAML 标识提供者以完成登录。
  3. SAML 标识提供者返回 SAML 响应。
  4. Azure AD B2C 验证 SAML 令牌、提取声明,颁发其自己的令牌,并使用户返回到应用程序。

使用 SAML 标识提供者流登录

先决条件

解决方案组件

此方案需要以下组件:

  • SAML 标识提供者能够接收、解码和响应来自 Azure AD B2C 的 SAML 请求。
  • 标识提供者公开可用的 SAML 元数据终结点。
  • Azure AD B2C 租户

创建策略密钥

若要在 Azure AD B2C 与 SAML 标识提供者之间建立信任,你需要提供带有私钥的有效 X509 证书。 Azure AD B2C 使用证书的私钥对 SAML 请求进行签名。 标识提供者使用证书的公钥验证请求。 通过技术配置文件元数据可访问公钥。 或者,可以将 .cer 文件手动上传到 SAML 身份提供程序。

在大多数情况下,自签名证书都是可接受的。 对于生产环境,建议使用由证书颁发机构颁发的 X509 证书。 此外,如本文档后面所述,对于非生产环境,你可以禁用两端的 SAML 签名。

获得证书

如果你还没有证书,则可以使用自签名证书。 自签名证书是未由证书颁发机构 (CA) 签署的安全证书,不提供由 CA 签名的证书的安全保障。

在 Windows 上,可使用 PowerShell 的 New-SelfSignedCertificate cmdlet 来生成证书。

  1. 执行此 PowerShell 命令来生成自签名证书。 根据应用程序的需要修改 -Subject 参数,并修改 Azure AD B2C 租户名称。 还可调整 -NotAfter 日期,为证书指定不同的过期日期。

    New-SelfSignedCertificate `
        -KeyExportPolicy Exportable `
        -Subject "CN=yourappname.yourtenant.partner.onmschina.cn" `
        -KeyAlgorithm RSA `
        -KeyLength 2048 `
        -KeyUsage DigitalSignature `
        -NotAfter (Get-Date).AddMonths(12) `
        -CertStoreLocation "Cert:\CurrentUser\My"
    
  2. 打开“管理用户证书” > “当前用户” > “个人” > “证书” > “yourappname.yourtenant.partner.onmschina.cn” 。

  3. 选择该证书,然后依次选择“操作” > “所有任务” > “导出”。

  4. 选择“是” > “下一步” > “是,导出私钥” > “下一步” 。

  5. 接受“导出文件格式”的默认值。

  6. 提供证书的密码。

要让 Azure AD B2C 接受 .pfx 文件密码,必须在 Windows 证书存储导出实用工具中使用 TripleDES-SHA1 选项,而不是 AES256-SHA256 对此密码进行加密。

上传证书

需要将你的证书存储在 Azure AD B2C 租户中。

  1. 登录 Azure 门户
  2. 请确保使用的是包含 Azure AD B2C 租户的目录。 选择顶部菜单中的“目录 + 订阅”筛选器,然后选择包含租户的目录。
  3. 选择 Azure 门户左上角的“所有服务”,然后搜索并选择“Azure AD B2C” 。
  4. 在“概述”页上选择“标识体验框架”。
  5. 选择“策略密钥”,然后选择“添加”。
  6. 对于“选项”,请选择 Upload
  7. 输入策略密钥的 名称。 例如,SAMLSigningCert。 前缀 B2C_1A_ 会自动添加到密钥名称。
  8. 浏览并选择带有私钥的证书 .pfx 文件。
  9. 单击“创建”。

配置 SAML 技术配置文件

通过在策略的扩展文件中将 SAML 标识提供者添加到 ClaimsProviders 元素来定义该标识提供者。 声明提供程序包含用于确定与 SAML 标识提供者通信所需的终结点和协议的 SAML 技术配置文件。 若要添加包含 SAML 技术配置文件的声明提供程序,请执行以下操作:

  1. 打开 TrustFrameworkExtensions.xml

  2. 找到 ClaimsProviders 元素。 如果该元素不存在,请在根元素下添加它。

  3. 如下所示添加新的 ClaimsProvider

    <ClaimsProvider>
      <Domain>Contoso.com</Domain>
      <DisplayName>Contoso</DisplayName>
      <TechnicalProfiles>
        <TechnicalProfile Id="Contoso-SAML2">
          <DisplayName>Contoso</DisplayName>
          <Description>Login with your SAML identity provider account</Description>
          <Protocol Name="SAML2"/>
          <Metadata>
            <Item Key="PartnerEntity">https://your-AD-FS-domain/federationmetadata/2007-06/federationmetadata.xml</Item>
          </Metadata>
          <CryptographicKeys>
            <Key Id="SamlMessageSigning" StorageReferenceId="B2C_1A_SAMLSigningCert"/>
          </CryptographicKeys>
          <OutputClaims>
            <OutputClaim ClaimTypeReferenceId="issuerUserId" PartnerClaimType="assertionSubjectName" />
            <OutputClaim ClaimTypeReferenceId="givenName" PartnerClaimType="first_name" />
            <OutputClaim ClaimTypeReferenceId="surname" PartnerClaimType="last_name" />
            <OutputClaim ClaimTypeReferenceId="displayName" PartnerClaimType="http://schemas.microsoft.com/identity/claims/displayname" />
            <OutputClaim ClaimTypeReferenceId="email"  />
            <OutputClaim ClaimTypeReferenceId="identityProvider" DefaultValue="contoso.com" />
            <OutputClaim ClaimTypeReferenceId="authenticationSource" DefaultValue="socialIdpAuthentication" />
          </OutputClaims>
          <OutputClaimsTransformations>
            <OutputClaimsTransformation ReferenceId="CreateRandomUPNUserName"/>
            <OutputClaimsTransformation ReferenceId="CreateUserPrincipalName"/>
            <OutputClaimsTransformation ReferenceId="CreateAlternativeSecurityId"/>
            <OutputClaimsTransformation ReferenceId="CreateSubjectClaimFromAlternativeSecurityId"/>
          </OutputClaimsTransformations>
          <UseTechnicalProfileForSessionManagement ReferenceId="SM-Saml-idp"/>
        </TechnicalProfile>
      </TechnicalProfiles>
    </ClaimsProvider>
    

使用以下相关值更新以下 XML 元素:

XML 元素 “值”
ClaimsProvider\Domain 用于直接登录的域名。 输入要在直接登录中使用的域名。 例如,Contoso.com。
TechnicalProfile\DisplayName 此值会显示在登录屏幕中的登录按钮上。 例如,Contoso。
Metadata\PartnerEntity SAML 身份提供程序的元数据的 URL。 或者可以复制标识提供者元数据并将其添加到 CDATA 元素 <![CDATA[Your IDP metadata]]>

映射声明

OutputClaims 元素包含 SAML 标识提供者返回的声明列表。 将策略中定义的声明名称映射到标识提供者中定义的断言名称。 检查标识提供者以获取声明(断言)的列表。 有关详细信息,请参阅声明映射

在上面的示例中,Contoso-SAML2 包括 SAML 标识提供者返回的声明:

  • issuerUserId 声明映射到 assertionSubjectName 声明。
  • first_name 声明已映射到 givenName 声明。
  • last_name 声明已映射到 surname 声明。
  • displayName 声明已映射到 http://schemas.microsoft.com/identity/claims/displayname 声明。
  • 没有名称映射的 email 声明。

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

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

添加 SAML 会话技术配置文件

如果还没有 SM-Saml-idp SAML 会话技术配置文件,请在扩展策略中添加一个。 找到 <ClaimsProviders> 部分并添加以下 XML 片段。 如果策略已包含 SM-Saml-idp 技术配置文件,请跳到下一步。 有关详细信息,请参阅单一登录会话管理

<ClaimsProvider>
  <DisplayName>Session Management</DisplayName>
  <TechnicalProfiles>
    <TechnicalProfile Id="SM-Saml-idp">
      <DisplayName>Session Management Provider</DisplayName>
      <Protocol Name="Proprietary" Handler="Web.TPEngine.SSO.SamlSSOSessionProvider, Web.TPEngine, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" />
      <Metadata>
        <Item Key="IncludeSessionIndex">false</Item>
        <Item Key="RegisterServiceProviders">false</Item>
      </Metadata>
    </TechnicalProfile>
  </TechnicalProfiles>
</ClaimsProvider>

添加用户旅程

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

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

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

拥有用户旅程后,将新标识提供者添加到用户旅程。 首先添加登录按钮,然后将按钮链接到操作。 该操作是前面创建的技术配置文件。

  1. 在用户旅程中,查找包含 Type="CombinedSignInAndSignUp"Type="ClaimsProviderSelection" 的业务流程步骤元素。 这通常是第一个业务流程步骤。 ClaimsProviderSelections 元素包含用户可以用来登录的标识提供者列表。 元素的顺序控制向用户呈现的登录按钮顺序。 添加 ClaimsProviderSelection XML 元素。 将 TargetClaimsExchangeId 的值设置为易记名称。

  2. 在下一个业务流程步骤中,添加 ClaimsExchange 元素。 将 ID 设置为 TargetClaimsExchangeId 的值。将 TechnicalProfileReferenceId 的值更新为先前创建的技术配置文件的 ID 。

下面的 XML 显示使用标识提供者的用户旅程的前两个业务流程步骤:

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

<OrchestrationStep Order="2" Type="ClaimsExchange">
  ...
  <ClaimsExchanges>
    <ClaimsExchange Id="ContosoExchange" TechnicalProfileReferenceId="Contoso-SAML2" />
  </ClaimsExchanges>
</OrchestrationStep>

配置信赖方策略

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

在以下示例中,对于 CustomSignUpOrSignIn 用户旅程,将 ReferenceId 设置为 CustomSignUpOrSignIn

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

上传自定义策略

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

配置 SAML 标识提供者

配置策略后,需要使用 Azure AD B2C SAML 元数据配置 SAML 标识提供者。 SAML 元数据是 SAML 协议中用于公开策略(例如服务提供商)的配置的信息。 它定义服务的位置,例如登录和注销、证书、登录方法和其他信息。

每个 SAML 标识提供者都有不同的步骤来设置服务提供商。 一些 SAML 标识提供者请求 Azure AD B2C 元数据,而另一些则要求你手动浏览元数据文件并提供信息。 有关指导,请参阅标识提供者的文档。

以下示例显示 Azure AD B2C 技术配置文件的 SAML 元数据的 URL 地址:

https://<your-tenant-name>.b2clogin.cn/<your-tenant-name>.partner.onmschina.cn/<your-policy>/samlp/metadata?idptp=<your-technical-profile>

请替换以下值:

  • 将 your-tenant-name 替换为你的租户名称,例如 your-tenant.partner.onmschina.cn。
  • 将 your-domain-name 替换为你的自定义域名,例如 login.contoso.com。
  • 将 your-policy 替换为你的策略名称。 例如,B2C_1A_signup_signin_adfs。
  • 将 your-technical-profile 替换为 SAML 标识提供者技术配置文件的名称。 例如,Contoso-SAML2。

打开浏览器并导航到此 URL。 确保键入正确的 URL 并且你有权访问 XML 元数据文件。

测试自定义策略

  1. 登录 Azure 门户
  2. 在门户工具栏中选择“目录 + 订阅”图标,然后选择包含 Azure AD B2C 租户的目录。
  3. 在 Azure 门户中,搜索并选择“Azure AD B2C” 。
  4. 在“策略”下,选择“Identity Experience Framework”
  5. 选择信赖方策略,例如 B2C_1A_signup_signin
  6. 对于“应用程序”,请选择前面注册的 Web 应用程序。 “回复 URL”应显示为 https://jwt.ms
  7. 选择“立即运行”按钮。
  8. 在注册或登录页面上,选择“Contoso”以使用 Contoso 帐户登录。

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

后续步骤