SAML 2.0身份验证处理程序

AEM随SAML身份验 证处理 程序一起提供。 此处理函数支持 使用 绑定的SAML 2.0身份验证请求协议(Web-SSO HTTP POST 用户档案)。

它支持：

  • 消息签名和加密
  • 自动创建用户
  • 将组同步到AEM中的现有组
  • 服务提供商和标识提供者启动的身份验证

此处理函数将加密的SAML响应消息存储在用户节点() usernode/samlResponse中，以便与第三方服务提供商进行通信。

注意

查 看AEM和SAML集成的演示。

要阅读端到端社区文章，请单击： 将SAML与Adobe Experience Manager集成。

配置SAML 2.0身份验证处理程序

Web控 制台 ，提供对称为Adobe Granite SAML 2.0身份验证处理程 序配置的访问权​。 可以设置以下属性。

注意

默认情况下，SAML 2.0身份验证处理程序处于禁用状态。 要启用该处理函数，必须至少设置以下属性之一：

  • 标识提供者POST URL。
  • 服务提供商实体ID。
注意

SAML声明已签名，并可以选择进行加密。 为使此工作正常，您必须至少在TrustStore中提供身份提供者的公共证书。 有关 详细信息，请参阅将IdP证书添加到 TrustStore部分。

路径 Sling应使用此身份验证处理程序的存储库路径。 如果此为空，则将禁用身份验证处理程序。

服务排名 OSGi框架服务排名值用于指示调用此服务的顺序。 这是一个整数值，其中值越高，表示优先级越高。

IDP证书别名 全局信任存储中IdP证书的别名。 如果此属性为空，则会禁用身份验证处理程序。 有关如何设置IdP证书，请参阅下面的“将IdP证书添加到AEM TrustStore”一章。

SAML身份验证 请求应发送到的IDP的标识提供者URL。 如果此属性为空，则会禁用身份验证处理程序。

注意

必须将标识提供者主机名添加 到Apache Sling推荐人过滤器 OSGi配置。 有关详细 信息，请参 阅Web控制台部分。

服务提供商实体 ID，它通过标识提供者唯一标识此服务提供商。 如果此属性为空，则会禁用身份验证处理程序。

默认重定向 ：成功验证后要重定向到的默认位置。

注意

此位置仅在未设置 request-path Cookie时使用。 如果您请求配置路径下的任何页面时没有有效的登录令牌，则请求的路径将存储在cookie中
并且，成功验证后，浏览器将再次重定向到此位置。

User-ID Attribute 包含用于在CRX存储库中验证和创建用户的用户ID的属性的名称。

注意

用户ID不会从SAML断言的节 saml:Subject 点中获取，而是从中获取 saml:Attribute。

使用加密 无论此身份验证处理程序是否需要加密的SAML声明。

自动创建CRX用户 成功验证后是否自动在存储库中创建非现有用户。

注意

如果禁用了CRX用户的自动创建，则用户必须手动创建。

添加到组 成功验证后是否应将用户自动添加到CRX组。

组成员 ：包含此用户应添加到的CRX组列表的saml：属性的名称。

将IdP证书添加到AEM TrustStore

SAML声明已签名，并可以选择进行加密。 要使此功能正常工作，您必须至少在存储库中提供IdP的公共证书。 为此，您需要：

  1. 转到 http:/serveraddress:serverport/libs/granite/security/content/truststore.html

  2. 按“创建 TrustStore”链接

  3. 输入TrustStore的口令，然后按“保 存”。

  4. 单击“管 理信任商店”。

  5. 上传IdP证书。

  6. 记下证书别名。 别名 为admin#1436172864930 ，如下例所示。

    chlimage_1-372

将服务提供商密钥和证书链添加到AEM密钥库

注意

以下步骤是必需的，否则将引发以下异常： com.adobe.granite.keystore.KeyStoreNotInitialisedException: Uninitialised system trust store

  1. 转到： http://localhost:4502/libs/granite/security/content/useradmin.html
  2. 编辑用 authentication-service 户。
  3. 单击“帐户设置” 下的“创建 KeyStore ”​创建KeyStore。
注意

仅当处理程序应能对消息进行签名或解密时，才需要以下步骤。

  1. 通过单击“选择私钥文件”, 上传私钥文件。 PKCS#8格式的密钥需要DER编码。

  2. 单击“选择证书链文 件”上载证书文件。

  3. 分配别名，如下所示：

    chlimage_1-373

为SAML配置记录器

您可以设置记录器以调试因错误配置SAML而可能出现的任何问题。 可通过以下方式执行此操作：

  1. 转到Web控制台，网址为 http://localhost:4502/system/console/configMgr

  2. 搜索并单击名为Apache Sling日志记录 器配置的条目

  3. 使用以下配置创建记录器：

    • 日志级别： 调试
    • 日志文件： logs/saml.log
    • 记录器： com.adobe.granite.auth.saml

在此页面上