集成openldap与kerberos实现统一认证（二）：基于sssd同步ldap账号-金马国际

1. 写作背景

写作本系列文章的背景是我们要在大数据平台/企业数据湖场景下给出中心化的用户身份认证方案。此前，我们实现过 windows ad kerberos 的集成方案，由于 windows ad 是 ldap 和 kerberos 的双重实现，这种天然优势使得 windows ad 可以实现真正意义上的（大数据集群的）kerberos 账号与企业用户账号的统一管理。当我们想在 openldap kerberos 上实现同样的目标时，发现这一领域的知识与方案琐碎而凌乱，缺少统一连贯，脉络清晰的讲解，在经过大量技术调研和系统梳理后，我们特别撰写了本系列文章，希望可以借此将这一话题全面彻底地阐述清楚。

本系列由三篇文章组成，将沿着“如何集成 openldap 与 kerberos 实现统一认证管理”这一主线推进，在实现过程中会详细介绍使用到的技术和原理并给出完备的执行脚本用于实际环境的搭建。我们假设读者已经具备 openldap 和 kerberos 的基本知识，不再对两者进行单独介绍。此外，本系列文章写作期间正值 2022 年 4 月-5 月上海疫情最严重的时期，特以此文纪念这段艰难的特殊时光。

2. 既定目标

在上一篇文章中，我们安装了 openldap 并将 kerberos 的后台数据库迁移到了 openldap 上，实现了两系统用户数据的统一存储。本文将展开第二阶段的集成工作，即此前在技术方案（路线图）中介绍的第③和第④步：

图 1: openldap 与 kerberos 集成方案

这两步操作将在 linux 主机上启用 sssd，用户通过 ssh 登录大数据集群各个节点时，将会通过 sssd 转到 openldap 进行身份认证。

对于大数据集群来说，③④两步操作的主要意义并不在于可以让用户登录 linux，而在于：当我们向 yarn 提交作业时，yarn 会要求执行作业的各 worker 节点上能找到提交作业的 linux 用户，因此，我们需要架设一条通道将 openldap 账号同步到各个 linux 主机上，这个通道就是 sssd。

3. 工作原理

本文操作的主要对象是 sssd（system security services dameon，金马国际官网地址：），它是一个工作在 linux 系统上与 ldap/ad 对接进行身份认证和账号缓存的服务，与直接同 ldap 对接相比，sssd 有如下一些优点：

• 支持离线认证：当本地主机与 ldap 服务器断网的情况下，用户依然可以登录

• 减轻 ldap 服务器的负载：通过 sssd，一台 linux 主机仅与 ldap 服务器建立一个连接

• 支持多个 ldap/ad：通过 sssd，可以同时配置多个 ldap/ad 作为认证源

4. 安装操作

※ 提示：本文所有命令均以 root 用户身份执行，不再显式使用 sudo 修饰。

4.1 创建 sssd 的 bind dn

※ 提示：本节操作在 [ openldap ] 上执行

由于 sssd 需要登录 openldap 检索账号，所以需要为其在 openldap 上创建一个专职账号：cn=sssd,ou=services,dc=example,dc=com，操作命令如下：

cat << eof | ldapadd -d "cn=admin,dc=example,dc=com" -w admin1234!dn: cn=sssd,ou=services,dc=example,dc=comsn: sssdcn: sssdobjectclass: topobjectclass: personuserpassword: admin1234!eof

备注： 这是本文唯一一处需要在 openldap 上执行的操作，后续所有操作均在大数据集群各个节点上执行。

4.2 安装软件包

※ 提示：本节操作在 [ 大数据集群各个节点 ] 上执行

使用如下命令安装必要的软件包：

yum -y install openldap-clients sssd sssd-client sssd-ldap sssd-tools authconfig nss-pam-ldapd oddjob-mkhomedir

4.3 使用 authconfig 配置 sssd

※ 提示：本节操作在 [ 大数据集群各个节点 ] 上执行

authconfig 是 linux 系统上一个对各种认证资源进行统一配置的工具，我们将通过它完成一部分的 sssd 配置，命令如下：

authconfig --enablesssd --enablesssdauth --enablemkhomedir --enablerfc2307bis --enableldap --enableldapauth --disableldaptls --disableforcelegacy --disablekrb5 --ldapserver ldap://ip-10-0-0-70.cn-north-1.compute.internal --ldapbasedn "dc=example,dc=com" --updateall

关于这条命令，大部分选项都可以直接从名称上了解其作用，需要特别解释的是下面几个配置项：

• --disableforcelegacy

--disableforcelegacy 其实是默认值，不显式配置也会生效，和它对应的是--enableforcelegacy 选项。官方文档对这两个选项的解释并不够细致，它们是为兼容某些旧式服务（例如一些很旧的 openldap 版本）而设计的，但其实这两个选项对配置的影响非常大，最大的区别在于：

1. 如果使用--disableforcelegacy，则启动的是 sssd 进程，并且会自动创建并使用/etc/sssd/sssd.conf 文件

2. 如果使用--enableforcelegacy，则启动的是 nslcd 进程，不会创建和使用/etc/sssd/sssd.conf 文件，命令行中的若干配置项会更新到/etc/nslcd.conf，/etc/pam.d/system-auth 和/etc/pam.d/password-auth 等文件中

总之，在安装新环境时，建议首选--disableforcelegacy，它会让 authconfig 将配置（特别是 ldap 相关的）信息写到/etc/sssd/sssd.conf 文件的[domain/default]中，如该 sssd.conf 文件不存在，authconfig 还会自动创建该文件。

• --updateall

该选项的作用是将命令行中的各项配置更新到对应服务的配置文件中，与之类似的是--update 参数，它们的区别在于--updateall 会更新全部配置。我们建议大家使用--updateall 而不是--update，因为这样可以保证始终以 authconfig 命令给出的配置为准，避免手动修改一些配置文件。网上有很多文章告诉读者在使用了 authconfig 命令后还要再去修改/etc/pam.d/system-auth 和/etc/pam.d/password-auth 等文件，都是因为没有使用--updateall 导致的，这种做法不能说有错，但确实是有隐患的。典型的例子是：这些文章会要求读者手动修改/etc/pam.d/system-auth 和/etc/pam.d/password-auth 两个文件中与 pam_sss.so 和 pam_ldap.so 有关的 4 个配置项，但其实这些配置会有很大概率在下次执行 authconfig 命令时被覆盖掉。

正确控制 pam_sss.so 和 pam_ldap.so 相关配置项的做法是：在每次执行 authconfig 时，总是使用--enableforcelegacy 和--updateall 两个选项，通过 enable 或 disable ldapauth 与 sssdauth 可以精确控制与 pam_sss.so 和 pam_ldap.so 有关的四项配置，具体逻辑是：

--enableldapauth：将会在/etc/pam.d/system-auth 和/etc/pam.d/password-auth 追加 pam_ldap.so 相关的 4 项配置--disableldapauth：将会在/etc/pam.d/system-auth 和/etc/pam.d/password-auth 移除 pam_ldap.so 相关的 4 项配置--enablesssdauth：将会在/etc/pam.d/system-auth 和/etc/pam.d/password-auth 追加 pam_sss.so 相关的 4 项配置--disablesssdauth：将会在/etc/pam.d/system-auth 和/etc/pam.d/password-auth 移除 pam_sss.so 相关的 4 项配置

再次提醒一下，以上情形只在启用了--enableforcelegacy 和--updateall 的前提下才有效。由于我们使用了--disableforcelegacy，所以不必手动修改/etc/pam.d/system-auth 和/etc/pam.d/password-auth 两个文件，只需要简单执行上面的 authconfig 命令即可。authconfig 命令执行完毕后，可以通过下面的命令查看一下当前配置，从输出的信息可以判断出哪些认证模块被启用哪些没有：

authconfig --test

备注：针对 centos 8，应该使用 authselect 替换 authconfig 进行配置，本文使用的演示环境不支持 authselect，故不再单独介绍。

4.4 其他必要配置项

※ 提示：本节操作在 [ 大数据集群各个节点 ] 上执行

尽管 authconfig 命令配合--disableforcelegacy 选项可以自动生成/etc/sssd/sssd.conf 文件，但是 authconfig 还是不能涵盖 sssd.conf 中的所有配置，以下几项配置无法通过 authconfig 参数设置，但必须要在 sssd.conf 中提供：

ldap_default_bind_dn = cn=sssd,ou=services,dc=example,dc=comldap_default_authtok_type = passwordldap_default_authtok = admin1234!

ldap_default_bind_dn 用于指定 sssd 的 bind dn，我们已经在第一步先行创建好了这个 dn，如果想简化操作，可以直接使用 admin。ldap_default_authtok_type 用于指明定 bind dn 的认证方式，这里使用的是密码认证，ldap_default_authtok 是用来配置 bind dn 的密码。此外，还有一些与 ldap 有关的配置项是用于账号检索的，它们是：

ldap_user_object_class = posixaccountldap_user_name = uidldap_user_uid_number = uidnumber

上述三项给出的值本身就是这些配置项的默认值，所以并不需要显式配置，这些默认值适用于绝大多数情况，仅当 sssd 同步不到你想要的账号时，才可能需要适当修改一下相应的值。

接下来两项是用户登录后与环境有关的配置项：

override_homedir = /home/%udefault_shell = /bin/bash

“override_homedir = /home/%u”用于配置 ldap 用户登录 linux 后的 home 目录，当用户初次登录时，系统会根据这里的配置为用户创建 home 目录，其中 %u 表示用户名。自动创建 home 目录的功能是通过安装 oddjob-mkhomedir 实现的，这个安装包中有一个名为 pam_oddjob_mkhomedir.so 的库，authconfig 命令就是利用这个库创建 home 目录的。

“default_shell = /bin/bash”用于配置同步的 ldap 用户在 linux 下的默认 shell，这里我们统一使用 bash shell。

此外，如果配置过程中出现错误，详细的日志信息对排查错误非常重要，此时，可以通过以下的配置项提升日志输出的详细度：

debug_level = 9

最后，我们可以使用如下命令，将 authconfig 生成的内容与需要额外添加的内容合并，生成一份完整的配置：

tee /etc/sssd/sssd.conf<[sssd]services = nss, pam, autofsdomains = default
[domain/default]autofs_provider = ldapldap_schema = rfc2307biskrb5_realm = cn-north-1.compute.internalldap_search_base = dc=example,dc=comkrb5_server = ip-10-0-1-90.cn-north-1.compute.internal:88id_provider = ldapauth_provider = ldapchpass_provider = ldapldap_uri = ldap://ip-10-0-0-70.cn-north-1.compute.internalldap_id_use_start_tls = falsecache_credentials = trueldap_tls_reqcert = neverldap_tls_cacertdir = /etc/openldap/cacertsldap_default_bind_dn = cn=sssd,ou=services,dc=example,dc=comldap_default_authtok_type = passwordldap_default_authtok = admin1234!override_homedir = /home/%udefault_shell = /bin/bash
[nss]homedir_substring = /home
[pam]
[autofs]eof
chmod 600 /etc/sssd/sssd.conf 

关于更多 sssd.conf 文件的配置项可参考：


4.5 配置 ssh

※ 提示：本节操作在 [ 大数据集群各个节点 ] 上执行

如果允许 sssd 同步的用户 ssh 登录服务器，需要对 ssh 做一些必要配置，具体操作是打开/etc/ssh/sshd_config 文件，将“usepam no”和“passwordauthentication no”注释掉（如果有的话），并设置“usepam yes”和“passwordauthentication yes”：

#usepam nousepam yes#passwordauthentication nopasswordauthentication yes

或执行如下脚本：

cp -f /etc/ssh/sshd_config /etc/ssh/sshd_config.$(date  %s)
items=(usepam passwordauthentication)
for item in ${items[@]}; do    searchexp="^\s*[#]\?\s*${item}\s*\(yes\|no\)$"    # 所有待删除的行号    linenums=($(grep -n -e "$searchexp" /etc/ssh/sshd_config | cut -d: -f1))    # 生成sed行表达式    printf -v linesexp "%sd;" "${linenums[@]}"    # 删除所有行    sed -i -e "$linesexp" /etc/ssh/sshd_config    # 在原第一行处插入新配置（为了保持配置项出现在合适的位置）    sed "${linenums[0]}i ${item} yes" -i /etc/ssh/sshd_configdone

4.6 重启服务

※ 提示：本节操作在 [ 大数据集群各个节点 ] 上执行

完成上述所有操作后，需要激活并重启以下服务：

systemctl enable sssd oddjobdsystemctl restart sssd oddjobd sshdsystemctl status sssd oddjobd sshd

4.7 登录验证

※ 提示：本节操作在 [ 大数据集群各个节点 ] 上执行

服务重启后，ldap 的账号数据就可以经 sssd 同步至本地 linux 主机了，以“user1”用户为例，可以使用命令：

id user1

如果命令打印出了 user1 的相关信息，则表示 sssd 已经可以和 openldap 正常通信了，同时也可以切换到 user1 用户上验证：

su -l user1

最后，就是使用 ssh 进行登录验证了，读者可以使用自己熟悉的 ssh 客户端工具以user1为用户名，以admin1234!为密码进行 ssh 登录验证。至此，我们已经完成本文的预定目标，实现了集成方案示意图中的第③、④两步。

附录：常见错误

当遇到配置无效或配置中出现错误的时候，可以重点留意如下日志文件中的错误信息：

/var/log/secure/var/log/sssd/sssd_default.log

以下是一些常见的错误和处理方法：

• 启动 sssd 服务时报错：sssd couldn't load the configuration database [2]: no such file or directory.

原因：/etc/sssd/sssd.conf 文件不存在。可以使用 authconfig 命令配合--disableforcelegacy 选项自动生成 sssd.conf 文件

• ssh 登录时报错：pam_sss(sshd:auth): received for user ...: 6 (permission denied)

原因：如果 openldap 没有启用 tls，则必须要在 sssd.conf 文件中显式地配置ldap_tls_reqcert = never


• /var/log/sssd/sssd_default.log 文件报错：user [xxx] filtered out! (primary gid out of range)

原因是在 ldap 中查看用户的 gid 是 0，这是使用 ldapadmin 创建用户时，不选 group 时自动赋予的值，由于 0 是 root group 的 gid，不在允许的 gid 范围内。解决方法明确设置一个合理值，例如大于 1000 的随机值，或者取一个实际存在的 gid。

• 用户登录后不能创建 home 目录

如果在 authconfig 中使用了--enablemkhomedir，是会创建 home 目录的，但如果没有在/etc/sssd/sssd.conf 中显式地配置 override_homedir，默认的 home 目录其实是在根目录下。所以，要同时保证启用了--enablemkhomedir，并在/etc/sssd/sssd.conf 中配置了：

override_homedir = /home/%u

作者介绍：

耿立超，架构师，多年系统开发与架构经验，对大数据、云计算、企业级应用、saas、分布式存储和领域驱动设计有丰富的实践经验，著有 《大数据平台架构与原型实现：数据中台建设实战》（）一书，个人技术博客：


关联阅读：

集成openldap与kerberos实现统一认证(一)：整合后台数据库


集成 openldap 与 kerberos 实现统一认证(二)：基于 sssd 同步 ldap 账号（本文）

集成openldap与kerberos实现统一认证(三)：基于sasl/gssapi深度集成


参考资料：

sssd.conf(5) - linux man page


sssd.conf(5) - linux man page (ldap part)


red hat enterprise linux 6 - use of authconfig parameter forcelegacy:


understanding system security services daemon (sssd)


configuring sssd to use ldap and require tls authentication


simple steps to configure ldaps with tls certificates centos 7 linux


simple steps to configure ldap client rhel/centos 8