分享此页面

# 步骤 7: 启用 SSO

先决条件: 步骤 6: 验证 IdP。

此步骤是启用 SSO。仅在成功验证了 IdP "alm" 之后才应执行此操作。启用 SSO 后, ALM SSO 身份验证完成, 您可以根据需要添加其他 IdP。

要启用 SSO, 请打开 SSO 配置工具右上角的“启用 SSO”开关。启用 SSO 身份验证后, 将无法禁用它。

## 常见问题

问: 在 ALM 15.0 中启用 SSO 后, 为什么无法通过 ALM 客户端启动器登录 ALM?

答: 根本原因: 使用了旧版本的 ALM 客户端启动器。

解决方案: 下载最新的 ALM 客户端启动器, 以便与 ALM 15.x SSO 解决方案一起使用。

https://marketplace.microfocus.com/appdelivery/content/alm-client-launcher

问: 为什么我未能验证 IdP "alm" 也可以单击“启用 SSO”按钮?

答: 如果您在步骤 1: 将 ALM 配置为 SP 中将“启用本地身份验证”设为“是”, 则 ALM 在 ALM 端对本地用户进行身份验证, 在 IdP 端对 IdP 用户进行身份验证。如果您是 ALM 本地用户, 则即使 IdP "alm" 未通过验证, ALM 仍允许您启用 SSO, 因为在这种情况下, 您仍然可以作为本地用户登录 ALM 来修复 IdP 配置, 以便 IdP 用户可以登录 ALM。

问: 如果某些问题导致 SSO 身份验证失败, 并且我无法打开 SSO 配置工具, 该怎么办?

答: 建议您启用本地身份验证, 以便在启用 SSO 之后, 本地用户仍可以登录 ALM 来解决 SSO 配置问题。

问: 启用 SSO 后, 是否会丢失我的本地帐户?

答: 从 15.0.1 开始, 启用 SSO 后, 所有用户都将通过 SSO 身份验证或本地身份验证进行身份验证。

启用 SSO 后, 本地帐户仍保留在 ALM 中。要获得身份验证, 每个本地帐户都应满足以下要求之一:

- 映射到 IdP 用户。
- 配置为 ALM 本地用户并启用本地身份验证。

问: 我可以绕过联合身份验证合作伙伴关系直接登录 ALM 吗?

答: ALM 15.0.1 及更高版本支持本地身份验证。启用本地身份验证后, 站点管理员可以通过将用户 IdP ID 指定为“本地”来将用户配置为 ALM 本地用户: 此类本地用户可以直接登录 ALM。

问: 启用 SSO 之后, 在启用 SSO 之前创建和访问的项目会怎样?

答: 对项目数据没有影响。SSO 身份验证仅更改用户管理。

问: 如果我已经使用 QC/ALM 多年, 是否仍可以访问与以前相同的资源?

答: 切换到 SSO 模式不会修改现有用户的用户名。他们仍然可以像在非 SSO 模式下运行 ALM 一样访问相同的资源。

他们只是映射到相应的 IdP 用户。USERS 表还有两列: US_IDENTITY_KEY 和 US_IDPID_NAME, 用于保留每个用户的用户映射信息。

问: 当我在 IdP 中获得身份验证后尝试访问 ALM 15.0 时, 为什么 Web 浏览器报告“431 请求标头字段太长”?

答: 当 ALM 15 在 SSO 模式下工作时, 一些额外的 IdP 会话和 SP 会话将附加到 HTTP 请求的 Cookie 中, 这使得请求标头的大小比在非 SSO 模式下运行 ALM 时要大得多。如果用户的反向代理或 ALM 将请求标头的大小限制为小于实际大小, 则会发生此问题。

要解决此问题, 请修改 ALM Jetty 设置以增大请求标头的大小。推荐大小: 81920。要了解有关如何配置 Jetty 连接器的 "requestHeaderSize" 的详细信息, 请参阅 Jetty 文档。

如果反向代理还限制了请求标头的大小, 则让网络管理员修改大小。

问: 如果启用 SSO 后 ALM 存储库文件夹发生更改, 如何手动修改 SSO 配置文件?

答: 要手动修改 SSO 配置文件, 请执行以下操作:

1. 在 `{安装文件夹}` 的 `qcConfigFile.properties` 文件中, 将 "repositoryPath" 的值更新为新的存储库文件夹。

2. 在 `{部署文件夹}/wrapper` 的 `wrapper.conf` 文件中, 将 "wrapper.java.additional.34" 的值更新为以下值:

   `wrapper.java.additional.34=-Dalm.osp.framework.generic-properties-filename="{新 ALM 存储库}/sa/DomsInfo/osp/basic.properties"`

3. 在 `{项目存储库文件夹}` 的 `basic.properties` 文件中, 将 "oauth-keystore.file" 的值更新为以下内容:

   `oauth-keystore.file={新 ALM 存储库}\\sa\\DomsInfo/osp/basic.pfx`

4. 在 `{项目存储库文件夹}` 的 `ospcfg.xml` 文件中, 将 name="propertiesFile" 的值更新为以下内容:

   `<NamedValue value="{新 ALM 存储库}\sa\DomsInfo/osp/alm.properties" name="propertiesFile"/>`

5. 在 SSO 配置工具中, 执行步骤 1: 将 ALM 配置为 SP、步骤 2: 配置默认 IdP 和步骤 3: 部署 SSO 组件。

备注: 有关如何更改 ALM 存储库的详细信息, 请参阅知识库文章。

问: 启用 SSO 后, 如果我使用 Chrome 或 Edge (版本 86 及更高版本) 登录 ALM, 我将重定向到 IdP 登录页面。登录 IdP 之后, Chrome 或 Edge 会继续让我在 ALM 和 IdP 之间重定向。

答: 在 Chrome 或 Edge 中更改安全设置:

1. 在 Chrome 中输入 "chrome://flags/", 或者在 Edge 中输入 "edge://flags/"。
2. 搜索关键字 "SameSite by default cookies"。

3. 对于 Chrome: 将“Cookies without SameSite must be secure”和“SameSite by default cookies”选项设置为“Disabled”。

   对于 Edge: 将“SameSite by default cookies”和“Schemeful Same-Site”选项设置为“Disabled”。

返回页首

接下来的步骤:

- (可选) 步骤 8: 添加其他 IdP

https://admhelp.microfocus.com ALM 8942
改进搜索结果的提示... ALM 帮助中心 ALM 帮助中心 ALM 帮助 16.00 全部查看本地帮助中心查看联机帮助中心后退在浏览器历史记录中后退前进在浏览器历史记录中前进删除突出显示的搜索项下一个主题转到下一个主题上一个主题转到上一个主题打印当前主题版本: