跳到主要内容
版本:v2.9

配置 OpenLDAP

如果你的组织使用 LDAP 进行认证,则可以配置 Rancher 与 OpenLDAP 服务器通信以对用户进行认证。这时 Rancher 管理员可以对外部用户系统中的用户和组进行集群和项目的访问控制,同时允许终端用户在登录 Rancher UI 时使用其 LDAP 凭据进行身份认证。

先决条件

必须为 Rancher 配置 LDAP 绑定账号(即 ServiceAccount),来搜索和检索应该具有访问权限的用户和组的 LDAP 条目。建议不要使用管理员账号或个人账号,而应在 OpenLDAP 中创建一个专用账号,该账号对配置的搜索库下的用户和组需要具有只读权限(参见下文)。

使用 TLS?

如果 OpenLDAP 服务器使用的证书是自签名的或不是来自认可的证书颁发机构,请确保手头有 PEM 格式的 CA 证书(包含所有中间证书)。你必须在配置期间粘贴此证书,以便 Rancher 能够验证证书链。

在 Rancher 中配置 OpenLDAP

配置 OpenLDAP 服务器,组和用户的设置。有关填写每个字段的帮助,请参见配置参考

在开始之前,请熟悉外部认证配置和用户主体的概念。

  1. 在左上角,单击 ☰ > 用户 & 认证
  2. 在左侧导航栏,单击认证
  3. 单击 OpenLDAP。填写配置 OpenLDAP 服务器表单。
  4. 点击启用

测试认证

完成配置后,请测试与 OpenLDAP 服务器的连接。如果测试成功,则表明 OpenLDAP 认证已启用。

备注

于此步骤中输入的 OpenLDAP 用户凭证将映射到本地主体账号,并在 Rancher 中分配系统管理员权限。因此,你应该决定使用哪个 OpenLDAP 账号来执行此步骤。

  1. 输入应映射到本地主体账号的 OpenLDAP 账号的用户名密码
  2. 点击启用 OpenLDAP 认证来测试 OpenLDAP 的连接并完成设置。

结果

  • OpenLDAP 认证配置成功。
  • 与输入凭证对应的 LDAP 用户被映射到本地主体(管理员)账号。
备注

如果 LDAP 服务中断,你仍然可以使用本地配置的 admin 账号和密码登录。

附录:故障排除

如果在测试与 OpenLDAP 服务器的连接时遇到问题,请首先仔细检查为 ServiceAccount 输入的凭证以及搜索库配置。你还可以检查 Rancher 日志来查明问题的原因。调试日志可能包含有关错误的更详细信息。详情请参见如何启用调试日志