管理 IdM 中的证书
发布证书、配置基于证书的身份验证和控制证书的有效性
摘要
certmonger
服务、certutil
工具或 Ansible Playbook 来请求和更新证书。要替换 IdM 服务器的 Web 服务器和 LDAP 服务器证书,您必须执行手动操作。
对红帽文档提供反馈
我们感谢您对我们文档的反馈。让我们了解如何改进它。
通过 Jira 提交反馈(需要帐户)
- 登录到 Jira 网站。
- 单击顶部导航栏中的 Create。
- 在 Summary 字段中输入描述性标题。
- 在 Description 字段中输入您对改进的建议。包括文档相关部分的链接。
- 点对话框底部的 Create。
第 1 章 身份管理中的公钥证书
X.509 公钥证书用于验证身份管理(IdM)中的用户、主机和服务。除了验证外,X.509 证书还支持启用数字签名和加密,以提供隐私性、完整性和不可抵赖性。
证书包含以下信息:
- 证书验证的主题。
- 签发者,即签署证书的 CA。
- 证书有效性的开始和结束日期。
- 证书的有效使用。
- 主题的公钥。
由公钥加密的消息只能由对应的私钥解密。虽然证书及其包含的公钥可以公开提供,但用户、主机或服务必须对其私钥保密。
1.1. IdM 中的证书颁发机构
证书颁发机构以信任层次结构运行。在带有内部证书颁发机构(CA)的 IdM 环境中,所有 IdM 主机、用户和服务都信任 CA 签名的证书。除了这个根 CA 外,IdM 还支持子 CA,其 root CA 已授权依次获得签署证书的能力。通常,此类能够签名的子 CA 证书是特定类型的证书,如 VPN 证书。最后,IdM 支持使用外部 CA。下 表显示了在 IdM 中使用各个 CA 类型的详情。
CA 的名称 | 描述 | 使用 | 有用的链接 |
---|---|---|---|
| 基于 Dogtag 上游项目的集成 CA | 集成的 CA 可以为用户、主机和服务创建、撤销和发布证书。 | |
IdM 子 CA |
隶属于 |
IdM 子 CA 是 | |
外部 CA | 外部 CA 是集成 IdM CA 或其子 CA 以外的 CA。 | 使用 IdM 工具,您可以将这些 CA 发布的证书添加到用户、服务或主机,也可以删除它们。 |
从证书的角度来看,自签名的 IdM CA 签名的和外部签名的证书之间没有区别。
CA 的角色包括以下目的:
- 它发布数字证书。
- 通过签署证书,它证明证书中命名的对象拥有一个公钥。主题可以是用户、主机或服务。
- 它可以撤销证书,并通过证书撤销列表(CRL)和在线证书状态协议(OCSP)提供撤销状态。
其它资源
1.2. 证书和 Kerberos 的比较
证书执行的功能与 Kerberos 票据执行的功能类似。Kerberos 是一种计算机网络身份验证协议,它根据票据来允许节点通过非安全网络进行通信,从而以安全的方式证明它们相互的身份。下表显示了 Kerberos 和 X.509 证书的比较:
特性 | Kerberos | X.509 |
| 是 | 是 |
| 可选 | 是 |
| 可选 | 是 |
| 对称 | 非对称 |
| 短(1 天) | 长(2 年) |
默认情况下,身份管理中的 Kerberos 仅确保通信双方的身份。
1.3. 使用证书验证 IdM 中用户的优缺点
使用证书验证 IdM 中用户的优点包括:
- 与常规密码相比,保护智能卡上私钥的 PIN 通常不复杂、更容易记住。
- 根据设备,无法导出保存在智能卡上的私钥。这提供了额外的安全性。
- 智能卡可以自动注销: IdM 可以配置为在用户从读卡器中删除智能卡时注销用户。
- 窃取私钥需要对智能卡的实际访问,从而使智能卡免受黑客攻击。
- 智能卡验证是一个双因素验证的示例:它需要您拥有的东西(卡)和您知道的东西(PIN)。
- 智能卡比密码更灵活,因为它们提供可用于其他用途的密钥,如加密电子邮件。
- 在作为 IdM 客户端的共享机器上使用智能卡不会给系统管理员带来额外的配置问题。事实上,智能卡验证对共享机器来说是一个理想选择。
使用证书验证 IdM 中用户的缺点包括:
- 用户可能丢失或忘记携带其智能卡或证书,并被有效锁住。
- 错误输入 PIN 多次可能会导致卡被锁。
- 通常,在请求与某些安全官员或批准人的授权之间有一个中间步骤。在 IdM 中,安全官员或管理员必须运行 ipa cert-request 命令。
- 智能卡和读卡器往往特定于供应商和驱动程序:虽然许多读卡器可用于不同的卡,但特定供应商的智能卡可能无法在另一供应商的读卡器或不是为其设计的读卡器类型中工作。
- 证书和智能卡对管理员来说有一个很陡的学习曲线。
第 2 章 使用集成的 IdM CA 为用户、主机和服务管理证书
要了解更多有关如何使用集成的 CA、ipa
CA 及其子 CA 在身份管理(IdM)中管理证书的信息,请参阅以下部分:
- 使用 IdM Web UI 为用户、主机或服务重新请求新证书。
使用 IdM CLI 从 IdM CA 中为用户、主机或服务请求新证书:
使用 certutil 从 IdM CA 中为用户、主机或服务请求新证书
-
有关使用
certutil
工具从 IdM CA 中请求新用户证书并将其导出到 IdM 客户端的具体示例,请参阅 请求新用户证书并将其导出到客户端。
-
有关使用
- 使用 openssl 从 IdM CA 中为用户、主机或服务请求新证书
您还可以使用 certmonger
工具从 IdM CA 中为服务请求新证书。如需更多信息,请参阅 使用 certmonger 从 IdM CA 中为服务请求新证书。
先决条件
您的 IdM 部署包含一个集成 CA:
- 有关如何在 IdM 中规划您的 CA 服务的详情,请参考 规划您的 CA 服务。
- 有关如何安装带有集成 DNS 和集成 CA 作为根 CA 的 IdM 服务器的详情,请参考 安装 IdM 服务器:带有集成 DNS,带有集成 CA 作为根 CA
- 有关如何安装带有集成 DNS 和外部 CA 作为根 CA 的 IdM 服务器的详情,请参考 安装 IdM 服务器:带有集成 DNS,带有外部 CA 作为根 CA
- 有关如何安装没有集成 DNS 且集成 CA 作为根 CA 的 IdM 服务器的详情,请参考 安装 IdM 服务器:没有集成 DNS,集成 CA 作为根 CA。
可选:您的 IdM 部署支持使用证书进行身份验证的用户:
- 有关如何配置 IdM 部署以支持使用存储在 IdM 客户端文件系统中的证书进行用户身份验证的详情,请参考 使用存储在 IdM 客户端桌面上的证书配置身份验证。
- 有关如何配置 IdM 部署以支持使用存储在插入 IdM 客户端的智能卡中的证书进行用户身份验证的详情,请参考 为智能卡身份验证配置身份管理。
- 有关如何配置 IdM 部署以支持使用由活动目录证书系统发布的智能卡进行用户身份验证的详情,请参考 为 IdM 中的智能卡身份验证配置由 ADCS 发布的证书。
2.1. 使用 IdM Web UI 为用户、主机或服务请求新证书
按照以下流程,使用身份管理(IdM) Web UI 为集成 IdM 证书颁发机构(CA)中的任何 IdM 实体请求一个新证书:ipa
CA 或其任何子 CA。
IdM 实体包括:
- 用户
- 主机
- 服务
服务通常在其上存储了私钥的专用服务节点上运行。将服务的私钥复制到 IdM 服务器被视为不安全。因此,在为服务请求证书时,请在服务节点上创建证书签名请求(CSR)。
先决条件
- 您的 IdM 部署包含一个集成 CA。
- 以 IdM 管理员身份登录到 IdM Web UI。
流程
-
在
Identity
选项卡下,选择Users
、Hosts
或Services
子选项卡。 单击用户、主机或服务的名称,以打开其配置页面。
图 2.1. 主机列表
- 单击 → 。
- 可选:选择发布 CA 和配置文件 ID。
-
按照说明使用屏幕上的
certutil
命令行(CLI)工具。 - 点 。
2.2. 使用 certutil 从 IdM CA 中为用户、主机或服务请求新证书
您可以使用 certutil
工具在标准的 IdM 环境下为身份管理(IdM)用户、主机或服务请求证书。要确保主机或服务 Kerberos 别名可以使用证书,使用 openssl 工具来请求证书。
按照以下流程,使用 certutil
为来自 ipa
、IdM 证书颁发机构(CA)的 IdM 用户、主机或服务请求证书。
服务通常在其上存储了私钥的专用服务节点上运行。将服务的私钥复制到 IdM 服务器被视为不安全。因此,在为服务请求证书时,请在服务节点上创建证书签名请求(CSR)。
先决条件
- 您的 IdM 部署包含一个集成 CA。
- 您已经以 IdM 管理员的身份登录到 IdM 命令行界面(CLI)。
流程
为证书数据库创建一个临时目录:
# mkdir ~/certdb/
例如,创建一个新的临时证书数据库:
# certutil -N -d ~/certdb/
创建 CSR,并将输出重定向到文件。例如,要为 4096 位证书创建一个 CSR,并将主题设为 CN=server.example.com,O=EXAMPLE.COM :
# certutil -R -d ~/certdb/ -a -g 4096 -s "CN=server.example.com,O=EXAMPLE.COM" -8 server.example.com > certificate_request.csr
将证书请求文件提交到 IdM 服务器上运行的 CA。指定要与新发布的证书关联的 Kerberos 主体:
# ipa cert-request certificate_request.csr --principal=host/server.example.com
IdM 中的
ipa cert-request
命令使用以下默认值:caIPAserviceCert
证书配置文件要选择一个自定义配置文件,请使用
--profile-id
选项。集成的 IdM root CA
ipa
要选择子 CA,请使用
--ca
选项。
其它资源
-
请参阅
ipa cert-request --help
命令的输出。 - 请参阅 在身份管理中创建和管理证书配置文件。
2.3. 使用 openssl 从 IdM CA 中为用户、主机或服务请求新证书
如果要确保主机或服务的 Kerberos 别名可以使用证书,您可以使用 openssl
工具为身份管理(IdM)主机或服务请求证书。在标准情况下,请考虑 使用 certutil 工具请求一个新证书。
按照以下流程,使用 openssl
为 IdM 主机或来自 ipa
、IdM 证书颁发机构的服务请求证书。
服务通常在其上存储了私钥的专用服务节点上运行。将服务的私钥复制到 IdM 服务器被视为不安全。因此,在为服务请求证书时,请在服务节点上创建证书签名请求(CSR)。
先决条件
- 您的 IdM 部署包含一个集成 CA。
- 您已经以 IdM 管理员的身份登录到 IdM 命令行界面(CLI)。
流程
- 为您的 Kerberos 主体 test/server.example.com 创建一个或多个别名。例如,test1/server.example.com 和 test2/server.example.com。
在 CSR 中,为 dnsName(server.example.com)和 otherName(test2/server.example.com)添加 subjectAltName。要做到这一点,请将
openssl.conf
文件配置为包含以下指定 UPN otherName 和 subjectAltName 的行:otherName=1.3.6.1.4.1.311.20.2.3;UTF8:test2/server.example.com@EXAMPLE.COM DNS.1 = server.example.com
使用
openssl
创建一个证书请求:openssl req -new -newkey rsa:2048 -keyout test2service.key -sha256 -nodes -out certificate_request.csr -config openssl.conf
将证书请求文件提交到 IdM 服务器上运行的 CA。指定要与新发布的证书关联的 Kerberos 主体:
# ipa cert-request certificate_request.csr --principal=host/server.example.com
IdM 中的
ipa cert-request
命令使用以下默认值:caIPAserviceCert
证书配置文件要选择一个自定义配置文件,请使用
--profile-id
选项。集成的 IdM root CA
ipa
要选择子 CA,请使用
--ca
选项。
其它资源
-
请参阅
ipa cert-request --help
命令的输出。 - 请参阅 在身份管理中创建和管理证书配置文件。
2.4. 其它资源
- 请参阅 撤销带有集成 IdM CA 的证书。
- 请参阅 使用集成的 IdM CA 恢复证书。
- 请参阅 限制应用程序只信任证书子集。
第 3 章 管理 IdM 用户、主机和服务的外部签名证书
本章描述了如何使用身份管理(IdM)命令行界面(CLI)和 IdM Web UI 来添加或删除用户、主机,以及由外部证书颁发机构(CA)发布的服务证书。
3.1. 使用 IdM CLI ,将外部 CA 发布的证书添加到 IdM 用户、主机或服务
作为身份管理(IdM)管理员,您可以使用身份管理(IdM)CLI 向 IdM 用户的帐户、主机或服务添加外部签名的证书。
先决条件
- 您已获得管理员用户的票据授予票据。
流程
要为 IdM 用户添加证书,请输入:
$ ipa user-add-cert user --certificate=MIQTPrajQAwg...
该命令要求您指定以下信息:
- 用户名
- Base64 编码的 DER 证书
不是将证书内容复制并粘贴到命令行,您可以将证书转换为 DER 格式,然后将其重新编码为 Base64。例如,要将 user_cert.pem
证书添加给 user
,请输入:
$ ipa user-add-cert user --certificate="$(openssl x509 -outform der -in user_cert.pem | base64 -w 0)"
您可以在不添加任何选项的情况下,以交互方式运行 ipa user-add-cert
命令。
要将证书添加给 IdM 主机,请输入:
-
ipa host-add-cert
要将证书添加给 IdM 服务,请输入:
-
ipa service-add-cert
3.2. 使用 IdM Web UI 将外部 CA 发布的证书添加到 IdM 用户、主机或服务中
作为身份管理(IdM)管理员,您可以使用身份管理(IdM)Web UI 将外部签名的证书添加到 IdM 用户的帐户、主机或服务中。
先决条件
- 您以管理用户的身份登录到身份管理(IdM)Web UI。
流程
-
打开
Identity
选项卡,然后选择Users
、Hosts
或Services
子选项卡。 - 单击用户、主机或服务的名称,以打开其配置页面。
单击
Certificates
条目旁边的 。图 3.1. 将证书添加给用户帐户
- 将 Base64 或 PEM 编码格式的证书粘贴到文本字段中,然后单击 。
- 单击 以保存更改。
3.3. 使用 IdM CLI 从 IdM 用户、主机或服务帐户中删除外部 CA 发布的证书
作为身份管理(IdM)管理员,您可以使用身份管理(IdM)CLI 从 IdM 用户的帐户、主机或服务中删除外部签名的证书。
先决条件
- 您已获得管理员用户的票据授予票据。
流程
要从 IdM 用户中删除证书,请输入:
$ ipa user-remove-cert user --certificate=MIQTPrajQAwg...
该命令要求您指定以下信息:
- 用户名
- Base64 编码的 DER 证书
不是将证书内容复制并粘贴到命令行,您可以将证书转换为 DER 格式,然后将其重新编码为 Base64。例如,要从user
中删除 user_cert.pem
证书,请输入:
$ ipa user-remove-cert user --certificate="$(openssl x509 -outform der -in user_cert.pem | base64 -w 0)"
您可以在不添加任何选项的情况下,以交互方式运行 ipa user-remove-cert
命令。
要从 IdM 主机中删除证书,请输入:
-
ipa host-remove-cert
要从 IdM 服务中删除证书,请输入:
-
ipa service-remove-cert
3.4. 使用 IdM Web UI 从 IdM 用户、主机或服务帐户中删除外部 CA 发布的证书
作为身份管理(IdM)管理员,您可以使用身份管理(IdM)Web UI 从 IdM 用户的帐户、主机或服务中删除外部签名的证书。
先决条件
- 您以管理用户的身份登录到身份管理(IdM)Web UI。
流程
-
打开
Identity
选项卡,然后选择Users
、Hosts
或Services
子选项卡。 - 单击用户、主机或服务的名称,以打开其配置页面。
- 单击要删除的证书旁边的 ,然后选择 。
- 单击 以保存更改。
3.5. 其它资源
第 4 章 转换证书格式以使用 IdM
这个用户故事描述了如何确保您作为 IdM 系统管理员使用证书的正确格式和特定的 IdM 命令。例如,这在以下情况下非常有用:
- 您将外部证书加载到用户配置文件中。详情请参阅 转换外部证书以加载到 IdM 用户帐户。
- 当 为智能卡验证配置 IdM 服务器 或 为智能卡验证配置 IdM 客户端 时使用外部 CA 证书,以便用户可以使用带有外部证书颁发机构签发的证书的智能卡向 IdM 进行验证。
- 您将 NSS 数据库中的证书导出为 pkcs #12 格式,其中包括证书和私钥。详情请查看 将 NSS 数据库中的证书和私钥导出到 PKCS #12 文件。
4.1. IdM 中的证书格式和编码
包括 IdM 中智能卡验证在内的证书验证通过比较用户提供的证书或证书数据(保存在用户的 IdM 配置文件)来进行。
系统配置
IdM 配置文件中存储的内容仅是证书,而不是对应的私钥。在身份验证期间,用户还必须显示其拥有相应的私钥。用户通过显示包含证书和私钥的 PKCS #12 文件或两个文件:一个包含证书,另一个包含私钥,来执行此操作。
因此,将证书加载到用户配置文件的进程只接受不包含私钥的证书文件。
同样,当系统管理员为您提供了外部 CA 证书时,他将仅提供公共数据:不带私钥的证书。为智能卡验证配置 IdM 服务器或 IdM 客户端的 ipa-advise
工具期望输入文件包含外部 CA 的证书,而不是私钥。
证书编码
有两种常见的证书编码:隐私增强型电子邮件(PEM
)和区分的编码规则(DER
)。base64
格式与 PEM
格式几乎相同,但其不包含 -----BEGIN CERTIFICATE-----/-----END CERTIFICATE-----
页眉和页脚。
已使用 DER
编码的证书是一个二进制 X509 数字证书文件。作为二进制文件,证书不可读。DER
文件有时使用 .der
文件扩展名,但带有 .crt
和 .cer
文件扩展名的文件有时也会包含 DER
证书。包含密钥的 DER
文件可以命名为 .key
。
使用 PEM
Base64 编码的证书是一个人类可读的文件。文件包含前缀为"-----BEGIN …"行的 ASCII(Base64)装甲数据。PEM
文件有时使用 .pem
文件扩展名,但具有 .crt
和 .cer
文件扩展名的文件有时也包含 PEM
证书。包含密钥的 PEM
文件可以命名为 .key
。
不同的 ipa
命令对其接受的证书类型有不同的限制。例如,ipa user-add-cert
命令只接受以 base64
格式编码的证书,但 ipa-server-certinstall
可接受 PEM, DER, PKCS #7, PKCS #8
和 PKCS #12
证书。
编码格式 | 人类可读 | 通用文件扩展名 | 接受编码格式的 IdM 命令示例 |
---|---|---|---|
PEM/base64 | 是 | .pem, .crt, .cer | ipa user-add-cert, ipa-server-certinstall, … |
DER | 否 | .der, .crt, .cer | ipa-server-certinstall, … |
IdM 中与证书相关的命令和格式 列出了带有命令接受的证书格式的 ipa
命令。
用户身份验证
在使用 Web UI 访问 IdM 时,用户通过将两者都存储在浏览器的数据库中,证明自己拥有与证书对应的私钥。
当使用 CLI 访问 IdM 时,用户通过以下方法之一证明自己拥有与证书对应的私钥:
用户添加了
kinit -X
命令的X509_user_identity
参数的值,添加了连接到包含证书和密钥的智能卡的智能模块的路径:$ kinit -X X509_user_identity='PKCS11:opensc-pkcs11.so'
idm_user
用户添加两个文件作为
kinit -X
命令的X509_user_identity
参数的值,一个包含证书,另一个包含私钥:$ kinit -X X509_user_identity='FILE:`/path/to/cert.pem,/path/to/cert.key`'
idm_user
有用的证书命令
要查看证书数据,如主题和签发者:
$ openssl x509 -noout -text -in ca.pem
要比较两个证书在哪行不同:
$ diff cert1.crt cert2.crt
要比较哪行中两个证书与两列中显示的输出不同:
$ diff cert1.crt cert2.crt -y
4.2. 转换外部证书以加载到 IdM 用户帐户
本节论述了如何确保在将外部证书添加到用户条目之前其被正确编码和格式化。
4.2.1. 先决条件
-
如果您的证书由活动目录证书认证机构签发,并使用
PEM
编码的,请确保PEM
文件已转换为UNIX
格式。要转换文件,请使用 eponymous 软件包提供的dos2unix
工具。
4.2.2. 在 IdM CLI 中转换外部证书,并将其加载到 IdM 用户帐户
IdM CLI
只接受 PEM
证书,第一行和最后一行(-----BEGIN CERTIFICATE----- 和 -----END CERTIFICATE-----)已从中移除。
按照以下流程,将外部证书转换为 PEM
格式,并使用 IdM CLI 将其添加到 IdM 用户帐户。
流程
将证书转换为
PEM
格式:如果您的证书为
DER
格式:$ openssl x509 -in cert.crt -inform der -outform pem -out cert.pem
如果您的文件是
PKCS #12
格式,其通用文件扩展名为.pfx
和.p12
,并且包含证书、私钥和其他数据,请使用openssl pkcs12
工具提取证书。提示时,输入保护存储在文件中私钥的密码:$ openssl pkcs12 -in cert_and_key.p12 -clcerts -nokeys -out cert.pem Enter Import Password:
获得管理员凭证:
$ kinit admin
根据以下方法之一,使用
IdM CLI
将证书添加到用户帐户:在将字符串添加到
ipa user-add-cert
命令前,使用sed
工具删除PEM
文件的第一行和最后一行(-----BEGIN CERTIFICATE----- 和 -----END CERTIFICATE-----):$ ipa user-add-cert some_user --certificate="$(sed -e '/BEGIN CERTIFICATE/d;/END CERTIFICATE/d' cert.pem)"
将不包含 第一行和最后一行(-----BEGIN CERTIFICATE----- 和 -----END CERTIFICATE-----)的证书文件的内容复制并粘贴到
ipa user-add-cert
命令中:$ ipa user-add-cert some_user --certificate=MIIDlzCCAn+gAwIBAgIBATANBgkqhki...
注意您不能直接将包含证书的
PEM
文件作为输入传给ipa user-add-cert
命令,无需先删除第一行和最后一行(-----BEGIN CERTIFICATE----- 和 -----END CERTIFICATE-----):$ ipa user-add-cert some_user --cert=some_user_cert.pem
此命令会导致 "ipa: ERROR: Base64 decoding failed: Incorrect padding"错误消息。
检查系统是否接受了证书:
[idm_user@r8server]$ ipa user-show some_user
4.2.3. 在 IdM Web UI 中转换外部证书以加载到 IdM 用户帐户
按照以下流程将外部证书转换为 PEM
格式,并在 IdM Web UI 中将其添加到 IdM 用户帐户。
流程
使用
CLI
,将证书转换为PEM
格式:如果您的证书为
DER
格式:$ openssl x509 -in cert.crt -inform der -outform pem -out cert.pem
如果您的文件是
PKCS #12
格式,其通用文件扩展名为.pfx
和.p12
,并且包含证书、私钥和其他数据,请使用openssl pkcs12
工具提取证书。提示时,输入保护存储在文件中私钥的密码:$ openssl pkcs12 -in cert_and_key.p12 -clcerts -nokeys -out cert.pem Enter Import Password:
-
在编辑器中打开证书,并复制内容。您可以包含 "-----BEGIN CERTIFICATE-----" and "-----END CERTIFICATE-----" 页眉和页脚行,但不必这样做,因为
PEM
和base64
格式已被 IdM Web UI 接受了。 - 在 IdM Web UI 中,以安全官员身份登录。
-
前往
Identity
→Users
→some_user
。 -
单击
Certificates
旁边的Add
。 - 将证书的 PEM 格式内容粘贴到打开的窗口中。
-
单击
Add
。
如果证书被系统接受了,您可以看到其会在用户配置文件中的 Certificates
中列出。
4.3. 准备将证书加载到浏览器
在将用户证书导入到浏览器前,请确保证书和对应的私钥都是 PKCS #12
格式。有两种常见情况需要额外的准备工作:
- 证书位于 NSS 数据库中。有关如何在此情况下进行处理的详情,请参考 将 NSS 数据库中的证书和私钥导出到 PKCS #12 文件。
-
证书和私钥位于两个单独的
PEM
文件中。有关如何在此情况下进行处理的详情,请参考 将证书和私钥 PEM 文件合并到 PKCS #12 文件中。
之后,要将 PEM
格式的 CA 证书和 PKCS #12
格式的用户证书导入到浏览器中,请按照 配置浏览器来启用证书身份验证 和 使用证书作为身份管理用户来验证到身份管理 Web UI 中描述的流程。
4.3.1. 将证书和私钥从 NSS 数据库导出到 PKCS #12 文件中
流程
使用
pk12util
命令将证书从 NSS 数据库导出为PKCS12
格式。例如,将~/certdb
目录中存储的 NSS 数据库中的some_user
昵称的证书导出到~/some_user.p12
文件:$ pk12util -d
~/certdb
-o~/some_user.p12
-n some_user Enter Password or Pin for "NSS Certificate DB": Enter password for PKCS12 file: Re-enter password: pk12util: PKCS12 EXPORT SUCCESSFUL为
.p12
文件设置合适的权限:# chmod 600 ~/some_user.p12
由于
PKCS #12
文件也包含私钥,因此必须对其进行保护以防止其他用户使用该文件。否则,他们能够模拟用户。
4.3.2. 将证书和私钥 PEM 文件合并到 PKCS #12 文件中
按照以下流程,将证书和存储在单独的 PEM
文件中的对应密钥合并到 PKCS #12
文件中。
流程
将存储在
certfile.cer
中的证书和存储在certfile.key
中的密钥合并到包含证书和密钥的certfile.p12
文件中:$ openssl pkcs12 -export -in certfile.cer -inkey certfile.key -out certfile.p12
4.4. IdM 中与证书相关的命令和格式
下表显示了 IdM 中与证书相关的命令及可接受的格式。
命令 | 可接受的格式 | 备注 |
---|---|---|
| base64 PEM 证书 | |
| PEM 和 DER 证书;PKCS#7 证书链;PKCS#8 和原始私钥;PKCS#12 证书和私钥 | |
| DER; PEM; PKCS#7 | |
| PEM 和 DER 证书; PKCS#7 证书链 | |
| PEM 和 DER 证书; PKCS#7 证书链 | |
| 不适用 |
使用具有 |
| 不适用 |
使用具有 |
| 不适用 |
使用新证书创建 PEM 格式的 |
| 不适用 |
使用新证书创建 PEM 格式的 |
第 5 章 在身份管理中创建和管理证书配置文件
证书授权机构(CA)在签名证书时使用证书配置文件,以确定证书签名请求(CSR)是否可接受,如果可接受,则证书中存在哪些功能和扩展。证书配置文件与发布特定类型的证书相关联。通过组合证书配置文件和 CA 访问控制列表(ACL),您可以定义和控制对自定义证书配置文件的访问。
在描述如何创建证书配置文件时,流程使用 S/MIME 证书作为示例。某些电子邮件程序支持使用安全多用途 Internet 邮件扩展(S/MIME)协议进行数字签名和加密的电子邮件。使用 S/MIME 签名或加密电子邮件消息,要求消息的发件人具有 S/MIME 证书。
5.1. 什么是证书配置文件?
您可以使用证书配置文件确定证书的内容,以及发布证书的限制,如下所示:
- 用于加密证书签名请求的签名算法。
- 证书的默认有效期。
- 用于吊销证书的吊销原因。
- 如果主体的通用名称被复制到主题替代名称字段。
- 证书中应存在的特性和扩展。
单个证书配置文件与签发特定类型的证书相关联。您可以为 IdM 中的用户、服务和主机定义不同的证书配置文件。IdM 默认包括以下证书配置文件:
-
caIPAserviceCert
-
IECUserRoles
-
KDCs_PKINIT_Certs
(内部使用)
另外,您可以创建和导入自定义配置文件,允许您为特定目的发布证书。例如,您可以将特定配置文件的使用限制为一个用户或一个组,防止其他用户和组使用该配置文件发布证书进行身份验证。要创建自定义证书配置集,请使用 ipa certprofile
命令。
其它资源
-
请参阅
ipa help certprofile
命令。
5.2. 创建证书配置文件
按照以下流程,通过命令行创建证书配置文件,方法是创建一个配置文件来请求 S/MIME 证书。
流程
通过复制现有默认配置集来创建自定义配置集:
$ ipa certprofile-show --out smime.cfg caIPAserviceCert ------------------------------------------------ Profile configuration stored in file 'smime.cfg' ------------------------------------------------ Profile ID: caIPAserviceCert Profile description: Standard profile for network services Store issued certificates: TRUE
在文本编辑器中打开新创建的配置集配置文件。
$ vi smime.cfg
将
Profile ID
更改为反映配置集用法的名称,如smime
。注意当您导入新创建的配置集时,
profileId
字段必须与命令行中指定的 ID 匹配。更新扩展密钥使用情况配置。默认的扩展密钥使用扩展配置用于 TLS 服务器和客户端身份验证。例如,对于 S/MIME,必须配置扩展密钥用法来保护电子邮件:
policyset.serverCertSet.7.default.params.exKeyUsageOIDs=1.3.6.1.5.5.7.3.4
导入新配置集:
$ ipa certprofile-import smime --file smime.cfg \ --desc "S/MIME certificates" --store TRUE ------------------------ Imported profile "smime" ------------------------ Profile ID: smime Profile description: S/MIME certificates Store issued certificates: TRUE
验证
验证新证书配置集已被导入:
$ ipa certprofile-find ------------------ 4 profiles matched ------------------ Profile ID: caIPAserviceCert Profile description: Standard profile for network services Store issued certificates: TRUE Profile ID: IECUserRoles Profile description: User profile that includes IECUserRoles extension from request Store issued certificates: TRUE Profile ID: KDCs_PKINIT_Certs Profile description: Profile for PKINIT support by KDCs Store issued certificates: TRUE Profile ID: smime Profile description: S/MIME certificates Store issued certificates: TRUE ---------------------------- Number of entries returned 4 ----------------------------
其它资源
-
请参阅
ipa help certprofile
。 - 请参阅 RFC 5280, 第 4.2.1.12 部分。
5.3. 什么是 CA 访问控制列表?
证书颁发机构访问控制列表(CA ACL)规则定义哪些配置文件可用于向哪些主体发布证书。您可以使用 CA ACL 来执行此操作,例如:
- 确定可以使用特定配置集向哪些用户、主机或服务签发证书
- 确定允许哪些 IdM 证书颁发机构或子 CA 签发证书
例如,使用 CA ACL 时,您可以将设计为从伦敦办事处工作的员工的配置文件限制为属于伦敦办事处相关 IdM 用户组的用户。
用于管理 CA ACL 规则的 ipa caacl
实用程序允许特权用户添加、显示、修改或删除指定的 CA ACL。
其它资源
-
请参阅
ipa help caacl
。
5.4. 定义 CA ACL 以控制对证书配置文件的访问
按照以下流程,使用 caacl
工具定义 CA 访问控制列表(ACL)规则,以允许组中的用户访问自定义证书配置文件。在这种情况下,流程描述了如何创建 S/MIME 用户的组和 CA ACL,以允许该组中的用户访问 smime
证书配置文件。
先决条件
- 确保您已获取 IdM 管理员的凭据。
流程
为证书配置集的用户创建一个新组:
$ ipa group-add smime_users_group --------------------------------- Added group "smime users group" --------------------------------- Group name: smime_users_group GID: 75400001
创建一个新用户来添加到
smime_user_group
组:$ ipa user-add smime_user First name: smime Last name: user ---------------------- Added user "smime_user" ---------------------- User login: smime_user First name: smime Last name: user Full name: smime user Display name: smime user Initials: TU Home directory: /home/smime_user GECOS: smime user Login shell: /bin/sh Principal name: smime_user@IDM.EXAMPLE.COM Principal alias: smime_user@IDM.EXAMPLE.COM Email address: smime_user@idm.example.com UID: 1505000004 GID: 1505000004 Password: False Member of groups: ipausers Kerberos keys available: False
将
smime_user
添加到smime_users_group
组:$ ipa group-add-member smime_users_group --users=smime_user Group name: smime_users_group GID: 1505000003 Member users: smime_user ------------------------- Number of members added 1 -------------------------
创建 CA ACL 以允许组中的用户访问证书配置集:
$ ipa caacl-add smime_acl ------------------------ Added CA ACL "smime_acl" ------------------------ ACL name: smime_acl Enabled: TRUE
在 CA ACL 中添加用户组:
$ ipa caacl-add-user smime_acl --group smime_users_group ACL name: smime_acl Enabled: TRUE User Groups: smime_users_group ------------------------- Number of members added 1 -------------------------
向 CA ACL 中添加证书配置文件:
$ ipa caacl-add-profile smime_acl --certprofile smime ACL name: smime_acl Enabled: TRUE Profiles: smime User Groups: smime_users_group ------------------------- Number of members added 1 -------------------------
验证
查看您创建的 CA ACL 的详情:
$ ipa caacl-show smime_acl ACL name: smime_acl Enabled: TRUE Profiles: smime User Groups: smime_users_group ...
其它资源
-
请参阅您系统上的
ipa
手册页。 -
请参阅
ipa help caacl
。
5.5. 使用证书配置文件和 CA ACL 发布证书
当证书颁发机构访问控制列表(CA ACL)允许时,您可以使用证书配置文件来请求证书。按照以下流程,使用自定义证书配置文件为用户请求 S/MIME 证书,该配置文件已通过 CA ACL 授予了访问权限。
先决条件
- 您的证书配置集已创建。
- 已经创建了允许用户使用所需证书配置文件请求证书的 CA ACL。
您可以绕过 CA ACL 检查用户是否执行 cert-request
命令:
-
是
admin
用户。 -
具有
请求忽略 CA ACL 的证书
权限。
流程
为用户生成证书请求。例如,使用 OpenSSL:
$ openssl req -new -newkey rsa:2048 -days 365 -nodes -keyout private.key -out cert.csr -subj '/CN=smime_user'
从 IdM CA 请求用户的新证书:
$ ipa cert-request cert.csr --principal=smime_user --profile-id=smime
(可选)将 --ca 子 CA_name 选项传递给 命令,以从子 CA 而非 root CA 请求证书。
验证
验证新发布的证书是否已分配给用户:
$ ipa user-show user User login: user ... Certificate: MIICfzCCAWcCAQA... ...
其它资源
-
您系统上的
ipa (a)
和openssl (lssl)
手册页 -
ipa help user-show
命令 -
ipa help cert-request
命令
5.6. 修改证书配置文件
按照以下流程,使用 ipa certprofile-mod
命令直接通过命令行修改证书配置文件。
流程
确定您要修改的证书配置集的证书配置集 ID。显示 IdM 中当前存储的所有证书配置集:
# ipa certprofile-find ------------------ 4 profiles matched ------------------ Profile ID: caIPAserviceCert Profile description: Standard profile for network services Store issued certificates: TRUE Profile ID: IECUserRoles ... Profile ID: smime Profile description: S/MIME certificates Store issued certificates: TRUE -------------------------- Number of entries returned --------------------------
修改证书配置文件描述。例如,如果您使用现有配置集为 S/MIME 证书创建自定义证书配置集,请使用新用法更改描述:
# ipa certprofile-mod smime --desc "New certificate profile description" ------------------------------------ Modified Certificate Profile "smime" ------------------------------------ Profile ID: smime Profile description: New certificate profile description Store issued certificates: TRUE
在文本编辑器中打开您的客户证书配置文件并根据您的要求进行修改:
# vi smime.cfg
有关可以在证书配置文件配置文件中配置的选项的详情,请查看 证书配置文件配置参数。
更新现有证书配置集配置文件:
# ipa certprofile-mod _profile_ID_ --file=smime.cfg
验证
验证证书配置集是否已更新:
$ ipa certprofile-show smime Profile ID: smime Profile description: New certificate profile description Store issued certificates: TRUE
其它资源
-
请参阅您系统上的
ipa (a)
手册页。 -
请参阅
ipa help certprofile-mod
。
5.7. 证书配置文件配置参数
证书配置集配置参数存储在 CA 配置集目录中的 profile_name.cfg 文件中,即 /var/lib/pki/pki-tomcat/ca/profiles/ca
。配置集的所有参数(默认值、输入、输出和限制)都在单个策略集中配置。为证书配置集设置的策略具有名称 policyset.policyName.policyNumber。
例如,对于策略设置 serverCertSet
:
policyset.list=serverCertSet policyset.serverCertSet.list=1,2,3,4,5,6,7,8 policyset.serverCertSet.1.constraint.class_id=subjectNameConstraintImpl policyset.serverCertSet.1.constraint.name=Subject Name Constraint policyset.serverCertSet.1.constraint.params.pattern=CN=[^,]+,.+ policyset.serverCertSet.1.constraint.params.accept=true policyset.serverCertSet.1.default.class_id=subjectNameDefaultImpl policyset.serverCertSet.1.default.name=Subject Name Default policyset.serverCertSet.1.default.params.name=CN=$request.req_subject_name.cn$, OU=pki-ipa, O=IPA policyset.serverCertSet.2.constraint.class_id=validityConstraintImpl policyset.serverCertSet.2.constraint.name=Validity Constraint policyset.serverCertSet.2.constraint.params.range=740 policyset.serverCertSet.2.constraint.params.notBeforeCheck=false policyset.serverCertSet.2.constraint.params.notAfterCheck=false policyset.serverCertSet.2.default.class_id=validityDefaultImpl policyset.serverCertSet.2.default.name=Validity Default policyset.serverCertSet.2.default.params.range=731 policyset.serverCertSet.2.default.params.startTime=0
每个策略集包含按照策略 ID 号为证书配置文件配置的策略列表,以它们的评估顺序排列。服务器评估为其收到的每个请求设置的每个策略。收到单个证书请求时,将评估一个集合,并忽略配置集中的任何其他集合。发出双密钥对后,第一个策略集针对第一个证书请求进行评估,第二个策略集针对第二个证书请求进行评估。在发行双密钥对时,在发布单个证书或多个集合时,您不需要多个策略集。
参数 | 描述 |
---|---|
DESC |
证书配置文件的免费文本描述,显示在端点页面中。例如, |
启用 |
启用配置文件,使它可通过端点页面访问。例如: |
auth.instance_id |
设置用于验证证书请求的身份验证管理器插件。要进行自动注册,如果身份验证成功,CA 会立即发出证书。如果身份验证失败或者没有指定身份验证插件,则会将请求排队,以供代理手动批准。例如,auth |
authz.acl |
指定授权约束。这主要用于设置组评估访问控制列表(ACL)。例如,
在基于目录的用户证书续订中,此选项用于确保原始请求者和当前验证的用户相同。在评估授权前,实体必须验证(二进制或本质上是登录到系统)。 |
name |
证书配置文件的名称。例如, |
input.list |
按名称列出证书配置集允许的输入。例如, |
input.input_id.class_id |
表示输入 ID(在 input.list 中列出的输入名称)的 java 类名称。例如: |
output.list |
根据名称列出证书配置集的可能输出格式。例如 |
output.output_id.class_id |
在 output.list 中指定输出格式的 java 类名称。例如: |
policyset.list |
列出配置的证书配置集规则。对于双证书,一组规则适用于签名密钥,另一条适用于加密密钥。单个证书仅使用一组证书配置集规则。例如,policy |
policyset.policyset_id.list |
根据策略 ID 号,按照评估的顺序为证书配置文件配置的顺序列出策略集合。例如: |
policyset.policyset_id.policy_number.constraint.class_id | 表示为配置集规则中配置的默认配置的 java 类插件设置的 java 类名称。For example, policyset.serverCertSet.1.constraint.class_id=subjectNameConstraintImpl. |
policyset.policyset_id.policy_number.constraint.name | 提供用户定义的约束名称。例如,policyset.serverCertSet.1.constraint.name=Subject Name Constraint。 |
policyset.policyset_id.policy_number.constraint.params.attribute | 为约束的 allowed 属性指定值。可能的属性根据约束类型而有所不同。For example, policyset.serverCertSet.1.constraint.params.pattern=CN=.*. |
policyset.policyset_id.policy_number.default.class_id | 提供配置集规则中设置的 java 类名称。For example, policyset.serverCertSet.1.default.class_id=userSubjectNameDefaultImpl |
policyset.policyset_id.policy_number.default.name | 提供用户定义的默认名称。例如: policyset.serverCertSet.1.default.name=Subject Name Default |
policyset.policyset_id.policy_number.default.params.attribute | 为默认值的 allowed 属性指定值。可能的属性因默认类型而异。例如: policyset.serverCertSet.1.default.params.name=CN=(Name)$request.requestor_name$. |
第 6 章 在 IdM 中管理证书的有效性
在 Identity Management(IdM)中,您可以管理未来要颁发的现有证书和证书的有效性,但方法却有所不同。
6.1. 管理 IdM CA 发布的现有证书的有效性
在 IdM 中,可以使用以下方法查看证书的过期日期:
您可以使用以下方法管理 IdM CA 发布的现有证书的有效性:
使用原始证书签名请求(CSR)或私钥生成的新 CSR 来续订证书。您可以使用以下工具请求新证书:
- certmonger
-
您可以使用
certmonger
请求服务证书。证书到期之前,证书将自动
续订证书,从而确保服务证书持续有效。详情请参阅 使用 certmonger 为服务获取 IdM 证书 。 - certutil
-
您可以使用
certutil
更新用户、主机和服务证书。有关请求用户证书的详情,请参阅 请求新的用户证书并将其导出到客户端 ; - openssl
-
您可以使用
openssl
更新用户、主机和服务证书。
撤销证书。详情请查看:
如果证书已被临时撤销,则还原证书。详情请查看:
6.2. 管理 IdM CA 发布的证书的有效性
要管理 IdM CA 发布的证书、修改、导入或创建证书配置集的有效性。详情请参阅在 身份管理中创建和管理证书配置集。
6.3. 在 IdM WebUI 中查看证书的过期日期
您可以使用 IdM WebUI 查看 IdM CA 发布的所有证书的到期日期。
先决条件
- 确保您已获取管理员的凭据。
流程
-
在
Authentication
菜单中点击Certificates
>Certificates
。 单击证书的序列号,以打开证书信息页面。
图 6.1. 证书列表
-
在证书信息页面中,找到
Expires On
信息。
6.4. 在 CLI 中查看证书的到期日期
您可以使用命令行(CLI)查看证书的到期日期。
流程
使用
openssl
实用程序以人类可读格式打开文件:$ openssl x509 -noout -text -in ca.pem Certificate: Data: Version: 3 (0x2) Serial Number: 1 (0x1) Signature Algorithm: sha256WithRSAEncryption Issuer: O = IDM.EXAMPLE.COM, CN = Certificate Authority Validity Not Before: Oct 30 19:39:14 2017 GMT Not After : Oct 30 19:39:14 2037 GMT
6.5. 使用集成的 IdM CA 撤销证书
6.5.1. 证书撤销原因
已撤销的证书无效,无法用于身份验证。所有取消均为永久性,但原因为 6: 证书持有者
。
默认撤销原因为 0: 未指定
。
ID | 原因 | 解释 |
---|---|---|
0 | Unspecified | |
1 | 主要已编译 | 签发证书的密钥不再被信任。 可能的原因是:丢失令牌,访问不当文件. |
2 | CA Compromized | 签发证书的 CA 不再被信任。 |
3 | 联盟更改 | 可能的原因: * 个人已离开公司或转到另一个部门。 * 主机或服务将被停用。 |
4 | 被替换 | 较新的证书替换了当前的证书。 |
5 | 运营部 | 主机或服务将被停用。 |
6 | 证书冻结 | 证书会被临时撤销。您可稍后恢复证书。 |
8 | 从 CRL 中删除 | 证书不包括在证书撤销列表(CRL)中。 |
9 | 权限 Withdrawn | 用户、主机或服务不再被允许使用该证书。 |
10 | 属性授权(AA)Compromise | AA 证书不再被信任。 |
6.5.2. 使用 IdM Web UI 通过集成的 IdM CA 撤销证书
如果您知道自己丢失了证书的私钥,则必须撤销证书以防止滥用证书。完成此流程,以使用 IdM WebUI 撤销 IdM CA 发布的证书。
流程
-
点击
Authentication
>Certificates
>Certificates
。 单击证书的序列号,以打开证书信息页面。
图 6.2. 证书列表
- 在证书信息页面中,单击 → 。
- 选择撤销的原因,然后单击 证书撤销原因。 。详情请参阅
6.5.3. 使用 IdM CLI 通过集成的 IdM CA 撤销证书
如果您知道自己丢失了证书的私钥,则必须撤销证书以防止滥用证书。完成此流程,以使用 IdM CLI 撤销 IdM CA 发布的证书。
流程
使用
ipa cert-revoke
命令,并指定:- 证书序列号
- 撤销原因的 ID 号 ; 详情请参阅 证书撤销原因
例如,要撤销序列号为 1032
的证书,原因为 1: Key Compromized
,请输入:
$ ipa cert-revoke 1032 --revocation-reason=1
有关请求新证书的详情,请查看以下文档:
6.6. 使用集成的 IdM CA 恢复证书
如果您因为 6 原因撤销了 证书:证书 Hold
,如果证书的私钥未泄露,您可以再次恢复证书。要恢复证书,请使用以下步骤之一:
6.6.1. 使用 IdM WebUI 恢复集成 IdM CA 的证书
完成这个步骤,使用 IdM WebUI 恢复因为 Reason 6 而撤销的 IdM 证书:Credential Hold
。
流程
-
在
Authentication
菜单中点击Certificates
>Certificates
。 单击证书的序列号,以打开证书信息页面。
图 6.3. 证书列表
- 在证书信息页面中,单击 → 。
6.6.2. 使用 IdM CLI 恢复集成 IdM CA 的证书
完成此流程,以使用 IdM CLI 恢复因为 Reason 6 而撤销的 IdM 证书:证书冻结
。
流程
使用
ipa cert-remove-hold
命令并指定证书序列号。例如:$ ipa cert-remove-hold 1032
第 7 章 为智能卡验证配置身份管理
Identity Management(IdM)支持智能卡验证:
- IdM 证书颁发机构发布的用户证书
- 外部证书颁发机构发布的用户证书
您可以在 IdM 中为两种类型的证书配置智能卡验证。在这种情况下,rootca.pem
CA 证书是包含可信外部证书颁发机构证书的文件。
有关 IdM 中智能卡验证的详情,请参考 了解智能卡验证。
有关配置智能卡验证的详情:
7.1. 为智能卡验证配置 IdM 服务器
如果要为证书由身份管理(IdM) CA 信任的 <EXAMPLE.ORG> 域的证书颁发机构(CA)发布的用户启用智能卡验证,您必须获取以下证书,以便在运行配置 IdM 服务器的 ipa-advise
脚本时添加它们:
- 已直接为 <EXAMPLE.ORG> CA 签发证书的 root CA 的证书,或通过一个或多个子 CA 签发。您可以从认证机构发布证书的网页下载证书链。详情请查看 配置浏览器来启用证书身份验证 中的步骤 1 - 4a。
-
IdM CA 证书。您可以从运行 IdM CA 实例的 IdM 服务器上的
/etc/ipa/ca.crt
文件获取 CA 证书。 - 所有中间 CA 的证书;即 <EXAMPLE.ORG> CA 和 IdM CA 之间的中间证书。
为智能卡验证配置 IdM 服务器:
- 以 PEM 格式获取 CA 证书的文件。
-
运行内置的
ipa-advise
脚本。 - 重新加载系统配置。
先决条件
- 有到 IdM 服务器的 root 访问权限。
- 您有 root CA 证书和所有中间 CA 证书。
流程
创建要进行配置的目录:
[root@server]# mkdir ~/SmartCard/
进入该目录:
[root@server]# cd ~/SmartCard/
获取存储在 PEM 格式文件中的相关 CA 证书。如果您的 CA 证书以不同格式的文件存储,如 DER,将其转换为 PEM 格式。IdM 证书颁发机构证书采用 PEM 格式,位于
/etc/ipa/ca.crt
文件中。将 DER 文件转换为 PEM 文件:
# openssl x509 -in <filename>.der -inform DER -out <filename>.pem -outform PEM
为方便起见,将证书复制到您要进行配置的目录中:
[root@server SmartCard]# cp /tmp/rootca.pem ~/SmartCard/ [root@server SmartCard]# cp /tmp/subca.pem ~/SmartCard/ [root@server SmartCard]# cp /tmp/issuingca.pem ~/SmartCard/
可选:如果您使用外部证书颁发机构的证书,请使用
openssl x509
实用程序查看PEM
格式的文件的内容,以检查Issuer
和Subject
值是否正确:[root@server SmartCard]# openssl x509 -noout -text -in rootca.pem | more
使用管理员的权限生成带有内置
ipa-advise
工具的配置脚本:[root@server SmartCard]# kinit admin [root@server SmartCard]# ipa-advise config-server-for-smart-card-auth > config-server-for-smart-card-auth.sh
config-server-for-smart-card-auth.sh
脚本执行以下操作:- 它配置 IdM Apache HTTP 服务器。
- 它在 KDC(Key Distribution Center)中启用 PKINIT(Public Key Cryptography for Initial Authentication in Kerberos)。
- 它将 IdM Web UI 配置为接受智能卡授权请求。
执行脚本,将包含 root CA 和子 CA 证书的 PEM 文件添加为参数:
[root@server SmartCard]# chmod +x config-server-for-smart-card-auth.sh [root@server SmartCard]# ./config-server-for-smart-card-auth.sh rootca.pem subca.pem issuingca.pem Ticket cache:KEYRING:persistent:0:0 Default principal: admin@IDM.EXAMPLE.COM [...] Systemwide CA database updated. The ipa-certupdate command was successful
注意在任何子 CA 证书前,确保将 root CA 的证书添加为参数,并且 CA 或子 CA 证书还没有过期。
可选: 如果发布用户证书的证书颁发机构不提供任何在线证书状态协议(OCSP)响应程序,您可能需要禁用对 IdM Web UI 进行身份验证的 OCSP 检查:
在
/etc/httpd/conf.d/ssl.conf
文件中将SSLOCSPEnable
参数设置为off
:SSLOCSPEnable off
重启 Apache 守护进程(httpd)使更改立即生效:
[root@server SmartCard]# systemctl restart httpd
警告如果您只使用 IdM CA 发出的用户证书,不要禁用 OCSP 检查。OCSP 响应器是 IdM 的一部分。
有关如何启用 OCSP 检查的说明,以及如果 IdM 服务器不包含发布用户证书侦听 OCSP 服务请求的位置信息,请参阅 Apache mod_ssl 配置选项 中的
SSLOCSPDefaultResponder
指令。
该服务器现在被配置为智能卡验证。
要在整个拓扑中启用智能卡验证,请在每个 IdM 服务器中运行操作过程。
7.2. 使用 Ansible 为智能卡验证配置 IdM 服务器
您可以使用 Ansible 为由身份管理(IdM) CA 域的证书颁发机构(CA)发布的用户启用智能卡验证。要做到这一点,您必须获取以下证书,以便在使用 ipasmartcard_server
ansible-freeipa
角色脚本运行 Ansible playbook 时使用这些证书:
- 已直接为 <EXAMPLE.ORG> CA 签发证书的 root CA 的证书,或通过一个或多个子 CA 签发。您可以从认证机构发布证书的网页下载证书链。详情请参阅 配置浏览器中的第 4 步以启用证书身份验证。
-
IdM CA 证书。您可以从任何 IdM CA 服务器上的
/etc/ipa/ca.crt
文件中获取 CA 证书。 - 在 <EXAMPLE.ORG> CA 和 IdM CA 之间中间所有 CA 的证书。
先决条件
-
您有到 IdM 服务器的
root
访问权限。 -
您需要知道 IdM
admin
密码。 - 您有 root CA 证书、IdM CA 证书和所有中间 CA 证书。
您已配置了 Ansible 控制节点以满足以下要求:
- 您使用 Ansible 版本 2.13 或更高版本。
-
您已安装
ansible-freeipa
软件包。 - 示例假定在 ~/MyPlaybooks/ 目录中,您已创建了一个带有 IdM 服务器的完全限定域名(FQDN)的 Ansible 清单文件。
-
示例假定 secret.yml Ansible vault 存储了
ipaadmin_password
。
-
目标节点(这是执行
ansible-freeipa
模块的节点)是 IdM 域的一部分,来作为 IdM 客户端、服务器或副本。
流程
如果您的 CA 证书存储在不同格式的文件中,如
DER
,请将其转换为PEM
格式:# openssl x509 -in <filename>.der -inform DER -out <filename>.pem -outform PEM
IdM 证书颁发机构证书采用
PEM
格式,位于/etc/ipa/ca.crt
文件中。可选:使用
openssl x509
工具查看PEM
格式的文件内容,以检查Issuer
和Subject
值是否正确:# openssl x509 -noout -text -in root-ca.pem | more
进入您的 ~/MyPlaybooks/ 目录:
$ cd ~/MyPlaybooks/
创建专用于 CA 证书的子目录:
$ mkdir SmartCard/
为方便起见,将所有必需的证书复制到 ~/MyPlaybooks/SmartCard/ 目录中:
# cp /tmp/root-ca.pem ~/MyPlaybooks/SmartCard/ # cp /tmp/intermediate-ca.pem ~/MyPlaybooks/SmartCard/ # cp /etc/ipa/ca.crt ~/MyPlaybooks/SmartCard/ipa-ca.crt
在 Ansible 清单文件中,指定以下内容:
- 要为智能卡验证配置的 IdM 服务器。
- IdM 管理员密码。
CA 的证书路径按以下顺序排列:
- root CA 证书文件
- 中间 CA 证书文件
- IdM CA 证书文件
该文件可如下所示:
[ipaserver] ipaserver.idm.example.com [ipareplicas] ipareplica1.idm.example.com ipareplica2.idm.example.com [ipacluster:children] ipaserver ipareplicas [ipacluster:vars] ipaadmin_password= "{{ ipaadmin_password }}" ipasmartcard_server_ca_certs=/home/<user_name>/MyPlaybooks/SmartCard/root-ca.pem,/home/<user_name>/MyPlaybooks/SmartCard/intermediate-ca.pem,/home/<user_name>/MyPlaybooks/SmartCard/ipa-ca.crt
使用以下内容创建
install-smartcard-server.yml
playbook:--- - name: Playbook to set up smart card authentication for an IdM server hosts: ipaserver become: true roles: - role: ipasmartcard_server state: present
- 保存该文件。
运行 Ansible playbook。指定 playbook 文件、存储保护 secret.yml 文件的密码,以及清单文件:
$ ansible-playbook --vault-password-file=password_file -v -i inventory install-smartcard-server.yml
ipasmartcard_server
Ansible 角色执行以下操作:- 它配置 IdM Apache HTTP 服务器。
- 它在 KDC(Key Distribution Center)中启用 PKINIT(Public Key Cryptography for Initial Authentication in Kerberos)。
- 它将 IdM Web UI 配置为接受智能卡授权请求。
可选: 如果发布用户证书的证书颁发机构不提供任何在线证书状态协议(OCSP)响应程序,您可能需要禁用对 IdM Web UI 进行身份验证的 OCSP 检查:
以
root
身份连接到 IdM 服务器:ssh root@ipaserver.idm.example.com
在
/etc/httpd/conf.d/ssl.conf
文件中将SSLOCSPEnable
参数设置为off
:SSLOCSPEnable off
重启 Apache 守护进程(httpd)使更改立即生效:
# systemctl restart httpd
警告如果您只使用 IdM CA 发出的用户证书,不要禁用 OCSP 检查。OCSP 响应器是 IdM 的一部分。
有关如何启用 OCSP 检查的说明,以及如果 IdM 服务器不包含发布用户证书侦听 OCSP 服务请求的位置信息,请参阅 Apache mod_ssl 配置选项 中的
SSLOCSPDefaultResponder
指令。
清单文件中列出的服务器现在被配置为智能卡验证。
要在整个拓扑中启用智能卡验证,请将 Ansible playbook 中的 hosts
变量设置为 ipacluster
:
---
- name: Playbook to setup smartcard for IPA server and replicas
hosts: ipacluster
[...]
其它资源
-
在
/usr/share/doc/ansible-freeipa/playbooks/
目录中使用ipasmartcard_server
角色的 playbook 示例
7.3. 为智能卡验证配置 IdM 客户端
按照以下流程为智能卡验证配置 IdM 客户端。这个过程需要在每个 IdM 系统、客户端或服务器中运行,您希望在使用智能卡进行身份验证时连接到这些系统。例如,若要启用从主机 A 到主机 B 的 ssh
连接,需要在主机 B 上运行 脚本。
作为管理员,运行这个步骤来启用智能卡验证
ssh
协议详情请查看 使用智能卡验证配置 SSH 访问。
- 控制台登录
- GNOME 显示管理器(GDM)
-
su
命令
向 IdM Web UI 进行身份验证时不需要这个过程。对 IdM Web UI 进行身份验证涉及两个主机,它们都需要是 IdM 客户端:
- 运行浏览器的计算机。机器可以位于 IdM 域之外。
-
在其上运行
httpd
的 IdM 服务器。
以下流程假设您在 IdM 客户端而不是 IdM 服务器中配置智能卡验证。因此,您需要两台计算机:IdM 服务器生成配置脚本,以及运行该脚本的 IdM 客户端。
先决条件
- 为智能卡验证配置了您的 IdM 服务器,如 为智能卡验证配置 IdM 服务器 所述。
- 有对 IdM 服务器和 IdM 客户端的 root 访问权限。
- 您有 root CA 证书和所有中间 CA 证书。
-
已使用
--mkhomedir
选项安装 IdM 客户端,以确保远程用户可以成功登录。如果您没有创建主目录,则默认登录位置为目录结构的根目录/
。
流程
在 IdM 服务器上,使用管理员的权限生成带有
ipa-advise
的配置脚本:[root@server SmartCard]# kinit admin [root@server SmartCard]# ipa-advise config-client-for-smart-card-auth > config-client-for-smart-card-auth.sh
config-client-for-smart-card-auth.sh
脚本执行以下操作:- 它配置智能卡守护进程。
- 它设置系统范围的信任存储。
- 它配置系统安全服务守护进程 (SSSD),允许用户使用其用户名和密码或其智能卡进行验证。有关智能卡验证的 SSSD 配置集选项的详情,请参考 RHEL 中的智能卡验证选项。
从 IdM 服务器中,将脚本复制到 IdM 客户端机器中选择的目录中:
[root@server SmartCard]# scp config-client-for-smart-card-auth.sh root@client.idm.example.com:/root/SmartCard/ Password: config-client-for-smart-card-auth.sh 100% 2419 3.5MB/s 00:00
为了方便起见,将 IdM 服务器上的 PEM 格式的 CA 证书文件复制到 IdM 客户端机器上与在上一步中所使用的相同的目录中:
[root@server SmartCard]# scp {rootca.pem,subca.pem,issuingca.pem} root@client.idm.example.com:/root/SmartCard/ Password: rootca.pem 100% 1237 9.6KB/s 00:00 subca.pem 100% 2514 19.6KB/s 00:00 issuingca.pem 100% 2514 19.6KB/s 00:00
在客户端机器上执行 脚本,将包含 CA 证书的 PEM 文件添加为参数:
[root@client SmartCard]# kinit admin [root@client SmartCard]# chmod +x config-client-for-smart-card-auth.sh [root@client SmartCard]# ./config-client-for-smart-card-auth.sh rootca.pem subca.pem issuingca.pem Ticket cache:KEYRING:persistent:0:0 Default principal: admin@IDM.EXAMPLE.COM [...] Systemwide CA database updated. The ipa-certupdate command was successful
注意在任何子 CA 证书前,确保将 root CA 的证书添加为参数,并且 CA 或子 CA 证书还没有过期。
现在为智能卡验证配置了客户端。
7.4. 使用 Ansible 为智能卡验证配置 IdM 客户端
按照以下流程,使用 ansible-freeipa
ipasmartcard_client
模块配置特定的身份管理(IdM)客户端,以允许 IdM 用户使用智能卡进行身份验证。运行这个步骤,为使用以下任一方式访问 IdM 的 IdM 用户启用智能卡验证:
ssh
协议详情请查看 使用智能卡验证配置 SSH 访问。
- 控制台登录
- GNOME 显示管理器(GDM)
-
su
命令
向 IdM Web UI 进行身份验证时不需要这个过程。对 IdM Web UI 进行身份验证涉及两个主机,它们都需要是 IdM 客户端:
- 运行浏览器的计算机。机器可以位于 IdM 域之外。
-
在其上运行
httpd
的 IdM 服务器。
先决条件
- 为智能卡验证配置了您的 IdM 服务器,如 使用 Ansible 为智能卡验证配置 IdM 服务器 中所述。
- 有对 IdM 服务器和 IdM 客户端的 root 访问权限。
- 您有 root CA 证书、IdM CA 证书和所有中间 CA 证书。
您已配置了 Ansible 控制节点以满足以下要求:
- 您使用 Ansible 版本 2.13 或更高版本。
-
您已安装
ansible-freeipa
软件包。 - 示例假定在 ~/MyPlaybooks/ 目录中,您已创建了一个带有 IdM 服务器的完全限定域名(FQDN)的 Ansible 清单文件。
-
示例假定 secret.yml Ansible vault 存储了
ipaadmin_password
。
-
目标节点(这是执行
ansible-freeipa
模块的节点)是 IdM 域的一部分,来作为 IdM 客户端、服务器或副本。
流程
如果您的 CA 证书存储在不同格式的文件中,如
DER
,请将其转换为PEM
格式:# openssl x509 -in <filename>.der -inform DER -out <filename>.pem -outform PEM
IdM CA 证书采用
PEM
格式,位于/etc/ipa/ca.crt
文件中。可选:使用
openssl x509
工具查看PEM
格式的文件内容,以检查Issuer
和Subject
值是否正确:# openssl x509 -noout -text -in root-ca.pem | more
在 Ansible 控制节点上,导航到 ~/MyPlaybooks/ 目录:
$ cd ~/MyPlaybooks/
创建专用于 CA 证书的子目录:
$ mkdir SmartCard/
为方便起见,将所有必需的证书复制到 ~/MyPlaybooks/SmartCard/ 目录中,例如:
# cp /tmp/root-ca.pem ~/MyPlaybooks/SmartCard/ # cp /tmp/intermediate-ca.pem ~/MyPlaybooks/SmartCard/ # cp /etc/ipa/ca.crt ~/MyPlaybooks/SmartCard/ipa-ca.crt
在 Ansible 清单文件中,指定以下内容:
- 要为智能卡验证配置的 IdM 客户端。
- IdM 管理员密码。
CA 的证书路径按以下顺序排列:
- root CA 证书文件
- 中间 CA 证书文件
- IdM CA 证书文件
该文件可如下所示:
[ipaclients] ipaclient1.example.com ipaclient2.example.com [ipaclients:vars] ipaadmin_password=SomeADMINpassword ipasmartcard_client_ca_certs=/home/<user_name>/MyPlaybooks/SmartCard/root-ca.pem,/home/<user_name>/MyPlaybooks/SmartCard/intermediate-ca.pem,/home/<user_name>/MyPlaybooks/SmartCard/ipa-ca.crt
使用以下内容创建
install-smartcard-clients.yml
playbook:--- - name: Playbook to set up smart card authentication for an IdM client hosts: ipaclients become: true roles: - role: ipasmartcard_client state: present
- 保存该文件。
运行 Ansible playbook。指定 playbook 和清单文件:
$ ansible-playbook --vault-password-file=password_file -v -i inventory install-smartcard-clients.yml
ipasmartcard_client
Ansible 角色执行以下操作:- 它配置智能卡守护进程。
- 它设置系统范围的信任存储。
- 它配置系统安全服务守护进程(SSSD),以允许用户使用其用户名和密码或其智能卡进行验证。有关智能卡验证的 SSSD 配置集选项的详情,请参考 RHEL 中的智能卡验证选项。
现在,清单文件的 ipaclients 部分中列出的客户端被配置为智能卡验证。
如果您使用 --mkhomedir
选项安装了 IdM 客户端,则远程用户可以登录到他们的主目录。否则,默认登录位置是目录结构的根目录 /
。
其它资源
-
在
/usr/share/doc/ansible-freeipa/playbooks/
目录中使用ipasmartcard_server
角色的 playbook 示例
7.5. 在 IdM Web UI 的用户条目中添加证书
按照以下流程,向 IdM Web UI 中的用户条目中添加一个外部证书。
也可以将证书映射数据上传到 IdM 中的用户条目,而不必上传整个证书。包含完整证书或证书映射数据的用户条目可以和相应的证书映射规则一起使用,以便于系统管理员配置智能卡验证。详情请查看
如果用户的证书由 IdM 证书颁发机构发布,则证书已存储在用户条目中,您不需要按照此流程操作。
先决条件
- 您有要添加到用户条目的证书。
流程
- 如果要向另一个用户添加证书,请以管理员身份登录到 IdM Web UI。要在您自己的配置集中添加证书,您不需要管理员的凭证。
-
导航到
Users
→Active users
→sc_user
。 -
找到
Certificate
选项,并单击Add
。 在命令行中,使用
cat
实用程序或文本编辑器以PEM
格式显示证书:[user@client SmartCard]$ cat testuser.crt
- 将 CLI 中的证书复制并粘贴到 Web UI 中打开的窗口中。
单击
Add
。图 7.1. 在 IdM Web UI 中添加新证书
sc_user
条目现在包含一个外部证书。
7.6. 在 IdM CLI 中的用户条目中添加证书
按照以下流程,将外部证书添加到 IdM CLI 中的用户条目中。
也可以将证书映射数据上传到 IdM 中的用户条目,而不必上传整个证书。包含完整证书或证书映射数据的用户条目可以和相应的证书映射规则一起使用,以便于系统管理员配置智能卡验证。详情请参阅 配置身份验证的证书映射规则。
如果用户的证书由 IdM 证书颁发机构发布,则证书已存储在用户条目中,您不需要按照此流程操作。
先决条件
- 您有要添加到用户条目的证书。
流程
如果要为另一个用户添加证书,请以管理员身份登录到 IdM CLI:
[user@client SmartCard]$ kinit admin
要在您自己的配置集中添加证书,您不需要管理员的凭证:
[user@client SmartCard]$ kinit sc_user
创建一个包含证书的环境变量,该变量移除了标头和页脚并将其串联到一行中,这是
ipa user-add-cert
命令预期的格式:[user@client SmartCard]$ export CERT=`openssl x509 -outform der -in testuser.crt | base64 -w0 -`
请注意,
testuser.crt
文件中的证书必须是PEM 格式
。使用
ipa user-add-cert
命令将证书添加到 sc_user 的配置集:[user@client SmartCard]$ ipa user-add-cert sc_user --certificate=$CERT
sc_user
条目现在包含一个外部证书。
7.7. 安装用来管理和使用智能卡的工具
先决条件
-
gnutls-utils
软件包已安装。 -
opensc
软件包已安装。 -
pcscd
服务正在运行。
在配置智能卡前,您必须安装相应的工具,该工具可以生成证书,并启动 pscd
服务。
流程
安装
opensc
和gnutls-utils
软件包:# yum -y install opensc gnutls-utils
启动
pcscd
服务。# systemctl start pcscd
验证
验证
pcscd
服务是否已启动并运行# systemctl status pcscd
7.8. 准备智能卡并将证书和密钥上传到智能卡
按照以下流程,使用 pkcs15-init
工具配置智能卡,该工具可帮助您进行配置:
- 擦除智能卡
- 设置新的 PIN 和可选的 PIN Unblocking Keys(PUKs)
- 在智能卡上创建新插槽
- 在插槽存储证书、私钥和公钥
- 如果需要,请锁定智能卡设置,因为某些智能卡需要这个类型的最终化
pkcs15-init
工具可能无法使用所有智能卡。您必须使用您使用智能卡的工具。
先决条件
已安装
opensc
软件包,其中包括pkcs15-init
工具。如需了解更多详细信息,请参阅 安装用于管理和使用智能卡的工具。
- 该卡插入读卡器并连接到计算机。
-
您有一个要存储在智能卡上的私钥、公钥和证书。在此过程中,
testuser.key
、testuserpublic.key
和testuser.crt
是用于私钥、公钥和证书的名称。 - 您有当前的智能卡用户 PIN 和 Security Officer PIN (SO-PIN)。
流程
擦除智能卡并使用您的 PIN 验证自己:
$ pkcs15-init --erase-card --use-default-transport-keys Using reader with a card: Reader name PIN [Security Officer PIN] required. Please enter PIN [Security Officer PIN]:
这个卡已经被清除。
初始化智能卡,设置您的用户 PIN 和 PUK,以及您的安全响应 PIN 和 PUK:
$ pkcs15-init --create-pkcs15 --use-default-transport-keys \ --pin 963214 --puk 321478 --so-pin 65498714 --so-puk 784123 Using reader with a card: Reader name
pcks15-init
工具在智能卡上创建新插槽。为插槽设置标签和验证 ID:
$ pkcs15-init --store-pin --label testuser \ --auth-id 01 --so-pin 65498714 --pin 963214 --puk 321478 Using reader with a card: Reader name
标签设置为人类可读值,本例中为
testuser
。auth-id
必须是两个十六进制值,在本例中设为01
。在智能卡的新插槽中存储并标记私钥:
$ pkcs15-init --store-private-key testuser.key --label testuser_key \ --auth-id 01 --id 01 --pin 963214 Using reader with a card: Reader name
注意在存储您的私钥并将证书存储在下一步中时,您为
--id
指定的值必须相同。建议为--id
指定自己的值,否则它们将更复杂的值由工具计算。在智能卡上的新插槽中存储并标记该证书:
$ pkcs15-init --store-certificate testuser.crt --label testuser_crt \ --auth-id 01 --id 01 --format pem --pin 963214 Using reader with a card: Reader name
可选:在智能卡的新插槽中保存并标记公钥:
$ pkcs15-init --store-public-key testuserpublic.key \ --label testuserpublic_key --auth-id 01 --id 01 --pin 963214 Using reader with a card: Reader name
注意如果公钥与私钥或证书对应,请指定与私钥或证书的 ID 相同的 ID。
可选:某些智能卡要求您通过锁定设置来完成卡:
$ pkcs15-init -F
此时您的智能卡在新创建的插槽中包含证书、私钥和公钥。您还创建了您的用户 PIN 和 PUK,以及安全响应 PIN 和 PUK。
7.9. 使用智能卡登录到 IdM
按照以下流程,使用智能卡登录到 IdM Web UI。
先决条件
- web 浏览器被配置为使用智能卡验证。
- IdM 服务器被配置为智能卡验证。
- 在您的智能卡中安装的证书由 IdM 服务器发出,或者已添加到 IdM 的用户条目中。
- 您知道解锁智能卡所需的 PIN。
- 智能卡已插入到读取器中。
流程
- 在浏览器中打开 IdM Web UI。
点使用证书登陆。
如果 "密码必需" 对话框打开,请添加 PIN 来解锁智能卡,然后单击 确定 按钮。
此时会打开 User Identification Request 对话框。
如果智能卡包含多个证书,请在下方 Choose a certificate 作为标识的下拉列表中选择您要用于验证的证书。
- 点确定按钮。
现在,您已成功登录到 IdM Web UI。
7.10. 在 IdM 客户端中使用智能卡验证登录到 GDM
GNOME 桌面管理器(GDM)需要身份验证。您可以使用您的密码,但是,您也可以使用智能卡进行身份验证。
按照以下流程,使用智能卡验证来访问 GDM。
先决条件
- 为智能卡验证配置了系统。详情请参阅为智能卡验证配置 IdM 客户端。
- 该智能卡包含您的证书和私钥。
- 该用户帐户是 IdM 域的成员。
智能卡上的证书通过以下方式映射到用户条目:
- 为特定用户条目分配证书。详情请参阅 在 IdM Web UI 中向用户条目添加证书 或 在 IdM CLI 中向用户条目添加证书 。
- 应用到该帐户的证书映射数据。详情请查看 用于在智能卡上配置身份验证的证书映射规则。
流程
- 在读取器中插入智能卡。
- 输入智能卡 PIN。
- 点 Sign In。
您已成功登录到 RHEL 系统,并且您提供了一个由 IdM 服务器提供的 TGT。
验证
在终端窗口中 输入
klist
并检查结果:$ klist Ticket cache: KEYRING:persistent:1358900015:krb_cache_TObtNMd Default principal: example.user@REDHAT.COM Valid starting Expires Service principal 04/20/2020 13:58:24 04/20/2020 23:58:24 krbtgt/EXAMPLE.COM@EXAMPLE.COM renew until 04/27/2020 08:58:15
7.11. 在 su 命令中使用智能卡验证
切换到其他用户需要身份验证。您可以使用密码或证书。按照以下流程,通过 su
命令使用智能卡。这意味着输入 su
命令后,系统会提示您输入智能卡 PIN。
先决条件
为智能卡验证配置了您的 IdM 服务器和客户端。
- 该智能卡包含您的证书和私钥。请参阅智能卡中的证书
- 该卡插入读卡器并连接到计算机。
流程
在终端窗口中,使用
su
命令切换到其他用户:$ su - example.user PIN for smart_card
如果配置正确,会提示您输入智能卡 PIN。
第 8 章 为 IdM 中智能卡验证配置 ADCS 发布的证书
要在 IdM 中为其证书是由活动目录(AD)证书服务发布的用户配置智能卡验证:
- 您的部署基于 Identity Management(IdM)和 Active Directory(AD)之间的跨林信任。
- 您需要为存储在 AD 中的帐户的用户允许智能卡验证。
- 证书创建并存储在 Active Directory 证书服务(ADCS)中。
有关智能卡验证的概述,请参阅了解智能卡验证。
配置通过以下步骤完成:
先决条件
已安装身份管理(IdM)和 Active Directory(AD)信任
详情请参阅在 IdM 和 AD 之间安装信任。
- 已安装 Active Directory 证书服务(ADCS),并且为用户生成证书
8.1. 信任配置和证书使用量所需的 Windows 服务器设置
您必须在 Windows 服务器上配置以下内容:
- 已安装 Active Directory 证书服务(ADCS)
- 创建证书颁发机构
- 可选:如果您使用证书颁发机构 Web 注册,则必须配置互联网信息服务(IIS)
导出证书:
-
key 必须具有
2048
位或更多 - 包括一个私钥
您将需要采用以下格式的证书:个人信息 Exchange SAS
- PKCS #12(.PFX
)- 启用证书隐私
8.2. 使用 sftp 从 Active Directory 复制证书
要能够使用智能卡验证,您需要复制以下证书文件:
-
CER
格式的根 CA 证书:IdM服务器上的 adcs-winserver-ca.cer
。 -
具有
PFX
格式私钥的用户证书:IdM 客户端上的aduser1.pfx
。
这个过程预期 SSH 访问是允许的。如果 SSH 不可用,用户必须将 文件从 AD 服务器复制到 IdM 服务器和客户端。
流程
从 IdM 服务器 连接,并将
adcs-winserver-ca.cer
root 证书复制到 IdM 服务器:root@idmserver ~]# sftp Administrator@winserver.ad.example.com Administrator@winserver.ad.example.com's password: Connected to Administrator@winserver.ad.example.com. sftp> cd <Path to certificates> sftp> ls adcs-winserver-ca.cer aduser1.pfx sftp> sftp> get adcs-winserver-ca.cer Fetching <Path to certificates>/adcs-winserver-ca.cer to adcs-winserver-ca.cer <Path to certificates>/adcs-winserver-ca.cer 100% 1254 15KB/s 00:00 sftp quit
从 IdM 客户端 连接,并将
aduser1.pfx
用户证书复制到客户端:[root@client1 ~]# sftp Administrator@winserver.ad.example.com Administrator@winserver.ad.example.com's password: Connected to Administrator@winserver.ad.example.com. sftp> cd /<Path to certificates> sftp> get aduser1.pfx Fetching <Path to certificates>/aduser1.pfx to aduser1.pfx <Path to certificates>/aduser1.pfx 100% 1254 15KB/s 00:00 sftp quit
现在,CA 证书保存在 IdM 服务器中,用户证书存储在客户端机器中。
8.3. 使用 ADCS 证书为智能卡验证配置 IdM 服务器和客户端
您必须配置 IdM(身份管理)服务器和客户端,以便在 IdM 环境中使用智能卡验证。IdM 包含进行所有必要更改的 ipa-advise
脚本:
- 安装所需的软件包
- 配置 IdM 服务器和客户端
- 将 CA 证书复制到期望的位置
您可以在 IdM 服务器中运行 ipa-advise
。
按照以下流程,为智能卡验证配置服务器和客户端:
-
在 IdM 服务器中:准备
ipa-advise
脚本,为智能卡验证配置 IdM 服务器。 -
在 IdM 服务器中:准备
ipa-advise
脚本,以配置 IdM 客户端以进行智能卡验证。 -
在 IdM 服务器中:使用 AD 证书应用 IdM 服务器上的
ipa-advise
服务器脚本。 - 将客户端脚本移动到 IdM 客户端机器中。
-
在 IdM 客户端上:使用 AD 证书在 IdM 客户端上应用
ipa-advise
客户端脚本。
先决条件
- 证书已复制到 IdM 服务器。
- 获取 Kerberos 票据。
- 以具有管理权限的用户身份登录。
流程
在 IdM 服务器上,使用
ipa-advise
脚本来配置客户端:[root@idmserver ~]# ipa-advise config-client-for-smart-card-auth > sc_client.sh
在 IdM 服务器上,使用
ipa-advise
脚本来配置服务器:[root@idmserver ~]# ipa-advise config-server-for-smart-card-auth > sc_server.sh
在 IdM 服务器中执行脚本:
[root@idmserver ~]# sh -x sc_server.sh adcs-winserver-ca.cer
- 它配置 IdM Apache HTTP 服务器。
- 它在 KDC(Key Distribution Center)中启用 PKINIT(Public Key Cryptography for Initial Authentication in Kerberos)。
- 它将 IdM Web UI 配置为接受智能卡授权请求。
将
sc_client.sh
脚本复制到客户端系统中:[root@idmserver ~]# scp sc_client.sh root@client1.idm.example.com:/root Password: sc_client.sh 100% 2857 1.6MB/s 00:00
将 Windows 证书复制到客户端系统中:
[root@idmserver ~]# scp adcs-winserver-ca.cer root@client1.idm.example.com:/root Password: adcs-winserver-ca.cer 100% 1254 952.0KB/s 00:00
在客户端系统中运行客户端脚本:
[root@idmclient1 ~]# sh -x sc_client.sh adcs-winserver-ca.cer
CA 证书以正确格式安装在 IdM 服务器和客户端系统中,下一步是将用户证书复制到智能卡本身。
8.4. 转换 PFX 文件
在将 PFX(PKCS#12)文件保存到智能卡中前,您必须:
- 将文件转换为 PEM 格式
- 将私钥和证书提取到两个不同的文件中
先决条件
- PFX 文件被复制到 IdM 客户端机器中。
流程
在 IdM 客户端中,采用 PEM 格式:
[root@idmclient1 ~]# openssl pkcs12 -in aduser1.pfx -out aduser1_cert_only.pem -clcerts -nodes Enter Import Password:
将密钥提取到单独的文件中:
[root@idmclient1 ~]# openssl pkcs12 -in adduser1.pfx -nocerts -out adduser1.pem > aduser1.key
将公共证书提取到单独的文件中:
[root@idmclient1 ~]# openssl pkcs12 -in adduser1.pfx -clcerts -nokeys -out aduser1_cert_only.pem > aduser1.crt
此时,您可以将 aduser1.key
和 aduser1.crt
存储在智能卡中。
8.5. 安装用来管理和使用智能卡的工具
先决条件
-
gnutls-utils
软件包已安装。 -
opensc
软件包已安装。 -
pcscd
服务正在运行。
在配置智能卡前,您必须安装相应的工具,该工具可以生成证书,并启动 pscd
服务。
流程
安装
opensc
和gnutls-utils
软件包:# yum -y install opensc gnutls-utils
启动
pcscd
服务。# systemctl start pcscd
验证
验证
pcscd
服务是否已启动并运行# systemctl status pcscd
8.6. 准备智能卡并将证书和密钥上传到智能卡
按照以下流程,使用 pkcs15-init
工具配置智能卡,该工具可帮助您进行配置:
- 擦除智能卡
- 设置新的 PIN 和可选的 PIN Unblocking Keys(PUKs)
- 在智能卡上创建新插槽
- 在插槽存储证书、私钥和公钥
- 如果需要,请锁定智能卡设置,因为某些智能卡需要这个类型的最终化
pkcs15-init
工具可能无法使用所有智能卡。您必须使用您使用智能卡的工具。
先决条件
已安装
opensc
软件包,其中包括pkcs15-init
工具。如需了解更多详细信息,请参阅 安装用于管理和使用智能卡的工具。
- 该卡插入读卡器并连接到计算机。
-
您有一个要存储在智能卡上的私钥、公钥和证书。在此过程中,
testuser.key
、testuserpublic.key
和testuser.crt
是用于私钥、公钥和证书的名称。 - 您有当前的智能卡用户 PIN 和 Security Officer PIN (SO-PIN)。
流程
擦除智能卡并使用您的 PIN 验证自己:
$ pkcs15-init --erase-card --use-default-transport-keys Using reader with a card: Reader name PIN [Security Officer PIN] required. Please enter PIN [Security Officer PIN]:
这个卡已经被清除。
初始化智能卡,设置您的用户 PIN 和 PUK,以及您的安全响应 PIN 和 PUK:
$ pkcs15-init --create-pkcs15 --use-default-transport-keys \ --pin 963214 --puk 321478 --so-pin 65498714 --so-puk 784123 Using reader with a card: Reader name
pcks15-init
工具在智能卡上创建新插槽。为插槽设置标签和验证 ID:
$ pkcs15-init --store-pin --label testuser \ --auth-id 01 --so-pin 65498714 --pin 963214 --puk 321478 Using reader with a card: Reader name
标签设置为人类可读值,本例中为
testuser
。auth-id
必须是两个十六进制值,在本例中设为01
。在智能卡的新插槽中存储并标记私钥:
$ pkcs15-init --store-private-key testuser.key --label testuser_key \ --auth-id 01 --id 01 --pin 963214 Using reader with a card: Reader name
注意在存储您的私钥并将证书存储在下一步中时,您为
--id
指定的值必须相同。建议为--id
指定自己的值,否则它们将更复杂的值由工具计算。在智能卡上的新插槽中存储并标记该证书:
$ pkcs15-init --store-certificate testuser.crt --label testuser_crt \ --auth-id 01 --id 01 --format pem --pin 963214 Using reader with a card: Reader name
可选:在智能卡的新插槽中保存并标记公钥:
$ pkcs15-init --store-public-key testuserpublic.key \ --label testuserpublic_key --auth-id 01 --id 01 --pin 963214 Using reader with a card: Reader name
注意如果公钥与私钥或证书对应,请指定与私钥或证书的 ID 相同的 ID。
可选:某些智能卡要求您通过锁定设置来完成卡:
$ pkcs15-init -F
此时您的智能卡在新创建的插槽中包含证书、私钥和公钥。您还创建了您的用户 PIN 和 PUK,以及安全响应 PIN 和 PUK。
8.7. 在 sssd.conf 中配置超时
使用智能卡证书进行身份验证的时间可能比 SSSD 使用的默认超时时间更长。超时时间可能是由以下原因造成的:
- 慢的读取器
- 从物理设备到虚拟环境的转发
- 保存在智能卡上的证书太多
- 如果使用 OCSP 来验证证书,则来自 OCSP(在线证书状态协议)响应器的响应较慢
在这种情况下,您可以将 sssd.conf
文件中的以下超时时间延长为 60 秒:
-
p11_child_timeout
-
krb5_auth_timeout
先决条件
- 您必须以 root 身份登录。
流程
打开
sssd.conf
文件:[root@idmclient1 ~]# vim /etc/sssd/sssd.conf
更改
p11_child_timeout
的值:[pam] p11_child_timeout = 60
更改
krb5_auth_timeout
的值:[domain/IDM.EXAMPLE.COM] krb5_auth_timeout = 60
- 保存设置。
现在,在验证失败前,允许与智能卡的交互运行 1 分钟(60 秒)。
8.8. 为智能卡验证创建证书映射规则
如果要将一个证书用于 AD(Active Directory)和 IdM(身份管理)中的帐户,您可以在 IdM 服务器上创建证书映射规则。
创建此类规则后,用户可以在两个域中使用其智能卡进行身份验证。
有关证书映射规则的详情,请参阅 配置身份验证的证书映射规则。
第 9 章 在身份管理中配置证书映射规则
证书映射规则是一种便捷的方式,当身份管理(IdM)管理员无法访问某些用户的证书时,用户可以轻松使用证书进行身份验证。这通常是因为证书已由外部证书颁发机构发布。
9.1. 用于配置身份验证的证书映射规则
在以下情况下可能需要配置证书映射规则:
- 证书已由与 IdM 域处于信任关系的活动目录(AD)的证书系统发布。
- 证书由外部证书颁发机构发布。
- IdM 环境较大,其中有很多使用智能卡的用户。在这种情况下,添加完整证书可能会比较复杂。在大多数情况下,主题和签发者是可预测的,因此与完整证书相比,更容易提前添加。
作为系统管理员,您可以创建证书映射规则,并在向特定用户签发证书之前,为用户条目添加证书映射数据。签发证书后,用户可以使用该证书登录,即使完整证书尚未上传到用户条目。
另外,因为证书会定期续订,因此证书映射规则减少了管理开销。续订用户证书时,管理员不必更新用户条目。例如,如果映射基于 Subject
和 Issuer
值,如果新证书的主题和签发者与旧证书相同,则映射仍适用。如果使用完整证书,则管理员必须将新证书上传到用户条目以替换旧证书。
设置证书映射:
- 管理员必须将证书映射数据或完整证书加载到用户帐户中。
- 管理员必须创建证书映射规则,以允许其帐户包含与证书上信息匹配的证书映射数据条目的用户成功登录到 IdM。
创建证书映射规则后,当最终用户提供保存在 文件系统 或 智能卡 上的证书时,身份验证可以成功。
密钥分发中心(KDC)有一个用于证书映射规则的缓存。缓存在第一个 certauth
请求时填充,它有一个硬编码的 300 秒超时。KDC 不会看到对证书映射规则的任何更改,除非它重启了或缓存过期。
有关构成映射规则的单独组件,以及如何获取和使用它们的详细信息,请参阅 IdM 中的身份映射规则组件,以及获取证书中的签发者,以便在匹配规则中使用。
您的证书映射规则可取决于您使用证书的用例。例如,如果您使用带有证书的 SSH,则必须有从证书中提取公钥的完整证书。
9.2. IdM 中身份映射规则的组件
当在 IdM 中创建 身份映射规则 时,您可以配置不同的组件。每个组件都有一个可覆盖的默认值。您可以在 Web UI 或 CLI 中定义这些组件。在 CLI 中,身份映射规则使用 ipa certmaprule-add
命令创建。
- 映射规则
映射规则组件将证书与一个或多个用户帐户关联(或 映射)。规则定义将证书与预期用户帐户关联的 LDAP 搜索过滤器。
不同证书颁发机构(CA)发布的证书可能具有不同的属性,并可在不同的域中使用。因此,IdM 不适用于无条件地应用映射规则,而只适用于适当的证书。使用 匹配规则 定义适当的证书。
请注意,如果您将映射规则选项留空,则证书将在
userCertificate
属性中作为 DER 编码的二进制文件进行搜索。利用
--maprule
选项,在 CLI 中定义映射规则。- 匹配规则
匹配的规则组件选择您要应用映射规则的证书。默认匹配规则与具有
digitalSignature 密钥
用法和clientAuth 扩展密钥
用法的证书匹配。使用
--matchrule
选项,在 CLI 中定义匹配的规则。- 域列表
域列表指定您希望 IdM 在处理身份映射规则时搜索用户的身份域。如果您未指定 选项,IdM 仅在 IdM 客户端所属的本地域中搜索用户。
利用
--domain
选项,在 CLI 中定义域。- 优先级
当多个规则适用于证书时,优先级最高的规则优先。所有其他规则将被忽略。
- 数字值越低,身份映射规则的优先级越高。例如,具有优先级 1 的规则的优先级高于优先级 2 的规则。
- 如果规则没有定义优先级值,它具有最低的优先级。
使用
--priority
选项,在 CLI 中定义映射规则优先级。
证书映射规则示例
要使用 CLI 定义称为 simple_rule
的证书映射规则,如果该证书上的 Subject
与 IdM 中用户帐户中的 certmapdata
条目匹配,则允许对 EXAMPLE.ORG
机构的 智能卡 CA
发布的证书进行身份验证:
# ipa certmaprule-add simple_rule --matchrule '<ISSUER>CN=Smart Card CA,O=EXAMPLE.ORG' --maprule '(ipacertmapdata=X509:<I>{issuer_dn!nss_x500}<S>{subject_dn!nss_x500})'
9.3. 从证书获取数据,以便在匹配规则中使用
这个流程描述了如何从证书获取数据,以便您可以将其复制并粘贴到证书映射规则的匹配规则中。要获得匹配规则所需的数据,请使用 sssctl cert-show
或 sssctl cert-eval-rule
命令。
先决条件
- 您有 PEM 格式的用户证书。
流程
创建指向证书的变量,该变量还可确保正确编码,以便您可以检索所需的数据。
# CERT=$(openssl x509 -in /path/to/certificate -outform der|base64 -w0)
使用
sssctl cert-eval-rule
来确定匹配的数据。在以下示例中,使用了证书序列号。# sssctl cert-eval-rule $CERT --match='<ISSUER>CN=adcs19-WIN1-CA,DC=AD,DC=EXAMPLE,DC=COM' --map='LDAPU1:(altSecurityIdentities=X509:<I>{issuer_dn!ad_x500}<SR>{serial_number!hex_ur})' Certificate matches rule. Mapping filter: (altSecurityIdentities=X509:<I>DC=com,DC=example,DC=ad,CN=adcs19-WIN1-CA<SR>0F0000000000DB8852DD7B246C9C0F0000003B)
在这种情况下,将
altSecurityIdentities=
后的所有内容添加到 AD 中用户的altSecurityIdentities
属性中。如果使用 SKI 映射,请使用--map='LDAPU1: (altSecurityIdentities=X509:<SKI>{subject_key_id!hex_u})'
。可选: 要在 CLI 中基于匹配规则创建一个新的映射规则,该规则指定证书签发者必须与
ad.example.com
域的adcs19-WIN1-CA
匹配,证书的序列号必须与用户帐户中的altSecurityIdentities
条目匹配:# ipa certmaprule-add simple_rule --matchrule '<ISSUER>CN=adcs19-WIN1-CA,DC=AD,DC=EXAMPLE,DC=COM' --maprule 'LDAPU1:(altSecurityIdentities=X509:<I>{issuer_dn!ad_x500}<SR>{serial_number!hex_ur})'
9.4. 为存储在 IdM 中的用户配置证书映射
如果用户的证书身份验证被配置为存储在 IdM 中,要在 IdM 中启用证书映射,系统管理员必须完成以下任务:
- 设置证书映射规则,以便具有与映射规则及其证书映射数据条目中指定的条件匹配的证书的 IdM 用户可以向 IdM 进行身份验证。
- 将证书映射数据输入到 IdM 用户条目中,以便用户可以使用多个证书进行身份验证,只要它们都包含证书映射数据条目中指定的值。
先决条件
- 用户在 IdM 中有一个帐户。
- 管理员拥有要添加到用户条目的整个证书或证书映射数据。
9.4.1. 在 IdM Web UI 中添加一个证书映射规则
- 以管理员身份登录 IdM Web UI。
-
导航到
Authentication
→Certificate Identity Mapping Rules
→Certificate Identity Mapping Rules
。 单击
Add
。图 9.1. 在 IdM Web UI 中添加一个新的证书映射规则
- 输入规则名称。
输入映射规则。例如,要让 IdM 搜索提供给它们的任何证书中的
Issuer
和Subject
条目,并根据所显示证书的两个条目中提供的信息做出验证决定:(ipacertmapdata=X509:<I>{issuer_dn!nss_x500}<S>{subject_dn!nss_x500})
输入匹配的规则。例如,只允许
EXAMPLE.ORG
机构智能卡 CA
发布的证书来验证用户到 IdM:<ISSUER>CN=Smart Card CA,O=EXAMPLE.ORG
图 9.2. 在 IdM Web UI 中输入证书映射规则的详情
-
单击对话框底部的
Add
,以添加该规则并关闭该框。 系统安全服务守护进程(SSSD)定期重新读取证书映射规则。要强制立即载入新创建的规则,重启 SSSD:
# systemctl restart sssd
现在,您设置了证书映射规则,可将在智能卡证书中找到的映射规则中指定的数据类型与 IdM 用户条目中的证书映射数据进行比较。找到匹配项后,它将对匹配的用户进行身份验证。
9.4.2. 在 IdM CLI 中添加证书映射规则
获得管理员凭证:
# kinit admin
输入映射规则以及映射规则所基于的匹配规则。例如,要让 IdM 搜索所呈现的任何证书中的
发行者和
Subject
条目,并基于所显示证书的两个条目中找到的信息进行身份验证,仅识别由EXAMPLE.ORG
机构的智能卡 CA
发布的证书:# ipa certmaprule-add
rule_name
--matchrule '<ISSUER>CN=Smart Card CA,O=EXAMPLE.ORG' --maprule '(ipacertmapdata=X509:<I>{issuer_dn!nss_x500}<S>{subject_dn!nss_x500})' ------------------------------------------------------- Added Certificate Identity Mapping Rule "rule_name" ------------------------------------------------------- Rule name: rule_name Mapping rule: (ipacertmapdata=X509:<I>{issuer_dn!nss_x500}<S>{subject_dn!nss_x500}) Matching rule: <ISSUER>CN=Smart Card CA,O=EXAMPLE.ORG Enabled: TRUE系统安全服务守护进程(SSSD)定期重新读取证书映射规则。要强制立即载入新创建的规则,重启 SSSD:
# systemctl restart sssd
现在,您设置了证书映射规则,可将在智能卡证书中找到的映射规则中指定的数据类型与 IdM 用户条目中的证书映射数据进行比较。找到匹配项后,它将对匹配的用户进行身份验证。
9.4.3. 在 IdM Web UI 中添加证书映射数据到用户条目
- 以管理员身份登录 IdM Web UI。
-
导航到
Users
→Active users
→idm_user
。 -
查找
证书映射数据
选项并单击Add
。 选择以下选项之一:
如果您有
idm_user
的证书:在命令行中,使用
cat
实用程序或文本编辑器显示证书:[root@server ~]# cat idm_user_certificate.pem -----BEGIN CERTIFICATE----- MIIFFTCCA/2gAwIBAgIBEjANBgkqhkiG9w0BAQsFADA6MRgwFgYDVQQKDA9JRE0u RVhBTVBMRS5DT00xHjAcBgNVBAMMFUNlcnRpZmljYXRlIEF1dGhvcml0eTAeFw0x ODA5MDIxODE1MzlaFw0yMDA5MDIxODE1MzlaMCwxGDAWBgNVBAoMD0lETS5FWEFN [...output truncated...]
- 复制证书。
在 IdM Web UI 中,单击
Certificate
旁边的Add
,并将证书粘贴到打开的窗口中。图 9.3. 添加用户证书映射数据:证书
-
如果您没有
idm_user
证书,但知道证书的Issuer
和Subject
,请检查Issuer and subject
单选按钮,并在两个框中分别输入值。
图 9.4. 添加用户证书映射数据:签发者和主题
-
如果您没有
-
单击
Add
。
验证
如果您可以访问 .pem
格式的整个证书,请验证是否用户和证书已链接:
使用
sss_cache
程序在 SSSD 缓存中使idm_user
记录无效,并强制重新载入idm_user
信息:# sss_cache -u idm_user
使用包含 IdM 用户证书的文件名称运行
ipa certmap-match
命令:# ipa certmap-match idm_user_cert.pem -------------- 1 user matched -------------- Domain: IDM.EXAMPLE.COM User logins: idm_user ---------------------------- Number of entries returned 1 ----------------------------
输出确认您现在已将证书映射数据添加到
idm_user
,并且存在对应的映射规则。这意味着,您可以使用与定义的证书映射数据匹配的任何证书,以idm_user
进行身份验证。
9.4.4. 在 IdM CLI 中添加证书映射数据到用户条目
获得管理员凭证:
# kinit admin
选择以下选项之一:
-
如果您有
idm_user
的证书,请使用ipa user-add-cert
命令将证书添加到用户帐户中:
# CERT=$(openssl x509 -in idm_user_cert.pem -outform der|base64 -w0) # ipa user-add-certmapdata idm_user --certificate $CERT
如果您没有
idm_user
的证书,但知道用户证书的Issuer
和Subject
:# ipa user-add-certmapdata idm_user --subject "O=EXAMPLE.ORG,CN=test" --issuer "CN=Smart Card CA,O=EXAMPLE.ORG" -------------------------------------------- Added certificate mappings to user "idm_user" -------------------------------------------- User login: idm_user Certificate mapping data: X509:<I>O=EXAMPLE.ORG,CN=Smart Card CA<S>CN=test,O=EXAMPLE.ORG
-
如果您有
验证
如果您可以访问 .pem
格式的整个证书,请验证是否用户和证书已链接:
使用
sss_cache
程序在 SSSD 缓存中使idm_user
记录无效,并强制重新载入idm_user
信息:# sss_cache -u idm_user
使用包含 IdM 用户证书的文件名称运行
ipa certmap-match
命令:# ipa certmap-match idm_user_cert.pem -------------- 1 user matched -------------- Domain: IDM.EXAMPLE.COM User logins: idm_user ---------------------------- Number of entries returned 1 ----------------------------
输出确认您现在已将证书映射数据添加到
idm_user
,并且存在对应的映射规则。这意味着,您可以使用与定义的证书映射数据匹配的任何证书,以idm_user
进行身份验证。
9.5. 使用 Active Directory 域信任的证书映射规则
如果 IdM 部署与活动目录(AD)域具有信任关系,则可能会有不同的证书映射用例。
根据 AD 配置,可能会出现以下情况:
- 如果证书是由 AD 证书系统发布的,但用户和证书存储在 IdM 中,则身份验证请求的映射和整个处理发生在 IdM 端。有关配置此情境的详情,请参阅为存储在 IdM 中的用户配置证书映射
如果用户存储在 AD 中,则身份验证请求的处理会在 AD 中发生。有三个不同的子案例:
- AD 用户条目包含整个证书。有关在这种情况下配置 IdM 的详情,请参考为 AD 用户条目包含整个证书的用户配置证书映射。
-
AD 配置为将用户证书映射到用户帐户。在本例中,AD 用户条目不包含整个证书,而是包含名为
altSecurityIdentities 的属性。
有关如何在这种场景中配置 IdM 的详情,请参阅在将 AD 配置为将用户证书映射到用户帐户时配置证书 映射。 AD 用户条目既不包含整个证书,也不包含映射数据。在这种情况下,有两个选项:
- 如果用户证书是由 AD 证书系统发布的,则证书会包含作为 Subject Alternative Name (SAN)的用户主体名称,或者如果最新的更新被应用到 AD,则用户的 SID在证书的 SID 扩展中。它们都可用于将证书映射到用户。
-
如果用户证书位于智能卡上,要启用带有智能卡的 SSH,SSSD 必须从证书生成公共 SSH 密钥,因此需要完整证书。唯一的解决方案是使用
ipa idoverrideuser-add
命令将整个证书添加到 IdM 中 AD 用户的 ID 覆盖中。详情请参阅 AD 用户条目不包含证书或映射数据时配置证书映射。
AD 域管理员可以使用 altSecurityIdentities
属性手动将证书映射到 AD 中的用户。此属性有六个支持的值,但三个映射被视为不安全。作为 2022 年 5 月 10 日安全更新 的一部分,在安装之后,所有设备都处于兼容模式,如果证书被弱映射到用户,则身份验证如预期发生。但是,会记录警告消息,标识任何与完整执行模式不兼容的证书。从 2023 年 11 月 14 日起,所有设备都将更新为完整的强制模式,如果证书不满足强映射标准,则身份验证将被拒绝。
例如,当 AD 用户请求带有证书(PKINIT)的 IdM Kerberos 票据时,AD 需要在内部将证书映射到用户,并为此使用新的映射规则。但是,在 IdM 中,如果 IdM 被用于将证书映射到 IdM 客户端上的用户,则以前的规则可以继续工作。
IdM 支持新的映射模板,使 AD 管理员更易于使用新规则,而不维护这两个模板。IdM 现在支持添加到活动目录的新映射模板,来包括:
- 序列号:LDAPU1: (altSecurityIdentities=X509:<I>{issuer_dn!ad_x500}<SR>{serial_number!hex_ur})
- 主题 Key Id: LDAPU1: (altSecurityIdentities=X509:<SKI>{subject_key_id!hex_u})
- 用户 SID:LDAPU1: (objectsid={sid})
如果您不想使用新的 SID 扩展重新发布证书,您可以通过将适当的映射字符串添加到 AD 中的 altSecurityIdentities
属性来创建一个手动映射。
9.6. 为 AD 用户条目包含整个证书的用户配置证书映射
此用户故事描述了如果 IdM 部署与 Active Directory(AD)信任时,在 IdM 中启用证书映射所需的步骤,该用户存储在 AD 中,AD 中的用户条目包含整个证书。
先决条件
- 用户在 IdM 中没有帐户。
- 用户在 AD 中有一个包含证书的帐户。
- IdM 管理员有权访问 IdM 证书映射规则可以基于的数据。
为确保 PKINIT 对用户正常工作,必须满足以下条件之一:
- 用户条目中的证书包括用户的用户主体名称或 SID 扩展。
-
AD 中的用户条目在
altSecurityIdentities
属性中有一个合适的条目。
9.6.1. 在 IdM Web UI 中添加一个证书映射规则
- 以管理员身份登录 IdM Web UI。
-
导航到
Authentication
→Certificate Identity Mapping Rules
→Certificate Identity Mapping Rules
。 单击
Add
。图 9.5. 在 IdM Web UI 中添加一个新的证书映射规则
- 输入规则名称。
输入映射规则。与 AD 中的可用内容相比,要向 IdM 提供整个证书以进行身份验证:
(userCertificate;binary={cert!bin})
注意如果使用完整证书进行映射,如果续订了证书,您必须确保将新证书添加到 AD 用户对象中。
输入匹配的规则。例如,只允许
AD.EXAMPLE.COM
域的AD-ROOT-CA
发布的证书进行身份验证:<ISSUER>CN=AD-ROOT-CA,DC=ad,DC=example,DC=com
图 9.6. 在 AD 中存储证书的用户的证书映射规则
-
单击
Add
。 系统安全服务守护进程(SSSD)定期重新读取证书映射规则。要强制立即加载新创建的规则,请在 CLI 中重启 SSSD:
# systemctl restart sssd
9.6.2. 在 IdM CLI 中添加证书映射规则
获得管理员凭证:
# kinit admin
输入映射规则以及映射规则所基于的匹配规则。要获得与 AD 中可用证书相比的用于身份验证的完整证书,只允许
AD.EXAMPLE.COM
域的AD-ROOT-CA
发布的证书来进行验证:# ipa certmaprule-add
simpleADrule
--matchrule '<ISSUER>CN=AD-ROOT-CA,DC=ad,DC=example,DC=com' --maprule '(userCertificate;binary={cert!bin})' --domain ad.example.com ------------------------------------------------------- Added Certificate Identity Mapping Rule "simpleADrule" ------------------------------------------------------- Rule name: simpleADrule Mapping rule: (userCertificate;binary={cert!bin}) Matching rule: <ISSUER>CN=AD-ROOT-CA,DC=ad,DC=example,DC=com Domain name: ad.example.com Enabled: TRUE注意如果使用完整证书进行映射,如果续订了证书,您必须确保将新证书添加到 AD 用户对象中。
系统安全服务守护进程(SSSD)定期重新读取证书映射规则。要强制立即载入新创建的规则,重启 SSSD:
# systemctl restart sssd
9.7. 如果将 AD 配置为将用户帐户映射到用户帐户,则配置证书映射
这个用户故事描述了如果 IdM 部署与活动目录(AD)有信任关系时在 IdM 中启用证书映射所需的步骤,用户存储在 AD 中,AD 中的用户条目包含证书映射数据。
先决条件
- 用户在 IdM 中没有帐户。
-
用户在 AD 中有一个帐户,其中包含
altSecurityIdentities 属性
,即 IdMcertmapdata
属性的 AD 等效。 - IdM 管理员有权访问 IdM 证书映射规则可以基于的数据。
9.7.1. 在 IdM Web UI 中添加一个证书映射规则
- 以管理员身份登录 IdM Web UI。
-
导航到
Authentication
→Certificate Identity Mapping Rules
→Certificate Identity Mapping Rules
。 单击
Add
。图 9.7. 在 IdM Web UI 中添加一个新的证书映射规则
- 输入规则名称。
输入映射规则。例如,要使 AD DC 搜索所呈现的任何证书中的
Issuer
和Subject
条目,并决定根据所出示证书的两个条目中提供的信息进行验证:(altSecurityIdentities=X509:<I>{issuer_dn!ad_x500}<S>{subject_dn!ad_x500})
输入匹配的规则。例如,要只允许
AD.EXAMPLE.COM
域的AD-ROOT-CA
发布的证书来向 IdM 验证用户:<ISSUER>CN=AD-ROOT-CA,DC=ad,DC=example,DC=com
输入域:
ad.example.com
图 9.8. 如果配置了 AD 进行映射,则证书映射规则
-
单击
Add
。 系统安全服务守护进程(SSSD)定期重新读取证书映射规则。要强制立即加载新创建的规则,请在 CLI 中重启 SSSD:
# systemctl restart sssd
9.7.2. 在 IdM CLI 中添加证书映射规则
获得管理员凭证:
# kinit admin
输入映射规则以及映射规则所基于的匹配规则。例如,要让 AD 搜索所提供的任何证书中的
Issuer
和Subject
条目,并且只允许AD.EXAMPLE.COM
域的AD-ROOT-CA
发布的证书:# ipa certmaprule-add ad_configured_for_mapping_rule --matchrule '<ISSUER>CN=AD-ROOT-CA,DC=ad,DC=example,DC=com' --maprule '(altSecurityIdentities=X509:<I>{issuer_dn!ad_x500}<S>{subject_dn!ad_x500})' --domain=ad.example.com ------------------------------------------------------- Added Certificate Identity Mapping Rule "ad_configured_for_mapping_rule" ------------------------------------------------------- Rule name: ad_configured_for_mapping_rule Mapping rule: (altSecurityIdentities=X509:<I>{issuer_dn!ad_x500}<S>{subject_dn!ad_x500}) Matching rule: <ISSUER>CN=AD-ROOT-CA,DC=ad,DC=example,DC=com Domain name: ad.example.com Enabled: TRUE
系统安全服务守护进程(SSSD)定期重新读取证书映射规则。要强制立即载入新创建的规则,重启 SSSD:
# systemctl restart sssd
9.7.3. 检查 AD 端的证书映射数据
altSecurityIdentities
属性是与 IdM 中的 certmapdata
用户属性等效的 Active Directory(AD)。当将可信 AD 域配置为将用户帐户映射到用户帐户时,IdM 系统管理员需要检查 AD 中的用户条目是否正确设置了 altSecurityIdentities 属性
。
先决条件
- 用户帐户必须具有用户管理访问权限。
流程
要检查 AD 是否包含 AD 中存储的用户的正确信息,请使用
ldapsearch
命令。例如,输入以下命令检查adserver.ad.example.com
服务器是否适用以下条件:-
altSecurityIdentities
属性在ad_user
的用户条目中设置。 matchrule 满足以下条件:
-
ad_user
用于向 AD 进行身份验证的证书由ad.example.com
域的AD-ROOT-CA
签发。 -
主题为
<S>DC=com,DC=example,DC=ad,CN=Users,CN=ad_user
:
-
$ ldapsearch -o ldif-wrap=no -LLL -h adserver.ad.example.com \ -p 389 -D cn=Administrator,cn=users,dc=ad,dc=example,dc=com \ -W -b cn=users,dc=ad,dc=example,dc=com "(cn=ad_user)" \ altSecurityIdentities Enter LDAP Password: dn: CN=ad_user,CN=Users,DC=ad,DC=example,DC=com altSecurityIdentities: X509:<I>DC=com,DC=example,DC=ad,CN=AD-ROOT-CA<S>DC=com,DC=example,DC=ad,CN=Users,CN=ad_user
-
9.8. 如果 AD 用户条目不包含证书或映射数据,则配置证书映射
如果 IdM 部署与 Active Directory(AD)信任时,此用户故事描述了在 IdM 中启用证书映射所需的步骤,此用户存储在 AD 中,AD 中的用户条目既包含整个证书,也不包含证书映射数据。
先决条件
- 用户在 IdM 中没有帐户。
-
用户在 AD 中有一个帐户,它不包含整个证书和
altSecurityIdentities 属性
,即 IdMcertmapdata
属性的 AD 等效。 IdM 管理员已完成了以下操作之一:
-
将整个 AD 用户证书添加到 IdM 中的 AD
用户 ID 覆盖
中。 - 创建一个映射到证书中备用字段的证书映射规则,如 Subject Alternative Name 或用户的 SID。
-
将整个 AD 用户证书添加到 IdM 中的 AD
9.8.1. 在 IdM Web UI 中添加一个证书映射规则
- 以管理员身份登录 IdM Web UI。
-
导航到
Authentication
→Certificate Identity Mapping Rules
→Certificate Identity Mapping Rules
。 单击
Add
。图 9.9. 在 IdM Web UI 中添加一个新的证书映射规则
- 输入规则名称。
输入映射规则。与存储在 IdM 中的 AD 用户条目的用户 ID 覆盖条目中的证书相比,为 IdM 提供整个证书进行身份验证:
(userCertificate;binary={cert!bin})
注意因为证书还包含作为 SAN 的用户主体名称或最新更新、证书 SID 扩展中的用户的 SID ,所以您也可以使用这些字段将证书映射到用户。例如,如果使用用户的 SID,请将此映射规则替换为
LDAPU1:(objectsid={sid})
。有关证书映射的更多信息,请参阅您系统上的sss-certmap
手册页。输入匹配的规则。例如,只允许
AD.EXAMPLE.COM
域的AD-ROOT-CA
发布的证书进行身份验证:<ISSUER>CN=AD-ROOT-CA,DC=ad,DC=example,DC=com
输入域名。例如,要在
ad.example.com
域中搜索用户:图 9.10. 没有证书或映射数据的用户的证书映射规则
-
单击
Add
。 系统安全服务守护进程(SSSD)定期重新读取证书映射规则。要强制立即载入新创建的规则,在 CLI 中重启 SSSD:
# systemctl restart sssd
9.8.2. 在 IdM CLI 中添加证书映射规则
获得管理员凭证:
# kinit admin
输入映射规则以及映射规则所基于的匹配规则。要获得与存储在 IdM 中的 AD 用户条目的用户 ID 覆盖条目中的证书相比的用于认证的整个证书,只允许
AD.EXAMPLE.COM
域的AD-ROOT-CA
发布的证书进行验证:# ipa certmaprule-add
simpleADrule
--matchrule '<ISSUER>CN=AD-ROOT-CA,DC=ad,DC=example,DC=com' --maprule '(userCertificate;binary={cert!bin})' --domain ad.example.com ------------------------------------------------------- Added Certificate Identity Mapping Rule "simpleADrule" ------------------------------------------------------- Rule name: simpleADrule Mapping rule: (userCertificate;binary={cert!bin}) Matching rule: <ISSUER>CN=AD-ROOT-CA,DC=ad,DC=example,DC=com Domain name: ad.example.com Enabled: TRUE注意因为证书还包含作为 SAN 的用户主体名称或最新更新、证书 SID 扩展中的用户的 SID ,所以您也可以使用这些字段将证书映射到用户。例如,如果使用用户的 SID,请将此映射规则替换为
LDAPU1:(objectsid={sid})
。有关证书映射的更多信息,请参阅您系统上的sss-certmap
手册页。系统安全服务守护进程(SSSD)定期重新读取证书映射规则。要强制立即载入新创建的规则,重启 SSSD:
# systemctl restart sssd
9.8.3. 在 IdM Web UI 中添加证书到 AD 用户的 ID 覆盖中
-
导航到
Identity
→ID Views
→Default Trust View
。 单击
Add
。图 9.11. 在 IdM Web UI 中添加一个新的用户 ID 覆盖
-
在
User to override
字段中,输入ad_user@ad.example.com
。 将
ad_user
的证书复制并粘贴到Certificate
字段中。图 9.12. 为 AD 用户配置用户 ID 覆盖
-
单击
Add
。
验证
验证用户和证书是否已链接:
使用
sss_cache
程序在 SSSD 缓存中使ad_user@ad.example.com
记录无效,并强制重新载入ad_user@ad.example.com
信息:# sss_cache -u ad_user@ad.example.com
使用包含 AD 用户证书的文件名称运行
ipa certmap-match
命令:# ipa certmap-match ad_user_cert.pem -------------- 1 user matched -------------- Domain: AD.EXAMPLE.COM User logins: ad_user@ad.example.com ---------------------------- Number of entries returned 1 ----------------------------
输出确认,您具有的证书验证数据被添加到 ad_user@ad.example.com
,并存在在 Adding a certificate mapping rule if the AD user entry contains no certificate or mapping data 中定义的相应的映射规则。这意味着,您可以使用与定义的证书映射数据匹配的证书作为 ad_user@ad.example.com
进行身份验证。
其它资源
9.8.4. 在 IdM CLI 中在 AD 用户的 ID 覆盖中添加证书
获得管理员凭证:
# kinit admin
将证书 blob 保存在名为
CERT
的新变量中:# CERT=$(openssl x509 -in /path/to/certificate -outform der|base64 -w0)
使用
ipa idoverrideuser-add-cert
命令将ad_user@ad.example.com
的证书添加到用户帐户中:# ipa idoverrideuser-add-cert ad_user@ad.example.com --certificate $CERT
验证
验证用户和证书是否已链接:
使用
sss_cache
程序在 SSSD 缓存中使ad_user@ad.example.com
记录无效,并强制重新载入ad_user@ad.example.com
信息:# sss_cache -u ad_user@ad.example.com
使用包含 AD 用户证书的文件名称运行
ipa certmap-match
命令:# ipa certmap-match ad_user_cert.pem -------------- 1 user matched -------------- Domain: AD.EXAMPLE.COM User logins: ad_user@ad.example.com ---------------------------- Number of entries returned 1 ----------------------------
输出确认,您具有的证书验证数据被添加到 ad_user@ad.example.com
,并存在在 Adding a certificate mapping rule if the AD user entry contains no certificate or mapping data 中定义的相应的映射规则。这意味着,您可以使用与定义的证书映射数据匹配的证书作为 ad_user@ad.example.com
进行身份验证。
其它资源
9.9. 将多个身份映射规则合并到一个规则中
要将多个身份映射规则组合成一个组合规则,请使用 |
(或)字符在单个映射规则前前,并使用 ()
方括号将它们分隔,例如:
证书映射过滤器示例 1
$ ipa certmaprule-add ad_cert_for_ipa_and_ad_users \ --maprule='(|(ipacertmapdata=X509:<I>{issuer_dn!nss_x500}<S>{subject_dn!nss_x500})(altSecurityIdentities=X509:<I>{issuer_dn!ad_x500}<S>{subject_dn!ad_x500}))' \ --matchrule='<ISSUER>CN=AD-ROOT-CA,DC=ad,DC=example,DC=com' \ --domain=ad.example.com
在上例中,-- maprule
选项中的过滤器定义包括这些条件:
-
ipacertmapdata=X509:<I>{issuer_dn!nss_x500}<S>{subject_dn!nss_x500}
是一个过滤器,它将一个智能卡证书中的 subject 和 issuer 连接到一个 IdM 用户账户中的ipacertmapdata
属性的值,如 Adding a certificate mapping rule in IdM 部分所述 -
altSecurityIdentities=X509:<I>{issuer_dn!ad_x500}<S>{subject_dn!ad_x500}
是一个过滤器,它将一个智能卡证书中的 subject 和 issuer 连接到一个 AD 用户账户中的altSecurityIdentities
属性的值,如 Adding a certificate mapping rule if the trusted AD domain is configured to map user certificates 所述 -
添加
--domain=ad.example.com
选项意味着映射到给定证书的用户不仅在本地idm.example.com
域中搜索,还要在ad.example.com
域中搜索
--maprule
选项中的过滤器定义接受逻辑运算符 |
(或),以便您可以指定多个条件。在这种情况下,规则映射了至少满足其中一个条件的所有用户帐户。
证书映射过滤器示例 2
$ ipa certmaprule-add ipa_cert_for_ad_users \ --maprule='(|(userCertificate;binary={cert!bin})(ipacertmapdata=X509:<I>{issuer_dn!nss_x500}<S>{subject_dn!nss_x500})(altSecurityIdentities=X509:<I>{issuer_dn!ad_x500}<S>{subject_dn!ad_x500}))' \ --matchrule='<ISSUER>CN=Certificate Authority,O=REALM.EXAMPLE.COM' \ --domain=idm.example.com --domain=ad.example.com
在上例中,-- maprule
选项中的过滤器定义包括这些条件:
-
userCertificate;binary={cert!bin}
是一个过滤器,它返回包含整个证书的用户条目。对于 AD 用户,创建这类过滤器在 如果 AD 用户条目不包含证书或映射数据,请添加一个证书映射规则 中进行了详细描述。 -
ipacertmapdata=X509:<I>{issuer_dn!nss_x500}<S>{subject_dn!nss_x500}
是一个过滤器,它将一个智能卡证书中的 subject 和 issuer 连接到一个 IdM 用户账户中的ipacertmapdata
属性的值,如 Adding a certificate mapping rule in IdM 部分所述。 -
altSecurityIdentities=X509:<I>{issuer_dn!ad_x500}<S>{subject_dn!ad_x500}
是一个过滤器,它将一个智能卡证书中的 subject 和 issuer 连接到一个 AD 用户账户中的altSecurityIdentities
属性的值,如 Adding a certificate mapping rule if the trusted AD domain is configured to map user certificates 所述。
--maprule
选项中的过滤器定义接受逻辑运算符 |
(或),以便您可以指定多个条件。在这种情况下,规则映射了至少满足其中一个条件的所有用户帐户。
9.10. 其它资源
-
您系统上的
sss-certmap (5)
手册页
第 10 章 使用存储在 IdM 客户端桌面的证书配置身份验证
通过配置身份管理(IdM),IdM 系统管理员可以使用向用户签发的证书颁发机构(CA)的证书,使用户能够向 IdM Web UI 和命令行界面(CLI)进行身份验证。证书存储在 IdM 客户端的桌面上。
Web 浏览器可以在不属于 IdM 域的系统中运行。
在使用证书配置身份验证时请注意以下几点:
- 如果要使用 证书进行身份验证的用户,您可以跳过请求新用户证书并将其导出到客户端 ;
- 如果 IdM CA 发布了用户的证书,您可以跳过确保证书和密钥被链接到一起。
只有身份管理用户可以使用证书登录 Web UI。Active Directory 用户可使用其用户名和密码登录。
10.1. 在 Web UI 中配置身份管理服务器以进行证书身份验证
作为身份管理(IdM)管理员,您可以允许用户使用证书为您的 IdM 环境进行身份验证。
流程
作为身份管理管理员:
在身份管理服务器上,获取管理员特权并创建 shell 脚本来配置服务器。
运行
ipa-advise config-server-for-smart-card-auth
命令,并将其输出保存到文件中,如server_certificate_script.sh
:# kinit admin # ipa-advise config-server-for-smart-card-auth >
server_certificate_script.sh
使用
chmod
实用程序为文件添加执行权限:# chmod +x
server_certificate_script.sh
在 Identity Management 域中的所有服务器上,运行
server_certificate_script.sh
脚本使用 IdM 证书颁发机构证书的路径
/etc/ipa/ca.crt
,因为如果 IdM CA 是唯一签发了您要为其启用证书验证的用户证书的证书颁发机构:#
./server_certificate_script.sh
/etc/ipa/ca.crt
如果不同的外部 CA 签署您想要为其启用证书验证的用户证书,则使用路径作为输入:
#
./server_certificate_script.sh
/tmp/ca1.pem
/tmp/ca2.pem
如果要为整个拓扑中启用用户的证书身份验证,请不要忘记在将来添加到系统的每个新副本上运行 脚本。
10.2. 请求新的用户证书并将其导出到客户端
作为身份管理(IdM)管理员,您可以为 IdM 环境中的用户创建证书,并将其导出到您要为用户启用证书身份验证的 IdM 客户端。
如果要使用证书进行身份验证的用户已有证书,则不需要按照此路程操作。
流程
可选:创建一个新目录,如
~/certdb/
,并使其成为临时证书数据库。当系统提示时,创建一个 NSS 证书数据库密码来加密后续步骤中生成的证书的密钥:# mkdir
~/certdb/
# certutil -N -d~/certdb/
Enter a password which will be used to encrypt your keys. The password should be at least 8 characters long, and should contain at least one non-alphabetic character. Enter new password: Re-enter password:创建证书签名请求(CSR),并将输出重定向到文件。例如,要为
IDM.EXAMPLE.COM
领域中的idm_user
用户创建一个4096
位、名称为certificate_request.csr
的 CSR,请将证书私钥的昵称设为idm_user
以便于查找,并将主题设为CN=idm_user,O=IDM.EXAMPLE.COM
:# certutil -R -d
~/certdb/
-a -g4096
-nidm_user
-s "CN=idm_user
,O=IDM.EXAMPLE.COM" >certificate_request.csr
出现提示时,输入您在使用
certutil
创建临时数据库时输入的相同密码。然后继续键入 rundlomly 直到通知停止:Enter Password or Pin for "NSS Certificate DB": A random seed must be generated that will be used in the creation of your key. One of the easiest ways to create a random seed is to use the timing of keystrokes on a keyboard. To begin, type keys on the keyboard until this progress meter is full. DO NOT USE THE AUTOREPEAT FUNCTION ON YOUR KEYBOARD! Continue typing until the progress meter is full:
将证书请求文件提交到服务器。指定要与新发布的证书关联的 Kerberos 主体、存储证书的输出文件,以及可选的证书配置集。例如,要获取
IECUserRoles
配置集的证书,带有添加的用户角色扩展的配置文件,idm_user
@IDM.EXAMPLE.COM
主体,并将它保存在~/idm_user.pem
文件中:# ipa cert-request
certificate_request.csr
--principal=idm_user
@IDM.EXAMPLE.COM
--profile-id=IECUserRoles
--certificate-out=~/idm_user.pem
将证书添加到 NSS 数据库。使用
-n
选项设置之前创建 CSR 时所用的相同 nickname,以便该证书与 NSS 数据库中的私钥相匹配。t
选项设置信任级别。详情请查看 certutil(1)man page。i 选项指定
输入证书文件。例如,要将存储在~/certdb/
数据库中~/idm_user.pem
文件中的带有idm_user
昵称的证书添加到 NSS 数据库中:# certutil -A -d
~/certdb/
-nidm_user
-t "P,," -i~/idm_user.pem
验证 NSS 数据库中的密钥是否未显示
(或称为)
作为其 nickname。例如,验证存储在~/certdb/ 数据库中
的证书没有被孤立:# certutil -K -d
~/certdb/
< 0> rsa 5ad14d41463b87a095b1896cf0068ccc467df395 NSS Certificate DB:idm_user使用
pk12util
命令将证书从 NSS 数据库导出到 PKCS12 格式。例如,将/root/certdb
NSS 数据库中的idm_user
nickname 的证书导出到~/idm_user.p12
文件:# pk12util -d
~/certdb
-o~/idm_user.p12
-nidm_user
Enter Password or Pin for "NSS Certificate DB": Enter password for PKCS12 file: Re-enter password: pk12util: PKCS12 EXPORT SUCCESSFUL将证书传输到您要启用
idm_user
的证书身份验证的主机:# scp
~/idm_user.p12
idm_user@client.idm.example.com:/home/idm_user/
在传输了证书的主机上,出于安全原因使 'pkcs12 文件被 'other' 组无法访问的目录:
# chmod o-rwx
/home/idm_user/
出于安全考虑,请从服务器中删除临时 NSS 数据库和 .pkcs12 文件:
# rm
~/certdb/
# rm~/idm_user.p12
10.3. 确保证书和用户链接在一起
如果用户的证书已由 IdM CA 发布,则不需要按照此流程操作。
要使证书身份验证发挥作用,您需要确保证书链接到将使用证书进行身份管理(IdM)身份验证的用户。
- 如果证书由不属于您的身份管理环境的证书颁发机构提供,请在链接 用户帐户到证书 中介绍的步骤链接用户和证书。
- 如果证书由 Identity Management CA 提供,则证书会自动添加到用户条目中,您不必将该证书链接到用户帐户。有关在 IdM 中创建新证书的详情,请参阅请求新用户证书并将其导出到客户端。
10.4. 配置浏览器以启用证书身份验证
若要在使用 Web UI 登录身份管理(IdM)时通过证书进行身份验证,您需要将用户和相关证书颁发机构(CA)证书导入到 Mozilla Firefox 或 Google Chrome 浏览器。浏览器运行的主机本身不必是 IdM 域的一部分。
IdM 支持以下浏览器来连接到 WebUI:
- Mozilla Firefox 38 及更新的版本
- Google Chrome 46 及更新的版本
以下流程演示了如何配置 Mozilla Firefox 57.0.1 浏览器。
先决条件
- 您可以使用 PKCS#12 格式在浏览器中导入 用户证书。
流程
打开 Firefox,然后导航到
Preferences
→Privacy & Security
。图 10.1. Preferences 中的隐私和安全部分
单击
。图 10.2. 查看隐私和安全性中的证书
-
在您的
证书
选项卡中,单击 。以 PKCS12 格式查找并打开用户证书,然后点 和 。 确保 Identity Management 证书授权机构被 Firefox 认可为可信颁发机构:
在本地保存 IdM CA 证书:
通过在 Firefox 地址栏中写入 IdM 服务器的名称,导航到 IdM Web UI。在 Insecure Connection 警告页面上单击
Advanced
。图 10.3. 不安全的连接
添加例外.
单击View
。图 10.4. 查看证书的详情
在
详细信息
选项卡中,突出显示证书颁发机构
字段。图 10.5. 导出 CA 证书
-
单击
CertificateAuthority.crt
文件,然后单击 和 。 。保存 CA 证书,如
将 IdM CA 证书导入 Firefox 作为可信证书颁发机构证书:
打开 Firefox,导航到 Preferences 并点击
。图 10.6. Preferences 中的隐私和安全部分
单击
。图 10.7. 查看隐私和安全性中的证书
-
在"
颁发机构
"选项卡中,单击 。查找并打开您在上一步中保存在CertificateAuthority.crt
文件中的 CA 证书。信任证书来识别网站,然后点 和 。
- 继续 验证身份管理 Web UI,并使用作为身份管理用户的证书。
10.5. 使用作为身份管理用户的证书对身份管理 Web UI 进行身份验证
按照以下流程,使用存储在身份管理客户端桌面上的证书,作为身份管理(IdM) Web UI 的用户进行身份验证。
流程
-
在浏览器中,导航到位于 的 Identity Management Web UI,例如
https:
//server.idm.example.com/ipa/ui
。 单击
"图 10.8. 在身份管理 Web UI 中
- 应该已经选择了用户的证书。取消选中 Decision,然后单击 。
现在,您被验证为与证书对应的用户。
其它资源
10.6. 配置 IdM 客户端以使用证书启用对 CLI 的身份验证
要使 IdM 用户在 IdM 客户端的命令行界面(CLI)中为 IdM 用户提供证书身份验证,请将 IdM 用户的证书和私钥导入到 IdM 客户端。有关创建和传输用户证书的详情,请参阅请求新用户证书并将其导出到客户端。
流程
登录 IdM 客户端,并让包含用户证书和私钥的 .p12 文件准备好。要获取并缓存 Kerberos 票据授予票据(TGT),请使用带有用户主体的
-X
选项和X509_username:/path/to/file.p12
属性运行kinit
命令,以指定在何处查找用户的 X509 身份信息。例如,要使用存储在~/idm_user.p12
文件中的用户身份信息获取idm_user
的 TGT:$ kinit -X X509_idm_user='PKCS12:~/idm_user.p12' idm_user
注意该命令还支持 .pem 文件格式: kinit -X X509_username='FILE:/path/to/cert.pem,/path/to/key' user_principal
第 11 章 使用 IdM CA 续订服务器
11.1. IdM CA 续订服务器解释
在使用嵌入式证书颁发机构(CA)的 Identity Management(IdM)部署中,CA 续订服务器维护并更新 IdM 系统证书。它确保了强大的 IdM 部署。
IdM 系统证书包括:
-
IdM CA
证书 -
OCSP
签名证书 -
IdM CA 子系统
证书 -
IdM CA 审计签名
证书 -
IdM 续订代理
(RA)证书 -
KRA
传输和存储证书
对系统证书进行定性的特征是,它们的密钥由所有 CA 副本共享。相比之下,IdM 服务证书(如 LDAP
、HTTP
和 PKINIT
证书)在不同的 IdM CA 服务器上具有不同的密钥对和主题名称。
在 IdM 拓扑中,默认情况下,第一个 IdM CA 服务器是 CA 续订服务器。
在上游文档中,IdM CA 称为 Dogtag
。
CA 续订服务器的角色
IdM CA
、IdM CA 子系统
和 IdM RA
证书对 IdM 部署至关重要。每个证书都存储在 /etc/pki/pki-tomcat/
目录中的 NSS 数据库以及 LDAP 数据库条目中。存储在 LDAP 中的证书必须与存储在 NSS 数据库中的证书匹配。如果不匹配,在 IdM 框架和 IdM CA 之间以及 IdM CA 和 LDAP 之间会发生身份验证失败。
所有 IdM CA 副本都有针对每个系统证书的跟踪请求。如果带有集成 CA 的 IdM 部署不包含 CA 续订服务器,则每个 IdM CA 服务器都会单独请求续订系统证书。这会导致发生各种系统证书和身份验证失败的不同 CA 副本。
将一个 CA 副本用作续订服务器,可以在需要时完全续订一次系统证书,从而避免身份验证失败。
CA 副本上的 cert
monger 服务的角色
在所有 IdM CA 副本上运行的 certmonger 服务
使用 dogtag-ipa-ca-renew-agent
续订帮助程序来跟踪 IdM 系统证书。续订帮助程序读取 CA 续订服务器配置。在不是 CA 续订服务器的每个 CA 副本上,续订帮助程序从 ca_renewal
LDAP 条目检索最新的系统证书。由于正好发生 证书续订
尝试时,dog tag-ipa-ca-renew-agent
帮助程序有时会在 CA 续订服务器实际续订证书前尝试更新系统证书。如果发生这种情况,旧的、即将扩展的证书将返回到 CA 副本上的 certmonger 服务
。在意识到它 的证书服务
已存储在其数据库中,证书服务会一直尝试在单独尝试之间延迟更新证书,直到它可以从 CA 续订服务器检索更新的证书。
IdM CA 续订服务器正常功能
带有嵌入式 CA 的 IdM 部署是一个 IdM 部署,安装有 IdM CA - 或者稍后安装了 IdM CA 服务器。带有嵌入式 CA 的 IdM 部署必须始终有一个 CA 副本配置为续订服务器。续订服务器必须在线且功能完整,并且必须与其他服务器正确复制。
如果正在使用 ipa server-del
、ipa-replica-manage del
、ipa-csreplica-manage del
或 ipa-server-install --uninstall
命令删除当前的 CA 续订服务器,则另一个 CA 副本会自动被分配为 CA 续订服务器。此策略确保续订服务器配置保持有效。
该政策不包括以下情况:
11.2. 更改和重置 IdM CA 续订服务器
当证书颁发机构(CA)续订服务器停用时,身份管理(IdM)会自动从 IdM CA 服务器列表中选择一个新的 CA 续订服务器。系统管理员无法影响选择。
为了能够选择新的 IdM CA 续订服务器,系统管理员必须手动执行替换操作。在开始停用当前续订服务器的过程之前,选择新的 CA 续订服务器。
如果当前的 CA 续订服务器配置无效,请重置 IdM CA 续订服务器。
完成此步骤以更改或重置 CA 续订服务器。
先决条件
- 有 IdM 管理员凭证。
流程
获取 IdM 管理员凭证:
~]$ kinit admin Password for admin@IDM.EXAMPLE.COM:
可选: 要找出部署中的哪些 IdM 服务器具有必要的 CA 角色,有资格成为新的 CA 续订服务器:
~]$ ipa server-role-find --role 'CA server' ---------------------- 2 server roles matched ---------------------- Server name: server.idm.example.com Role name: CA server Role status: enabled Server name: replica.idm.example.com Role name: CA server Role status: enabled ---------------------------- Number of entries returned 2 ----------------------------
部署中有两个 CA 服务器。
可选: 要找出哪个 CA 服务器是当前的 CA 续订服务器,请输入:
~]$ ipa config-show | grep 'CA renewal' IPA CA renewal master: server.idm.example.com
当前续订服务器为
server.idm.example.com
。要更改续订服务器配置,请使用
ipa config-mod
实用程序和--ca-renewal-master-server
选项:~]$ ipa config-mod --ca-renewal-master-server replica.idm.example.com | grep 'CA renewal' IPA CA renewal master: replica.idm.example.com
重要您还可以使用以下命令切换到新的 CA 续订服务器:
-
ipa-cacert-manage --renew
命令。此命令会续订 CA 证书 ,并使 您在其上执行新 CA 续订服务器的 CA 服务器。 ipa-cert-fix
命令。当证书过期时,该命令会恢复部署。它还使您在其上执行该命令的 CA 服务器成为新的 CA 续订服务器。详情请查看 IdM 离线时重新更新过期的系统证书。
-
第 12 章 管理外部签名的 CA 证书
身份管理(IdM)提供不同类型的证书颁发机构(CA)配置。您可以选择安装带有集成 CA 或带有外部 CA 的 IdM。您必须指定在安装过程中使用的 CA 类型。但是,安装后,您可以从外部签名的 CA 移到自签名 CA,反之亦然。另外,当自动续订自签名 CA 时,您必须确保续订外部签名的 CA 证书。请参考管理外部签名的 CA 证书所需的相关部分。
安装带有外部签名 CA 的 IdM:
- 从外部签名的 CA 切换到自签名 CA。
- 从自签名 CA 切换到外部签名的 CA。
- 续订外部签名的 CA 证书。
12.1. 在 IdM 中从外部签名的 CA 切换到自签名 CA
完成此步骤,从外部签名切换到身份管理(IdM)证书认证机构(CA)的自签名证书。使用自签名 CA 时,自动管理 CA 证书的续订:系统管理员不需要向外部机构提交证书签名请求(CSR)。
从外部签名切换到自签名 CA 只替换 CA 证书。之前 CA 签名的证书仍有效且仍在使用。例如,即使您移至自签名 CA 后,LDAP
证书的证书链也会保持不变:
external_CA
certificate >IdM CA
certificate >LDAP
certificate
先决条件
-
有到 IdM CA 续订服务器和所有 IdM 客户端和服务器的
root
访问权限。
流程
在 IdM CA 续订服务器上,将 CA 证书更新为自签名:
# ipa-cacert-manage renew --self-signed Renewing CA certificate, please wait CA certificate successfully renewed The ipa-cacert-manage command was successful
以
root
用户身份通过SSH
连接到所有剩余的 IdM 服务器和客户端。例如:# ssh root@idmclient01.idm.example.com
在 IdM 客户端中,使用服务器的证书更新本地 IdM 证书数据库:
[idmclient01 ~]# ipa-certupdate Systemwide CA database updated. Systemwide CA database updated. The ipa-certupdate command was successful
验证
要检查您的更新是否成功,并将新的 CA 证书添加到
/etc/ipa/ca.crt
文件中:[idmclient01 ~]$ openssl crl2pkcs7 -nocrl -certfile /etc/ipa/ca.crt | openssl pkcs7 -print_certs -text -noout [...] Certificate: Data: Version: 3 (0x2) Serial Number: 39 (0x27) Signature Algorithm: sha256WithRSAEncryption Issuer: O=IDM.EXAMPLE.COM, CN=Certificate Authority Validity Not Before: Jul 1 16:32:45 2019 GMT Not After : Jul 1 16:32:45 2039 GMT Subject: O=IDM.EXAMPLE.COM, CN=Certificate Authority [...]
输出显示更新已成功,因为新 CA 证书使用旧的 CA 证书列出。
12.2. 在 IdM 中从自签名 CA 切换到外部签名的 CA
在 IdM 中,您可以从自签名 CA 切换到外部签名的 CA。在 IdM 中切换到外部签名的 CA 后,您的 IdM CA 服务器变为外部 CA 的子 CA。另外,不会自动管理 CA 证书的续订,系统管理员必须向外部颁发机构提交证书签名请求(CSR)。
要切换到外部签名的 CA,CSR 必须由外部 CA 签名。按照 使用外部 CA 续订 IdM CA 续订服务器证书 中的步骤操作,来切换到 IdM 中的自签名 CA。
12.3. 使用外部 CA 续订 IdM CA 续订服务器证书
按照以下流程,使用外部 CA 续订身份管理(IdM)证书颁发机构(CA)证书,来签名证书签名请求(CSR)。在这个配置中,您的 IdM CA 服务器是外部 CA 的 subCA。外部 CA 可以(但不必)是 Active Directory 证书服务器(AD CS)。
如果外部证书颁发机构是 AD CS,您可以在 CSR 中为 IdM CA 证书指定您想要的模板。证书模板定义收到证书请求时使用的策略和规则。AD 中的证书模板与 IdM 中的证书配置集对应。
您可以通过其对象标识符(OID)定义特定的 AD CS 模板。OID 是不同发布机构发布的唯一数字值,用于唯一标识分布式应用中的数据元素、语法和其他部分。
另外,您还可以根据名称来定义特定的 AD CS 模板。例如,IdM CA 向 AD CS 提交的 CSR 中使用的默认配置集的名称是 subCA
。
要通过在 CSR 中指定 OID 或名称来定义配置集,请使用 external-ca-profile
选项。详情请查看您系统上的 ipa-cacert-manage
手册页。
除了使用现成的证书模板外,您还可以在 AD CS 中创建自定义证书模板,并在 CSR 中使用它。
先决条件
- 您具有对 IdM CA 续订服务器的 root 访问权限。
流程
完成此流程以使用外部签名续订 IdM CA 的证书,无论当前的 CA 证书是自签名还是外部签名。
创建要提交到外部 CA 的 CSR:
如果外部 CA 是 AD CS,请使用
--external-ca-type=ms-cs
选项。如果要使用与默认subCA
模板不同的模板,请使用--external-ca-profile
选项指定它:~]#
ipa-cacert-manage renew --external-ca --external-ca-type=ms-cs [--external-ca-profile=PROFILE]
Exporting CA certificate signing request, please wait The next step is to get /var/lib/ipa/ca.csr signed by your CA and re-run ipa-cacert-manage as: ipa-cacert-manage renew --external-cert-file=/path/to/signed_certificate --external-cert-file=/path/to/external_ca_certificate The ipa-cacert-manage command was successful如果外部 CA 不是 AD CS:
~]#
ipa-cacert-manage renew --external-ca
Exporting CA certificate signing request, please wait The next step is to get /var/lib/ipa/ca.csr signed by your CA and re-run ipa-cacert-manage as: ipa-cacert-manage renew --external-cert-file=/path/to/signed_certificate --external-cert-file=/path/to/external_ca_certificate The ipa-cacert-manage command was successful输出显示已创建了 CSR,并存储在
/var/lib/ipa/ca.csr
文件中。
-
将位于
/var/lib/ipa/ca.csr 中的 CSR
提交到外部 CA。这个过程根据要用作外部 CA 的服务的不同而有所不同。 检索发布的证书和 CA 证书链,用于在基本的 64 编码 Blob 中发布 CA,即:
- 如果外部 CA 不是 AD CS,则为 PEM 文件。
如果外部 CA 是 AD CS,则为 Base_64 证书。
每个证书服务的进程都有所不同。通常,网页或通知电子邮件中的下载链接允许管理员下载所有必要的证书。
如果外部 CA 是 AD CS,且您已通过 Microsoft Windows 认证授权机构管理窗口使用已知模板提交 CSR,AD CS 会立即发出证书,且 Save Certificate 对话框会出现在 AD CS Web 界面中,询问如何保存颁发的证书。
再次运行
ipa-cacert-manage renewal 命令
,添加提供完整证书链所需的所有 CA 证书文件。多次使用--external-cert-file
选项,根据需要指定任意文件:~]#
ipa-cacert-manage renew --external-cert-file=/path/to/signed_certificate --external-cert-file=/path/to/external_ca_certificate_1 --external-cert-file=/path/to/external_ca_certificate_2
在所有 IdM 服务器和客户端中,使用来自服务器的证书更新本地 IdM 证书数据库:
[client ~]$ ipa-certupdate Systemwide CA database updated. Systemwide CA database updated. The ipa-certupdate command was successful
验证
要检查您的更新是否成功,并将新的 CA 证书添加到
/etc/ipa/ca.crt
文件中:[client ~]$ openssl crl2pkcs7 -nocrl -certfile /etc/ipa/ca.crt | openssl pkcs7 -print_certs -text -noout [...] Certificate: Data: Version: 3 (0x2) Serial Number: 39 (0x27) Signature Algorithm: sha256WithRSAEncryption Issuer: O=IDM.EXAMPLE.COM, CN=Certificate Authority Validity Not Before: Jul 1 16:32:45 2019 GMT Not After : Jul 1 16:32:45 2039 GMT Subject: O=IDM.EXAMPLE.COM, CN=Certificate Authority [...]
输出显示更新已成功,因为新 CA 证书使用旧的 CA 证书列出。
第 13 章 IdM 离线时续订过期的系统证书
如果系统证书已过期,Identity Management(IdM)无法启动。IdM 支持使用 ipa-cert-fix
工具更新系统证书。
先决条件
- IdM 仅安装在 Red Hat Enterprise Linux 8.1 或更高的版本上。
-
通过在主机上输入
ipactl start --ignore-service-failures
命令来确保 LDAP 服务正在运行。
13.1. 在 CA 续订服务器上续订过期的系统证书
按照以下流程,对过期的 IdM 证书应用 ipa-cert-fix
工具。
如果您在不是 CA 续订服务器的 CA(证书授权机构)主机上运行 ipa-cert-fix
工具,并且 实用程序续订共享证书,则该主机会自动成为域中的新 CA 续订服务器。域中必须始终只有一个 CA 续订服务器,以避免不一致。
先决条件
- 使用管理权限登录到服务器
流程
-
可选:备份系统。这强烈推荐,因为
ipa-cert-fix
对nssdb
进行了不可逆更改。因为ipa-cert-fix
也对 LDAP 进行了更改,因此也建议备份整个集群。 启动
ipa-cert-fix
工具,以分析系统并列出需要续订的过期证书:# ipa-cert-fix ... The following certificates will be renewed: Dogtag sslserver certificate: Subject: CN=ca1.example.com,O=EXAMPLE.COM 201905222205 Serial: 13 Expires: 2019-05-12 05:55:47 ... Enter "yes" to proceed:
输入
yes
以开始续订过程:Enter "yes" to proceed: true Proceeding. Renewed Dogtag sslserver certificate: Subject: CN=ca1.example.com,O=EXAMPLE.COM 201905222205 Serial: 268369925 Expires: 2021-08-14 02:19:33 ... Becoming renewal master. The ipa-cert-fix command was successful
ipa-cert-fix
更新所有过期证书前最多可能需要一分钟的时间。
验证
验证所有服务现在都在运行:
# ipactl status Directory Service: RUNNING krb5kdc Service: RUNNING kadmin Service: RUNNING httpd Service: RUNNING ipa-custodia Service: RUNNING pki-tomcatd Service: RUNNING ipa-otpd Service: RUNNING ipa: INFO: The ipactl command was successful
此时,证书已被续订,服务正在运行。下一步是检查 IdM 域中的其他服务器。
如果您需要在多个 CA 服务器之间修复证书:
-
在确保 LDAP 复制功能拓扑后,首先根据上述步骤在一个 CA 服务器中运行
ipa-cert-fix
。 -
在另一个 CA 服务器上运行
ipa-cert-fix
之前,请通过getcert-resubmit
(在其他 CA 服务器上)触发共享证书的 Certmonger 续订,以避免不必要的续订共享证书。
13.2. 续订后验证 IdM 域中的其他 IdM 服务器
在使用 ipa-cert-fix
工具续订 CA 续订服务器证书后,您必须:
- 重新启动 域中的所有其他身份管理(IdM)服务器。
- 检查 certmonger 是否更新的证书。
-
如果有其他带有过期系统证书的证书颁发机构(CA)副本,还可以使用
ipa-cert-fix
工具续订这些证书。
先决条件
- 使用管理权限登录服务器。
流程
使用
--force
参数重启 IdM:# ipactl restart --force
使用
--force
参数时,ipactl
实用程序会忽略单个服务启动失败。例如,如果服务器也是证书过期的 CA,pki-tomcat
服务将无法启动。这是预期并忽略的,因为使用了--force
参数。重启后,验证
certmonger 服务
是否已更新证书(certificate 状态显示 MONITORING):# getcert list | egrep '^Request|status:|subject:' Request ID '20190522120745': status: MONITORING subject: CN=IPA RA,O=EXAMPLE.COM 201905222205 Request ID '20190522120834': status: MONITORING subject: CN=Certificate Authority,O=EXAMPLE.COM 201905222205 ...
在
certmonger
续订副本上的共享证书之前,可能需要一些时间,。如果服务器也是 CA,以上命令会报告
pki-tomcat
服务使用的证书的CA_UNREACHABLE
:Request ID '20190522120835': status: CA_UNREACHABLE subject: CN=ca2.example.com,O=EXAMPLE.COM 201905222205 ...
要续订此证书,请使用
ipa-cert-fix
工具:# ipa-cert-fix Dogtag sslserver certificate: Subject: CN=ca2.example.com,O=EXAMPLE.COM Serial: 3 Expires: 2019-05-11 12:07:11 Enter "yes" to proceed: true Proceeding. Renewed Dogtag sslserver certificate: Subject: CN=ca2.example.com,O=EXAMPLE.COM 201905222205 Serial: 15 Expires: 2019-08-14 04:25:05 The ipa-cert-fix command was successful
现在,所有 IdM 证书已被更新并可以正常工作。
第 14 章 如果 web 服务器和 LDAP 服务器证书还没有在 IdM 副本上过期,请替换它们
作为身份管理(IdM)系统管理员,您可以手动替换运行在 IdM 服务器上的 web(或 httpd
)和 LDAP(或 Directory
)服务的证书。例如,如果证书接近过期,并且没有配置 certmonger
工具来自动更新证书,或者证书是由外部证书颁发机构(CA)签名的,则这可能是必需的。
这个示例为运行在 server.idm.example.com IdM 服务器上的服务安装证书。您从外部 CA 获取证书。
HTTP 和 LDAP 服务证书在不同的 IdM 服务器上有不同的密钥对和主题名称,因此您必须单独在每台 IdM 服务器上更新证书。
先决条件
-
在 IdM 服务器具有复制协议的拓扑中的至少一个其他 IdM 副本上,Web 和 LDAP 证书仍有效。这是
ipa-server-certinstall
命令的先决条件。命令需要TLS
连接,来与其他 IdM 副本进行通信。但是,如果证书无效,此类连接无法建立,ipa-server-certinstall
命令将失败。在这种情况下,请参阅 如果 web 服务器和 LDAP 服务器证书在整个 IdM 部署中已过期,则替换它们。 -
您有到 IdM 服务器的
root
访问权限。 -
您知道
目录管理器
密码。 - 您可以访问存储外部 CA 的 CA 证书链的文件 ca_certificate_chain_file.crt 。
流程
将 ca_certificate_chain_file.crt 中包含的证书作为额外的 CA 证书安装到 IdM:
# ipa-cacert-manage install
使用来自 ca_certicate_chain_file.crt 的证书更新本地 IdM 证书数据库:
# ipa-certupdate
使用
OpenSSL
工具生成私钥和证书签名请求(CSR):$ openssl req -new -newkey rsa:4096 -days 365 -nodes -keyout new.key -out new.csr -addext "subjectAltName = DNS:server.idm.example.com" -subj '/CN=server.idm.example.com,O=IDM.EXAMPLE.COM'
将 CSR 提交给外部 CA。这个过程根据要用作外部 CA 的服务的不同而有所不同。在 CA 为证书签名后,将证书导入到 IdM 服务器。
在 IdM 服务器上,将 Apache Web 服务器的旧私钥和证书替换为新密钥和新签名的证书:
# ipa-server-certinstall -w --pin=password new.key new.crt
在以上命令中:
-
-w
选项指定您要将证书安装到 Web 服务器中。 -
pin
选项指定保护私钥的密码。
-
-
出现提示时,输入
目录管理器
密码。 将 LDAP 服务器的旧私钥和证书替换为新密钥和新签名的证书:
# ipa-server-certinstall -d --pin=password new.key new.cert
在以上命令中:
-
-d
选项指定您要将证书安装到 LDAP 服务器中。 -
pin
选项指定保护私钥的密码。
-
-
出现提示时,输入
目录管理器
密码。 重启
httpd
服务:# systemctl restart httpd.service
重启
Directory
服务:# systemctl restart dirsrv@IDM.EXAMPLE.COM.service
如果已在服务器上删除或替换了子 CA,请更新客户端:
# ipa-certupdate
其它资源
- 转换证书格式以和 IdM 一起工作
-
您系统上的
ipa-server-certinstall (1)
手册页
第 15 章 如果 web 服务器和 LDAP 服务器证书在整个 IdM 部署中已过期,则替换它们
身份管理(IdM)使用以下服务证书:
-
LDAP(或
Directory
)服务器证书 -
Web(或
httpd
)服务器证书 - PKINIT 证书
在没有 CA 的 IdM 部署中,certmonger
默认不会跟踪 IdM 服务证书或其过期的通知。如果 IdM 系统管理员没有手动为这些证书设置通知,或者将 certmonger
配置为跟踪它们,则证书将在没有通知的情况下过期。
按照以下流程,手动为运行在 server.idm.example.com IdM 服务器上的 httpd
和 LDAP 服务替换过期的证书。
HTTP 和 LDAP 服务证书在不同的 IdM 服务器上有不同的密钥对和主题名称。因此,您必须单独更新每个 IdM 服务器上的证书。
先决条件
- HTTP 和 LDAP 证书已在拓扑中的 所有 IdM 副本上过期。如果没有,请参阅 如果 IdM 副本上的 web 服务器和 LDAP 服务器证书还没过期,则替换它们。
-
您有访问 IdM 服务器和副本的
root
权限。 -
您知道
目录管理器
密码。 您已创建了以下目录和文件的备份:
-
/etc/dirsrv/slapd-IDM-EXAMPLE-COM/
-
/etc/httpd/alias
-
/var/lib/certmonger
-
/var/lib/ipa/certs/
-
流程
-
可选:执行
/var/lib/ipa/private
和/var/lib/ipa/passwds
的备份。 如果您不使用相同的 CA 为新证书签名,或者已安装的 CA 证书不再有效,请使用包含外部 CA 的有效 CA证书链的文件更新本地数据库中的外部 CA 信息。该文件可接受 PEM 和 DER 证书、PKCS#7 证书链、PKCS#8 和原始私钥,以及 PKCS#12 格式。
将 ca_certificate_chain_file.crt 中提供的证书作为额外的 CA 证书安装到 IdM 中:
# ipa-cacert-manage install ca_certificate_chain_file.crt
使用来自 ca_certicate_chain_file.crt 的证书更新本地 IdM 证书数据库:
# ipa-certupdate
请求
httpd
和 LDAP 的证书:使用
OpenSSL
工具,为在 IdM 实例上运行的 Apache Web 服务器创建到第三方 CA 的证书签名请求(CSR)。创建新私钥是可选的。如果您仍然有原始私钥,您可以将
-in
选项与openssl req
命令一起使用,以指定要从中读取请求的输入文件名:$ openssl req -new -nodes -in /var/lib/ipa/private/httpd.key -out /tmp/http.csr -addext 'subjectAltName = DNS:_server.idm.example.com_, otherName:1.3.6.1.4.1.311.20.2.3;UTF8:HTTP/server.idm.example.com@IDM.EXAMPLE.COM' -subj '/O=IDM.EXAMPLE.COM/CN=server.idm.example.com'
如果要创建一个新密钥:
$ openssl req -new -newkey rsa:2048 -nodes -keyout /var/lib/ipa/private/httpd.key -out /tmp/http.csr -addext 'subjectAltName = DNS:server.idm.example.com, otherName:1.3.6.1.4.1.311.20.2.3;UTF8:HTTP/server.idm.example.com@IDM.EXAMPLE.COM' -subj '/O=IDM.EXAMPLE.COM/CN=server.idm.example.com'
使用
OpenSSL
工具为运行在 IdM 实例上的 LDAP 服务器创建到第三方 CA 的证书签名请求(CSR):$ openssl req -new -newkey rsa:2048 -nodes -keyout ~/ldap.key -out /tmp/ldap.csr -addext 'subjectAltName = DNS:server.idm.example.com, otherName:1.3.6.1.4.1.311.20.2.3;UTF8:ldap/server.idm.example.com@IDM.EXAMPLE.COM' -subj '/O=IDM.EXAMPLE.COM/CN=server.idm.example.com'
-
向外部 CA 提交 CSR、/tmp/http.csr 和 tmp/ldap.csr ,并获取
httpd
的证书和 LDAP 的证书。这个过程根据要用作外部 CA 的服务的不同而有所不同。
安装
httpd
的证书:# cp /path/to/httpd.crt /var/lib/ipa/certs/
将 LDAP 证书安装到 NSS 数据库中:
可选:列出可用的证书:
# certutil -d /etc/dirsrv/slapd-IDM-EXAMPLE-COM/ -L Certificate Nickname Trust Attributes SSL,S/MIME,JAR/XPI Server-Cert u,u,u
默认证书昵称是 Server-Cert,但可能会应用不同的名称。
使用上一步中的证书昵称,从 NSS 数据库(
NSSDB
)中删除旧的无效证书:# certutil -D -d /etc/dirsrv/slapd-IDM-EXAMPLE-COM/ -n 'Server-Cert' -f /etc/dirsrv/slapd-IDM-EXAMPLE-COM/pwdfile.txt
创建一个 PKCS12 文件,来简化导入到
NSSDB
的过程:# openssl pkcs12 -export -in ldap.crt -inkey ldap.key -out ldap.p12 -name Server-Cert
将创建的 PKCS#12 文件安装到
NSSDB
中:# pk12util -i ldap.p12 -d /etc/dirsrv/slapd-IDM-EXAMPLE-COM/ -k /etc/dirsrv/slapd-IDM-EXAMPLE-COM/pwdfile.txt
检查新证书是否已成功导入:
# certutil -L -d /etc/dirsrv/slapd-IDM-EXAMPLE-COM/
重启
httpd
服务:# systemctl restart httpd.service
重启
Directory
服务:# systemctl restart dirsrv@IDM-EXAMPLE-COM.service
-
在所有 IdM 副本上执行前面所有的步骤。这是在副本之间建立
TLS
连接的先决条件。 将新证书注册到 LDAP 存储:
将 Apache Web 服务器的旧私钥和证书替换为新密钥和新签名的证书:
# ipa-server-certinstall -w --pin=password /var/lib/ipa/private/httpd.key /var/lib/ipa/certs/httpd.crt
在以上命令中:
-
-w
选项指定您要将证书安装到 Web 服务器中。 -
pin
选项指定保护私钥的密码。
-
-
出现提示时,输入
目录管理器
密码。 将 LDAP 服务器的旧私钥和证书替换为新密钥和新签名的证书:
# ipa-server-certinstall -d --pin=password /etc/dirsrv/slapd-IDM-EXAMPLE-COM/ldap.key /path/to/ldap.crt
在以上命令中:
-
-d
选项指定您要将证书安装到 LDAP 服务器中。 -
pin
选项指定保护私钥的密码。
-
-
出现提示时,输入
目录管理器
密码。 重启
httpd
服务:# systemctl restart httpd.service
重启
Directory
服务:# systemctl restart dirsrv@IDM-EXAMPLE-COM.service
- 在所有其他受影响的副本上执行上一步中的命令。
其它资源
-
man
ipa-server-certinstall(1)
- 过期后,如何在 RHEL 8 上手动续订身份管理(IPA)证书?(CA-less IPA)(Red Hat Knowledgebase)
- 转换证书格式以和 IdM 一起工作
第 16 章 在 IdM CA 服务器中生成 CRL
如果您的 IdM 部署使用嵌入式证书颁发机构(CA),您可能需要从一个 Identity Management(IdM)服务器中移动生成证书颁发机构列表(CRL)。例如,当您要将服务器迁移到另一个系统时,可能需要这样做。
仅配置一台服务器来生成 CRL。执行 CRL publisher 角色的 IdM 服务器通常与执行 CA 续订服务器角色的服务器相同,但这不是强制要求。在取消 CRL publisher 服务器前,选择并配置另一个服务器来执行 CRL publisher 服务器角色。
16.1. 在 IdM 服务器中停止 CRL 生成
要停止在 IdM CRL 发布程序服务器上生成证书撤销列表(CRL),请使用 ipa-crlgen-manage
命令。在禁用生成前,请验证服务器是否确实生成 CRL。然后您可以禁用它。
先决条件
- 身份管理(IdM)服务器安装在 RHEL 8.1 系统或更新版本中。
- 您必须以 root 身份登录。
流程
检查您的服务器是否正在生成 CRL:
[root@server ~]# ipa-crlgen-manage status CRL generation: enabled Last CRL update: 2019-10-31 12:00:00 Last CRL Number: 6 The ipa-crlgen-manage command was successful
停止在服务器上生成 CRL:
[root@server ~]# ipa-crlgen-manage disable Stopping pki-tomcatd Editing /var/lib/pki/pki-tomcat/conf/ca/CS.cfg Starting pki-tomcatd Editing /etc/httpd/conf.d/ipa-pki-proxy.conf Restarting httpd CRL generation disabled on the local host. Please make sure to configure CRL generation on another master with ipa-crlgen-manage enable. The ipa-crlgen-manage command was successful
检查服务器是否停止生成 CRL:
[root@server ~]# ipa-crlgen-manage status
服务器停止生成 CRL。下一步是在 IdM 副本中启用 CRL 生成。
16.2. 在 IdM 副本服务器中启动 CRL 生成
您可以使用 ipa-crlgen-manage
命令在 IdM CA 服务器上开始生成证书撤销列表(CRL)。
先决条件
- 身份管理(IdM)服务器安装在 RHEL 8.1 系统或更新版本中。
- RHEL 系统必须是 IdM 证书颁发机构服务器。
- 您必须以 root 身份登录。
流程
开始生成 CRL:
[root@replica1 ~]# ipa-crlgen-manage enable Stopping pki-tomcatd Editing /var/lib/pki/pki-tomcat/conf/ca/CS.cfg Starting pki-tomcatd Editing /etc/httpd/conf.d/ipa-pki-proxy.conf Restarting httpd Forcing CRL update CRL generation enabled on the local host. Please make sure to have only a single CRL generation master. The ipa-crlgen-manage command was successful
检查是否生成 CRL:
[root@replica1 ~]# ipa-crlgen-manage status CRL generation: enabled Last CRL update: 2019-10-31 12:10:00 Last CRL Number: 7 The ipa-crlgen-manage command was successful
16.3. 更改 CRL 更新间隔
默认情况下,证书撤销列表(CRL)文件由身份管理证书颁发机构(Idm CA)自动生成。您可以按照以下流程更改此间隔。
流程
停止 CRL 生成服务器:
# systemctl stop pki-tomcatd@pki-tomcat.service
打开
/var/lib/pki/pki-tomcat/conf/ca/CS.cfg
文件,并将ca.crl.MasterCRL.autoUpdateInterval
值改为新的间隔设置。例如,每隔 60 分钟生成 CRL:ca.crl.MasterCRL.autoUpdateInterval=60
注意如果您更新了
ca.crl.MasterCRL.autoUpdateInterval
参数,则更改将在下一次计划的 CRL 更新后生效。启动 CRL 生成服务器:
# systemctl start pki-tomcatd@pki-tomcat.service
其它资源
- 有关 IdM 副本服务器上的 CRL 生成的更多信息,请参阅在 IdM 副本服务器上启动 CRL 生成。
第 17 章 弃用执行 CA 续订服务器和 CRL publisher 角色的服务器
您可能有一个服务器执行证书颁发机构(CA)续订服务器角色以及证书 Revocation List(CRL)publisher 角色。如果您需要脱机或停用这个服务器,请选择另一个 CA 服务器来执行这些角色。
在本例中,主机 server.idm.example.com
必须停用实现 CA 续订服务器和 CRL publisher 角色。此流程将 CA 续订服务器和 CRL publisher 角色传送到主机 replica.idm.example.com
,并从 IdM 环境中删除 server.idm.example.com
。
您不需要配置同一服务器来执行 CA 续订服务器和 CRL publisher 角色。
先决条件
- 有 IdM 管理员凭证。
- 您有您要停用的服务器的 root 密码。
- IdM 环境中至少有两个 CA 副本。
流程
获取 IdM 管理员凭证:
[user@server ~]$ kinit admin Password for admin@IDM.EXAMPLE.COM:
可选:如果您不确定哪些服务器执行 CA 续订服务器和 CRL 发布者角色:
显示当前的 CA 续订服务器。您可以从任何 IdM 服务器运行以下命令:
[user@server ~]$ ipa config-show | grep 'CA renewal' IPA CA renewal master: server.idm.example.com
测试主机是否为当前的 CRL publisher。
[user@server ~]$ ipa-crlgen-manage status CRL generation: enabled Last CRL update: 2019-10-31 12:00:00 Last CRL Number: 6 The ipa-crlgen-manage command was successful
不生成 CRL 的 CA 服务器显示
CRL 生成:禁用
。[user@replica ~]$ ipa-crlgen-manage status CRL generation: disabled The ipa-crlgen-manage command was successful
继续在 CA 服务器上输入这个命令,直到您找到了 CRL publisher 服务器。
显示您可以提升以履行这些角色的所有其他 CA 服务器。此环境有两个 CA 服务器。
[user@server ~]$ ipa server-role-find --role 'CA server' ---------------------- 2 server roles matched ---------------------- Server name: server.idm.example.com Role name: CA server Role status: enabled Server name: replica.idm.example.com Role name: CA server Role status: enabled ---------------------------- Number of entries returned 2 ----------------------------
将
replica.idm.example.com
设置为 CA 续订服务器。[user@server ~]$ ipa config-mod --ca-renewal-master-server replica.idm.example.com
在
server.idm.example.com
中:禁用证书更新器任务:
[root@server ~]# pki-server ca-config-set ca.certStatusUpdateInterval 0
重启 IdM 服务:
[root@server ~]# ipactl restart
在
replica.idm.example.com
中:启用证书更新器任务:
[root@replica ~]# pki-server ca-config-unset ca.certStatusUpdateInterval
重启 IdM 服务:
[root@replica ~]# ipactl restart
在
server.idm.example.com
上,停止生成 CRL。[user@server ~]$ ipa-crlgen-manage disable Stopping pki-tomcatd Editing /var/lib/pki/pki-tomcat/conf/ca/CS.cfg Starting pki-tomcatd Editing /etc/httpd/conf.d/ipa-pki-proxy.conf Restarting httpd CRL generation disabled on the local host. Please make sure to configure CRL generation on another master with ipa-crlgen-manage enable. The ipa-crlgen-manage command was successful
在
replica.idm.example.com
上,开始生成 CRL。[user@replica ~]$ ipa-crlgen-manage enable Stopping pki-tomcatd Editing /var/lib/pki/pki-tomcat/conf/ca/CS.cfg Starting pki-tomcatd Editing /etc/httpd/conf.d/ipa-pki-proxy.conf Restarting httpd Forcing CRL update CRL generation enabled on the local host. Please make sure to have only a single CRL generation master. The ipa-crlgen-manage command was successful
停止
server.idm.example.com
中的 IdM 服务:[root@server ~]# ipactl stop
在
replica.idm.example.com
中,从 IdM 环境中删除server.idm.example.com
。[user@replica ~]$ ipa server-del server.idm.example.com
在
server.idm.example.com
中,使用ipa-server-install --uninstall
命令作为 root 帐户:[root@server ~]# ipa-server-install --uninstall ... Are you sure you want to continue with the uninstall procedure? [no]: yes
验证
显示当前的 CA 续订服务器。
[user@replica ~]$ ipa config-show | grep 'CA renewal' IPA CA renewal master: replica.idm.example.com
确认
replica.idm.example.com
主机正在生成 CRL。[user@replica ~]$ ipa-crlgen-manage status CRL generation: enabled Last CRL update: 2019-10-31 12:10:00 Last CRL Number: 7 The ipa-crlgen-manage command was successful
第 18 章 使用 certmonger 为服务获取 IdM 证书
18.1. Certmonger 概述
当 Identity Management(IdM)安装集成 IdM 证书颁发机构(CA)时,它将使用 certmonger 服务
来跟踪和续订系统和服务证书。当证书到达过期日期时,certmonger 通过以下
方法管理续订过程:
- 使用原始请求中提供的选项来重新生成一个证书签名请求(CSR)。
-
使用 IdM API
cert-request
命令将 CSR 提交到 IdM CA。 - 从 IdM CA 接收证书。
- 如果原始请求指定了,则执行预先保存的命令。
-
在续订请求中指定的位置安装新证书:在
NSS
数据库或一个文件中。 -
如果原始请求指定了,则执行保存后的命令。例如,保存后命令可以指示
certmonger 重新启动
相关服务,以便服务获取新证书。
证书类型 certmonger
跟踪
证书可分为系统和服务证书。
与服务证书(例如 HTTP
、LDAP
和 PKINIT
)不同,后者在不同服务器上具有不同的密钥对和主题名称,IdM 系统证书及其密钥由所有 CA 副本共享。IdM 系统证书包括:
-
IdM CA
证书 -
OCSP
签名证书 -
IdM CA 子系统
证书 -
IdM CA 审计签名
证书 -
IdM 续订代理
(RA)证书 -
KRA
传输和存储证书
certmonger
服务跟踪在安装带有集成 CA 的 IdM 环境期间请求的 IdM 系统和服务证书。Certmonger 还
跟踪系统管理员为 IdM 主机上运行的其他服务手动请求的证书。Certmonger
不会跟踪外部 CA 证书或用户证书。
Certmonger 组件
certmonger
服务由两个主要组件组成:
-
certmonger 守护进程
,即引擎跟踪证书列表并启动续订命令 -
命令行(CLI)的
getcert
工具允许系统管理员主动向certmonger
守护进程发送命令。
更具体来说,系统管理员可以使用 getcert
工具程序:
18.2. 使用 certmonger 为服务获取 IdM 证书
为确保浏览器和身份管理(IdM)客户端上运行的 Web 服务之间的通信安全且加密,请使用 TLS 证书。从 IdM 证书颁发机构(CA)获取您的 Web 服务的 TLS 证书。
按照以下流程,使用 certmonger
获取在 IdM 客户端上运行的服务(HTTP/my_company.idm.example.com
@IDM.EXAMPLE.COM
)的 IdM 证书。
使用 证书监控
器自动请求证书意味着,certmonger
在到期需要续订时管理和续订证书。
有关 certmonger
请求服务证书时发生的可视化表示,请参阅 certmonger 请求服务证书的通信流。
先决条件
- Web 服务器已注册为 IdM 客户端。
- 您有正在运行的 IdM 客户端的 root 访问权限。
- 请求证书的服务不必在 IdM 中预先存在。
流程
在运行
HTTP
服务的 my_company.idm.example.com
IdM 客户端中,请求与HTTP/my_company.idm.example.com@IDM.EXAMPLE.COM
主体对应的服务的证书,并指定:-
证书将存储在本地
/etc/pki/tls/certs/httpd.pem
文件中 -
私钥存储在本地
/etc/pki/tls/private/httpd.key
文件中 将
SubjectAltName
的 extensionRequest 添加到签名请求中,其 DNS 名称为my_company.idm.example.com
:# ipa-getcert request -K HTTP/my_company.idm.example.com -k /etc/pki/tls/private/httpd.key -f /etc/pki/tls/certs/httpd.pem -g 2048 -D my_company.idm.example.com -C "systemctl restart httpd" New signing request "20190604065735" added.
在以上命令中:
-
ipa-getcert request
命令指定要从 IdM CA 获取证书。ipa-getcert request
命令是getcert request -c IPA
的快捷方式。 -
g
选项指定要生成的密钥的大小(如果尚未到位)。 -
D
选项指定
要添加到请求的SubjectAltName
DNS 值。 -
C
选项
指示certmonger 在获取证书后重新启动
httpd
服务。
-
要指定证书与特定的配置集一起发布,请使用
-T
选项。 -
要使用指定的 CA 中的指定签发者请求证书,请使用
-X ISSUER
选项。
注意RHEL 8 在 Apache 中使用与 RHEL 7 中使用的不同的 SSL 模块。SSL 模块依赖于 OpenSSL 而不是 NSS。因此,在 RHEL 8 中,您无法使用 NSS 数据库存储
HTTPS
证书和私钥。-
-
证书将存储在本地
可选:检查请求的状态:
# ipa-getcert list -f /etc/pki/tls/certs/httpd.pem Number of certificates and requests being tracked: 3. Request ID '20190604065735': status: MONITORING stuck: no key pair storage: type=FILE,location='/etc/pki/tls/private/httpd.key' certificate: type=FILE,location='/etc/pki/tls/certs/httpd.crt' CA: IPA [...]
输出显示请求处于 MONITOR
ING
状态,这表示已获取了证书。密钥对和证书的位置是请求的位置。
18.3. 请求服务证书的证书的通信流
这些图显示了当 certmonger
从身份管理(IdM)证书认证机构(CA)服务器请求服务证书时发生什么情况的阶段。序列由这些图表组成:
未加密通信 显示初始情况:没有 HTTPS 证书,Web 服务器之间的通信和浏览器未加密。
图 18.1. 未加密的通信

请求服务证书的 certmonger 显示系统管理员使用 certmonger
手动为 Apache web 服务器请求 HTTPS 证书。请注意,在请求 Web 服务器证书时,certmonger 不会直接与 CA 通信。它通过 IdM 代理。
图 18.2. Certmonger 请求服务证书

发出服务证书的 IdM CA 显示为 web 服务器发出 HTTPS 证书的 IdM CA。
图 18.3. 发布服务证书的 IdM CA

Certmonger 应用服务证书显示,certmonger
把 HTTPS 证书放置到 IdM 客户端的正确位置,如果指定,会重启 httpd
服务。随后 Apache 服务器使用 HTTPS 证书来加密自身和浏览器之间的流量。
图 18.4. Certmonger 应用服务证书

当旧证书接近过期时,cert monger
会在证书过期前自动从 IdM CA 续订服务证书。IdM CA 发布一个新证书。
图 18.5. 当旧证书即将过期时,Certmonger 请求一个新证书

18.4. 查看由 certmonger 跟踪的证书请求的详情
certmonger 服务
监控证书请求。成功签署证书请求后,会生成证书。Certmonger
管理证书请求,包括生成的证书。按照以下流程查看由 certmonger
管理的特定证书请求的详情。
流程
如果您知道如何指定证书请求,请只列出该特定证书请求的详细信息。例如,您可以指定:
- 请求 ID
- 证书的位置
证书 nickname
例如,要查看请求 ID 为 20190408143846 的证书详情,请使用
-v
选项查看您的证书请求失败时的所有错误详情:# getcert list -i 20190408143846 -v Number of certificates and requests being tracked: 16. Request ID '20190408143846': status: MONITORING stuck: no key pair storage: type=NSSDB,location='/etc/dirsrv/slapd-IDM-EXAMPLE-COM',nickname='Server-Cert',token='NSS Certificate DB',pinfile='/etc/dirsrv/slapd-IDM-EXAMPLE-COM/pwdfile.txt' certificate: type=NSSDB,location='/etc/dirsrv/slapd-IDM-EXAMPLE-COM',nickname='Server-Cert',token='NSS Certificate DB' CA: IPA issuer: CN=Certificate Authority,O=IDM.EXAMPLE.COM subject: CN=r8server.idm.example.com,O=IDM.EXAMPLE.COM expires: 2021-04-08 16:38:47 CEST dns: r8server.idm.example.com principal name: ldap/server.idm.example.com@IDM.EXAMPLE.COM key usage: digitalSignature,nonRepudiation,keyEncipherment,dataEncipherment eku: id-kp-serverAuth,id-kp-clientAuth pre-save command: post-save command: /usr/libexec/ipa/certmonger/restart_dirsrv IDM-EXAMPLE-COM track: true auto-renew: true
输出显示有关证书的几段信息,例如:
-
证书位置;在上面的示例中,它是
/etc/dirsrv/slapd-IDM-EXAMPLE-COM
目录中的 NSS 数据库 -
证书 nickname;上例中为
Server-Cert
-
存储 pin 的文件;在上面的示例中,该文件为
/etc/dirsrv/slapd-IDM-EXAMPLE-COM/pwdfile.txt
-
将用于续订证书的证书颁发机构(CA);上例中为
IPA
CA -
到期日期;上例中为
2021-04-08 16:38:47 CEST
-
证书的状态;上例中,MON
ITORING
状态表示证书有效并且被跟踪。 -
保存后的命令;在上面的示例中,这是
LDAP
服务的重新启动。
如果您不知道如何指定证书请求,请列出
certmonger 监控
或尝试获取的所有证书的详情:# getcert list
其它资源
-
请参阅您系统上的
getcert list
手册页。
18.5. 启动和停止证书跟踪
按照以下流程,使用 getcert stop-tracking
和 getcert start-tracking
命令来监控证书。这两个命令由 certmonger 服务提供
。如果您已经从不同的 IdM 客户端上导入了身份管理(IdM)证书认证机构(CA)签发的证书,启用证书跟踪特别有用。启用证书跟踪也可以是以下置备方案的最后一步:
- 在 IdM 服务器上,您可以为尚不存在的系统创建一个证书。
- 您可以创建新系统。
- 将新系统注册为 IdM 客户端。
- 您可以将证书和密钥从 上的 IdM 服务器导入到 IdM 客户端。
-
您开始使用
certmonger 来跟踪
证书,以确保其在过期时得到续订。
流程
使用 Request ID 20190408143846 禁用对证书的监控:
# getcert stop-tracking -i 20190408143846
有关更多选项,请参阅您系统上的
getcert stop-tracking
手册页。要启用对存储在
/tmp/some_cert.crt
文件中的证书的监控,其私钥存储在/tmp/some_key.key
文件中:# getcert start-tracking -c IPA -f /tmp/some_cert.crt -k /tmp/some_key.key
Certmonger
无法自动识别发布证书的 CA 类型。因此,如果 IdM CA 签发证书,将-c
选项与IPA
值一起添加到getcert start-tracking
命令中。省略添加-c
选项会导致certmonger 进入
NEED_CA 状态。有关更多选项,请参阅您系统上的
getcert start-tracking
手册页。
这两个命令不操作证书。例如,getcert stop-tracking
不会删除证书或将其从 NSS 数据库或文件系统中删除,只是将证书从受监控的证书列表中删除。同样,getcert start-tracking
只会在受监控证书列表中添加证书。
18.6. 手动续订证书
当证书即将到期时,certmonger 守护进程
会自动使用证书颁发机构(CA)帮助程序发出续订命令,获取更新的证书,并将上一个证书替换为新证书。
您还可以使用 getcert resubmit
命令提前手动续订证书。这样,您可以通过添加主题备用名称(SAN)来更新证书包含的信息。
按照以下流程手动续订证书。
流程
使用 Request ID 20190408143846 续订证书:
# getcert resubmit -i 20190408143846
要获取特定证书的 Request ID,请使用
getcert list
命令。详情请查看您系统上的getcert list
手册页。
18.7. 使certmonger 恢复跟踪 CA 副本中的 IdM 证书
此流程演示了如何在跟踪 证书中断后使证书恢复
跟踪对使用集成证书颁发机构的 IdM 部署至关重要的 Identity Management(IdM)系统证书。中断可能是由在续订系统证书期间从 IdM 主机取消滚动,或者复制拓扑无法正常工作造成的。该程序还演示了如何使 证书恢复
跟踪 IdM 服务证书,即 HTTP
、LDAP
和 PKINIT
证书。
先决条件
- 要恢复跟踪系统证书的主机是一个 IdM 服务器,它也是 IdM 证书颁发机构(CA),而不是 IdM CA 续订服务器。
流程
获取子系统 CA 证书的 PIN:
# grep 'internal=' /var/lib/pki/pki-tomcat/conf/password.conf
添加跟踪到子系统 CA 证书,将以下命令中的
[internal PIN]
替换为上一步中获取的 PIN:# getcert start-tracking -d /etc/pki/pki-tomcat/alias -n "caSigningCert cert-pki-ca" -c 'dogtag-ipa-ca-renew-agent' -P [internal PIN] -B /usr/libexec/ipa/certmonger/stop_pkicad -C '/usr/libexec/ipa/certmonger/renew_ca_cert "caSigningCert cert-pki-ca"' -T caCACert # getcert start-tracking -d /etc/pki/pki-tomcat/alias -n "auditSigningCert cert-pki-ca" -c 'dogtag-ipa-ca-renew-agent' -P [internal PIN] -B /usr/libexec/ipa/certmonger/stop_pkicad -C '/usr/libexec/ipa/certmonger/renew_ca_cert "auditSigningCert cert-pki-ca"' -T caSignedLogCert # getcert start-tracking -d /etc/pki/pki-tomcat/alias -n "ocspSigningCert cert-pki-ca" -c 'dogtag-ipa-ca-renew-agent' -P [internal PIN] -B /usr/libexec/ipa/certmonger/stop_pkicad -C '/usr/libexec/ipa/certmonger/renew_ca_cert "ocspSigningCert cert-pki-ca"' -T caOCSPCert # getcert start-tracking -d /etc/pki/pki-tomcat/alias -n "subsystemCert cert-pki-ca" -c 'dogtag-ipa-ca-renew-agent' -P [internal PIN] -B /usr/libexec/ipa/certmonger/stop_pkicad -C '/usr/libexec/ipa/certmonger/renew_ca_cert "subsystemCert cert-pki-ca"' -T caSubsystemCert # getcert start-tracking -d /etc/pki/pki-tomcat/alias -n "Server-Cert cert-pki-ca" -c 'dogtag-ipa-ca-renew-agent' -P [internal PIN] -B /usr/libexec/ipa/certmonger/stop_pkicad -C '/usr/libexec/ipa/certmonger/renew_ca_cert "Server-Cert cert-pki-ca"' -T caServerCert
添加对剩余的 IdM 证书、HTTP、
LDAP
、
IPA 续订代理
和PKINIT 证书的
跟踪:# getcert start-tracking -f /var/lib/ipa/certs/httpd.crt -k /var/lib/ipa/private/httpd.key -p /var/lib/ipa/passwds/idm.example.com-443-RSA -c IPA -C /usr/libexec/ipa/certmonger/restart_httpd -T caIPAserviceCert # getcert start-tracking -d /etc/dirsrv/slapd-IDM-EXAMPLE-COM -n "Server-Cert" -c IPA -p /etc/dirsrv/slapd-IDM-EXAMPLE-COM/pwdfile.txt -C '/usr/libexec/ipa/certmonger/restart_dirsrv "IDM-EXAMPLE-COM"' -T caIPAserviceCert # getcert start-tracking -f /var/lib/ipa/ra-agent.pem -k /var/lib/ipa/ra-agent.key -c dogtag-ipa-ca-renew-agent -B /usr/libexec/ipa/certmonger/renew_ra_cert_pre -C /usr/libexec/ipa/certmonger/renew_ra_cert -T caSubsystemCert # getcert start-tracking -f /var/kerberos/krb5kdc/kdc.crt -k /var/kerberos/krb5kdc/kdc.key -c dogtag-ipa-ca-renew-agent -B /usr/libexec/ipa/certmonger/renew_ra_cert_pre -C /usr/libexec/ipa/certmonger/renew_kdc_cert -T KDCs_PKINIT_Certs
重启证书
:# systemctl restart certmonger
等待一分钟,直到
certmonger
启动后,然后检查新证书的状态:# getcert list
注意以下几点:
- 如果您的 IdM 系统证书已过期,请参阅红帽知识库解决方案 如何在 RHEL7/RHEL 8 上手动续订身份管理(IPA)证书? 是否手动续订 IdM CA 服务器上的 IdM 系统证书,以及 CA 续订服务器和 CRL 发布者服务器。
- 按照红帽知识库解决方案中描述的步骤,如何在 RHEL7 上手动续订 RHEL7 上的身份管理(IPA)证书? 在拓扑中所有其他 CA 服务器上手动续订 IdM 系统证书。
18.8. 将 SCEP 与 certmonger 搭配使用
简单证书注册协议(SCEP)是一种证书管理协议,您可以在不同的设备和操作系统间使用。如果您在环境中使用 SCEP 服务器作为外部证书颁发机构(CA),您可以使用 certmonger
为身份管理(IdM)客户端获取证书。
18.8.1. SCEP 概述
简单证书注册协议(SCEP)是一种证书管理协议,您可以在不同的设备和操作系统间使用。您可以使用 SCEP 服务器作为外部证书颁发机构(CA)。
您可以配置身份管理(IdM)客户端,以通过 HTTP 直接从 CA SCEP 服务请求和检索证书。此过程是由一个共享 secret 保护的,该 secret 通常只在有限时间内有效。
在客户端,SCEP 要求您提供以下组件:
- SCEP URL:CA SCEP 接口的 URL。
-
SCEP 共享 secret:一个在 CA 和 SCEP 客户端之间共享的
challengePassword
PIN,用于获取证书。
然后,客户端通过 SCEP 检索 CA 证书链,并将证书签名请求发送到 CA。
使用 certmonger
配置 SCEP 时,您可以创建一个指定签发的证书参数的新 CA 配置配置集。
18.8.2. 通过 SCEP 请求 IdM CA 签名证书
以下示例为 certmonger
添加 SCEP_example
SCEP CA 配置,并在 client.idm.example.com
IdM 客户端上请求新证书。certmonger
支持 NSS 证书数据库格式和基于文件的(PEM)格式,如 OpenSSL。
先决条件
- 您知道 SCEP URL。
-
您有
challengePassword
PIN 共享 secret。
流程
将 CA 配置添加到
certmonger
:[root@client.idm.example.com ~]# getcert add-scep-ca -c SCEP_example -u SCEP_URL
-
-c
: 为 CA 配置强制别名。之后,相同的值可以与其他getcert
命令一起使用。 -
U :服务器的 SCEP 接口的 URL。重要在使用 HTTPS URL 时,还必须使用
-R
选项指定 SCEP 服务器 CA 证书的 PEM 格式副本的位置。
-
验证 CA 配置是否已成功添加:
[root@client.idm.example.com ~]# getcert list-cas -c SCEP_example CA 'SCEP_example': is-default: no ca-type: EXTERNAL helper-location: /usr/libexec/certmonger/scep-submit -u http://SCEP_server_enrollment_interface_URL SCEP CA certificate thumbprint (MD5): A67C2D4B 771AC186 FCCA654A 5E55AAF7 SCEP CA certificate thumbprint (SHA1): FBFF096C 6455E8E9 BD55F4A5 5787C43F 1F512279
如果成功添加了配置,certmonger 会从远程 CA 检索 CA 链。然后,CA 链在命令输出中显示为 thumbprints。通过未加密的 HTTP 访问服务器时,请手动将 thumbprints 与 SCEP 服务器中显示的内容进行比较,以防止中间人攻击。
从 CA 请求证书:
如果您使用 NSS:
[root@client.idm.example.com ~]# getcert request -I Example_Task -c SCEP_example -d /etc/pki/nssdb -n ExampleCert -N cn="client.idm.example.com" -L one-time_PIN -D client.idm.example.com
您可以使用选项来指定证书请求的以下参数:
-
-
i :(可选) 任务的 Name:请求的跟踪 ID。之后,相同的值可以和getcert list
命令一起使用。 -
-c
: 将请求提交到的 CA 配置。 -
-d
:使用 NSS 数据库存储证书和密钥的目录。 -
-n
: NSS 数据库中使用的证书的 Nickname。 -
-n
: CSR 中的 Subject 名称。 -
-L
: CA 发布的时间限制的一次性质询Password
PIN。 -
-
d :证书的主题备用名称,通常与主机名相同。
-
如果使用 OpenSSL:
[root@client.idm.example.com ~]# getcert request -I Example_Task -c SCEP_example -f /etc/pki/tls/certs/server.crt -k /etc/pki/tls/private/private.key -N cn="client.idm.example.com" -L one-time_PIN -D client.idm.example.com
您可以使用选项来指定证书请求的以下参数:
-
-
i :(可选) 任务的 Name:请求的跟踪 ID。之后,相同的值可以和getcert list
命令一起使用。 -
-c
: 将请求提交到的 CA 配置。 -
-f
:证书的存储路径。 -
-k
:密钥的存储路径。 -
-n
: CSR 中的 Subject 名称。 -
-L
: CA 发布的时间限制的一次性质询Password
PIN。 -
-
d :证书的主题备用名称,通常与主机名相同。
-
验证
验证证书是否已发布并正确存储在本地数据库中:
如果您使用的 NSS,请输入:
[root@client.idm.example.com ~]# getcert list -I Example_Task Request ID 'Example_Task': status: MONITORING stuck: no key pair storage: type=NSSDB,location='/etc/pki/nssdb',nickname='ExampleCert',token='NSS Certificate DB' certificate: type=NSSDB,location='/etc/pki/nssdb',nickname='ExampleCert',token='NSS Certificate DB' signing request thumbprint (MD5): 503A8EDD DE2BE17E 5BAA3A57 D68C9C1B signing request thumbprint (SHA1): B411ECE4 D45B883A 75A6F14D 7E3037F1 D53625F4 CA: IPA issuer: CN=Certificate Authority,O=EXAMPLE.COM subject: CN=client.idm.example.com,O=EXAMPLE.COM expires: 2018-05-06 10:28:06 UTC key usage: digitalSignature,keyEncipherment eku: iso.org.dod.internet.security.mechanisms.8.2.2 certificate template/profile: IPSECIntermediateOffline pre-save command: post-save command: track: true auto-renew: true
如果使用 OpenSSL,请输入:
[root@client.idm.example.com ~]# getcert list -I Example_Task Request ID 'Example_Task': status: MONITORING stuck: no key pair storage: type=FILE,location='/etc/pki/tls/private/private.key' certificate: type=FILE,location='/etc/pki/tls/certs/server.crt' CA: IPA issuer: CN=Certificate Authority,O=EXAMPLE.COM subject: CN=client.idm.example.com,O=EXAMPLE.COM expires: 2018-05-06 10:28:06 UTC eku: id-kp-serverAuth,id-kp-clientAuth pre-save command: post-save command: track: true auto-renew: true
状态 MONITORING 表示成功检索发布的证书。
getcert-list (1)
手册页列出了其他可能的状态及其含义。
其它资源
-
有关请求证书时的更多选项,请参阅您系统上的
getcert-request (1)
手册页。
18.8.3. 使用 certmonger 自动更新 AD SCEP 证书
当 certmonger
发送 SCEP 证书续订请求时,这个请求将使用现有的证书私钥签名。但是,certmonger
发送的续订请求还包括最初获取证书的 challengePassword
PIN。
用作 SCEP 服务器的 Active Directory (AD)网络设备注册服务(NDES)服务器会自动拒绝包含原始 challengePassword
PIN 的续订请求。因此,续订会失败。
要使 AD 的续订正常工作,您需要配置 certmonger
来发送签名的续订请求,而无需 challengePassword
PIN。您还需要配置 AD 服务器,使其不会在续订时比较主题名称。
AD 以外的 SCEP 服务器可能会拒绝包含 challengePassword
的请求。在这些情况下,您可能还需要以这种方式更改 certmonger
配置。
先决条件
- RHEL 服务器必须运行 RHEL 8.6 或更高版本。
流程
-
在 AD 服务器上打开
regedit
。 -
在 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Cryptography\MSCEP 子键中,添加一个新的 32 位 REG_DWORD 条目
DisableRenewalSubjectNameMatch
,并将其值设为1
。 在运行
certmonger
的服务器上,打开/etc/certmonger/certmonger.conf
文件,并添加以下部分:[scep] challenge_password_otp = yes
重启 certmonger:
# systemctl restart certmonger
第 19 章 从 CA 请求证书并使用 RHEL 系统角色创建自签名证书
许多服务(如 Web 服务器)都使用 TLS 加密与客户端的连接。这些服务需要私钥和证书,以及为证书签名的可信证书颁发机构(CA)。
通过使用 certificate
RHEL 系统角色,您可以在受管节点上自动生成私钥。另外,该角色将 certmonger
服务配置为向 CA 发送证书签名请求(CSR),服务会在证书过期前自动更新证书。
出于测试目的,您可以使用 certificate
角色创建自签名证书,而不是从 CA 请求签名证书。
19.1. 使用 certificate
RHEL 系统角色从 IdM CA 请求一个新证书
如果 Red Hat Enterprise Linux 主机是 RHEL 身份管理(IdM)环境的成员,您可以从 IdM 证书颁发机构(CA)请求 TLS 证书,并在此主机上运行的服务中使用它们。通过使用 证书
RHEL 系统角色,您可以自动创建私钥的过程,并让 certmonger
服务从 CA 请求证书。默认情况下,certmonger
会在证书过期前更新证书。
先决条件
- 您已准备好控制节点和受管节点
- 以可在受管主机上运行 playbook 的用户登录到控制节点。
-
用于连接到受管节点的帐户具有
sudo
权限。 - 受管节点是 IdM 域的成员,域使用 IdM 集成的 CA。
流程
创建一个包含以下内容的 playbook 文件,如
~/playbook.yml
:--- - name: Create certificates hosts: managed-node-01.example.com tasks: - name: Create a self-signed certificate ansible.builtin.include_role: name: rhel-system-roles.certificate vars: certificate_requests: - name: web-server ca: ipa dns: www.example.com principal: HTTP/www.example.com@EXAMPLE.COM run_before: systemctl stop httpd.service run_after: systemctl start httpd.service
示例 playbook 中指定的设置包括以下内容:
name: <path_or_file_name>
定义生成的私钥和证书文件的名称或路径:
-
如果将变量设置为
web-server
,该角色会将私钥存储在/etc/pki/tls/private/web-server.key
中,并将证书存储在/etc/pki/tls/certs/web-server.crt
文件中。 如果将变量设置为路径,如
/tmp/web-server
,该角色会将私钥存储在/tmp/web-server.key
中,并将证书存储在/tmp/web-server.crt
文件中。请注意,您使用的目录必须设置
cert_t
SELinux 上下文。您可以使用selinux
RHEL 系统角色来管理 SELinux 上下文。
-
如果将变量设置为
ca: ipa
- 定义该角色从 IdM CA 请求证书。
dns: <hostname_or_list_of_hostnames>
-
设置发布的证书中的 Subject Alternative Names (SAN)字段所包含的主机名。您可以使用通配符(
*
)或以 YAML 列表格式指定多个名称。 principal: <kerberos_principal>
- 可选:设置证书中包含的 Kerberos 主体。
run_before: <command>
-
可选:定义
certmonger
在从 CA 请求证书前应执行的命令。 run_after: < command>
-
可选:定义
certmonger
应该在从 CA 收到发布的证书后执行的命令。
有关 playbook 中使用的所有变量的详情,请查看控制节点上的
/usr/share/ansible/roles/rhel-system-roles.certificate/README.md
文件。验证 playbook 语法:
$ ansible-playbook --syntax-check ~/playbook.yml
请注意,这个命令只验证语法,不会防止错误但有效的配置。
运行 playbook:
$ ansible-playbook ~/playbook.yml
验证
列出
certmonger
服务管理的证书:# ansible managed-node-01.example.com -m command -a 'getcert list' ... Number of certificates and requests being tracked: 1. Request ID '20240918142211': status: MONITORING stuck: no key pair storage: type=FILE,location='/etc/pki/tls/private/web-server.key' certificate: type=FILE,location='/etc/pki/tls/certs/web-server.crt' CA: IPA issuer: CN=Certificate Authority,O=EXAMPLE.COM subject: CN=www.example.com issued: 2024-09-18 16:22:11 CEST expires: 2025-09-18 16:22:10 CEST dns: www.example.com key usage: digitalSignature,keyEncipherment eku: id-kp-serverAuth,id-kp-clientAuth pre-save command: systemctl stop httpd.service post-save command: systemctl start httpd.service track: yes auto-renew: yes
其它资源
-
/usr/share/ansible/roles/rhel-system-roles.certificate/README.md
文件 -
/usr/share/doc/rhel-system-roles/certificate/
目录
19.2. 使用 certificate
RHEL 系统角色请求一个新的自签名证书
如果需要测试环境的 TLS 证书,您可以使用自签名证书。通过使用 证书
RHEL 系统角色,您可以自动创建私钥并让 certmonger
服务创建自签名证书。默认情况下,certmonger
会在证书过期前更新证书。
先决条件
- 您已准备好控制节点和受管节点
- 以可在受管主机上运行 playbook 的用户登录到控制节点。
-
用于连接到受管节点的帐户具有
sudo
权限。
流程
创建一个包含以下内容的 playbook 文件,如
~/playbook.yml
:--- - name: Create certificates hosts: managed-node-01.example.com tasks: - name: Create a self-signed certificate ansible.builtin.include_role: name: rhel-system-roles.certificate vars: certificate_requests: - name: web-server ca: self-sign dns: test.example.com
示例 playbook 中指定的设置包括以下内容:
name: <path_or_file_name>
定义生成的私钥和证书文件的名称或路径:
-
如果将变量设置为
web-server
,该角色会将私钥存储在/etc/pki/tls/private/web-server.key
中,并将证书存储在/etc/pki/tls/certs/web-server.crt
文件中。 如果将变量设置为路径,如
/tmp/web-server
,该角色会将私钥存储在/tmp/web-server.key
中,并将证书存储在/tmp/web-server.crt
文件中。请注意,您使用的目录必须设置
cert_t
SELinux 上下文。您可以使用selinux
RHEL 系统角色来管理 SELinux 上下文。
-
如果将变量设置为
ca: self-sign
- 定义该角色创建了自签名证书。
dns: <hostname_or_list_of_hostnames>
-
设置发布的证书中的 Subject Alternative Names (SAN)字段所包含的主机名。您可以使用通配符(
*
)或以 YAML 列表格式指定多个名称。
有关 playbook 中使用的所有变量的详情,请查看控制节点上的
/usr/share/ansible/roles/rhel-system-roles.certificate/README.md
文件。验证 playbook 语法:
$ ansible-playbook --syntax-check ~/playbook.yml
请注意,这个命令只验证语法,不会防止错误但有效的配置。
运行 playbook:
$ ansible-playbook ~/playbook.yml
验证
列出
certmonger
服务管理的证书:# ansible managed-node-01.example.com -m command -a 'getcert list' ... Number of certificates and requests being tracked: 1. Request ID '20240918133610': status: MONITORING stuck: no key pair storage: type=FILE,location='/etc/pki/tls/private/web-server.key' certificate: type=FILE,location='/etc/pki/tls/certs/web-server.crt' CA: local issuer: CN=c32b16d7-5b1a4c5a-a953a711-c3ca58fb,CN=Local Signing Authority subject: CN=test.example.com issued: 2024-09-18 15:36:10 CEST expires: 2025-09-18 15:36:09 CEST dns: test.example.com key usage: digitalSignature,keyEncipherment eku: id-kp-serverAuth,id-kp-clientAuth pre-save command: post-save command: track: yes auto-renew: yes
其它资源
-
/usr/share/ansible/roles/rhel-system-roles.certificate/README.md
文件 -
/usr/share/doc/rhel-system-roles/certificate/
目录
第 20 章 将应用程序限制为只信任证书的子集
如果您的 Identity Management(IdM)安装配置了集成证书系统(CS)证书颁发机构(CA),您可以创建轻量级子 CA。您创建的所有子 CA 都从属于证书系统的主 CA,即 ipa CA。
在这种情况下,轻量 级子 CA 意味着为特定目的发布证书的子 CA。例如,轻量级子 CA 允许您配置服务,如虚拟专用网络(VPN)网关和 Web 浏览器,以仅接受 子 CA A 发布的证书。通过将其他服务配置为仅接受由 子 CA B 发布的证书,您可以防止它们接受 子 CA、主 CA( 即 ipa
CA)和两者之间的任何中间子 CA 发布的证书。
如果您撤销了子 CA 的中间证书,则正确配置的客户端会自动将此子 CA 发布的所有证书视为无效。所有其他直接由 root CA、ipa 或其他 子 CA 发布的证书保持有效。
本节使用 Apache Web 服务器的示例来说明如何将应用限制为仅信任某一证书子集。完成本节以限制 IdM 客户端上运行的 Web 服务器使用 webserver-ca IdM 子 CA 发布的证书,并要求用户使用 web client-ca IdM 子 CA 发布的用户证书向 web 服务器进行身份验证。
您需要执行的步骤有:
- 创建 IdM 子 CA
- 从 IdM WebUI 下载子 CA 证书
- 创建 CA ACL,指定正确组合用户、服务和 CA,以及使用的证书配置集
- 从 IdM 子 CA 为运行在 IdM 客户端上的 web 服务请求证书
- 设置单实例 Apache HTTP 服务器
- 向 Apache HTTP 服务器添加 TLS 加密
- 在 Apache HTTP 服务器中设置支持的 TLS 协议版本
- 在 Apache HTTP 服务器上设置受支持的密码
- 在 web 服务器中配置 TLS 客户端证书身份验证
- 从 IdM 子 CA 为用户请求证书,并将证书导出到客户端
- 将用户证书导入到浏览器中,并将浏览器配置为信任子 CA 证书
20.1. 管理轻量级子 CA
这部分论述了如何管理轻量级从属证书颁发机构(sub-CA)。您创建的所有子 CA 都被从属到证书系统的主 CA( ipa
CA)。您还可以禁用和删除子 CA。
-
如果您删除子 CA,撤销对该子 CA 的调用检查将不再工作。只有当没有其
notAfter
过期时间是将来的子 CA 发布的证书时,才删除子 CA。 - 当仍存在由该子 CA 发布的证书时,您应该只禁用子 CA。如果子 CA 发布的所有证书都已过期,您可以删除该子 CA。
- 您无法禁用或删除 IdM CA。
有关管理子 CA 的详情,请参考:
20.1.1. 从 IdM WebUI 创建子 CA
按照以下流程,使用 IdM WebUI 创建名为 webserver-ca 和 webclient-ca 的新子 CA。
先决条件
- 确保您已获取管理员的凭据。
流程
- 在 身份验证 菜单中,单击 Certificates。
- 选择 证书授权 并单击 添加。
- 输入 webserver-ca 子 CA 的名称。在 Subject DN 字段中输入 Subject DN,如 CN=WEBSERVER,O=IDM.EXAMPLE.COM。请注意,主题 DN 在 IdM CA 基础架构中必须是唯一的。
- 输入 webclient-ca 子 CA 的名称。在 Subject DN 字段中输入 Subject DN CN=WEBCLIENT,O=IDM.EXAMPLE.COM。
在命令行中,运行
ipa-certupdate
命令为 webserver-ca 和 webclient-ca 子 CA 证书创建 certmonger 跟踪请求:[root@ipaserver ~]#
ipa-certupdate
重要在创建子 CA 后忘记运行
ipa-certupdate
命令意味着,如果子 CA 证书过期,则子 CA 发布的最终用户证书将被视为无效,即使最终用户证书还没有过期。
验证
验证新子 CA 的签名证书是否已添加到 IdM 数据库中:
[root@ipaserver ~]#
certutil -d /etc/pki/pki-tomcat/alias/ -L
Certificate Nickname Trust Attributes SSL,S/MIME,JAR/XPI caSigningCert cert-pki-ca CTu,Cu,Cu Server-Cert cert-pki-ca u,u,u auditSigningCert cert-pki-ca u,u,Pu caSigningCert cert-pki-ca ba83f324-5e50-4114-b109-acca05d6f1dc u,u,u ocspSigningCert cert-pki-ca u,u,u subsystemCert cert-pki-ca u,u,u注意新子 CA 证书自动传输到安装有证书系统实例的所有副本。
20.1.2. 从 IdM WebUI 中删除子 CA
按照以下流程删除 IdM Web UI 中的轻量级子 CA。
-
如果您删除子 CA,撤销对该子 CA 的调用检查将不再工作。只有当没有其
notAfter
过期时间是将来的子 CA 发布的证书时,才删除子 CA。 - 当仍存在由该子 CA 发布的证书时,您应该只禁用子 CA。如果子 CA 发布的所有证书都已过期,您可以删除该子 CA。
- 您无法禁用或删除 IdM CA。
先决条件
- 确保您已获取管理员的凭据。
- 您已在 IdM CLI 中禁用 sub-CA。请参阅 通过 IdM CLI 禁用子CA
流程
-
在 IdM WebUI 中,打开
Authentication
选项卡,然后选择证书
子选项卡。 -
选择
证书颁发机构
(CA) 选择要删除的子 CA,
再单击删除
。图 20.1. 删除 IdM Web UI 中的子 CA
-
单击
Delete
以确认。
子 CA 已从 证书颁发机构
列表中删除。
20.1.3. 通过 IdM CLI 创建子 CA
按照以下流程,使用 IdM CLI 创建名为 webserver-ca 和 webclient-ca 的新子 CA。
先决条件
- 确保您已获取管理员的凭据。
- 确保您已登录到 CA 服务器的 IdM 服务器。
流程
输入
ipa ca-add
命令,再指定 webserver-ca 子 CA 的名称及其 Subject Distinguished Name(DN):[root@ipaserver ~]#
ipa ca-add webserver-ca --subject="CN=WEBSERVER,O=IDM.EXAMPLE.COM"
------------------- Created CA "webserver-ca" ------------------- Name: webserver-ca Authority ID: ba83f324-5e50-4114-b109-acca05d6f1dc Subject DN: CN=WEBSERVER,O=IDM.EXAMPLE.COM Issuer DN: CN=Certificate Authority,O=IDM.EXAMPLE.COM- 名称
- CA 的名称。
- 授权 ID
- 自动创建 CA 独立 ID。
- 主题 DN
- 主题区分名称(DN)。主题 DN 在 IdM CA 基础架构中必须是唯一的。
- 签发者 DN
- 签发子 CA 证书的父 CA。所有子 CA 都是作为 IdM root CA 的子 CA 创建的。
创建 webclient-ca 子 CA 以向 Web 客户端发布证书:
[root@ipaserver ~]#
ipa ca-add webclient-ca --subject="CN=WEBCLIENT,O=IDM.EXAMPLE.COM"
------------------- Created CA "webclient-ca" ------------------- Name: webclient-ca Authority ID: 8a479f3a-0454-4a4d-8ade-fd3b5a54ab2e Subject DN: CN=WEBCLIENT,O=IDM.EXAMPLE.COM Issuer DN: CN=Certificate Authority,O=IDM.EXAMPLE.COM运行 ipa-certupdate 命令,为 webserver-ca 和 webclient-ca 子 CAs 证书创建 certmonger 跟踪请求:
[root@ipaserver ~]#
ipa-certupdate
重要如果您在创建子 CA 和子 CA 证书过期后忘记运行 ipa-certupdate 命令,则该子 CA 发布的证书终止也被视为无效。
验证
验证新子 CA 的签名证书是否已添加到 IdM 数据库中:
[root@ipaserver ~]# certutil -d /etc/pki/pki-tomcat/alias/ -L Certificate Nickname Trust Attributes SSL,S/MIME,JAR/XPI caSigningCert cert-pki-ca CTu,Cu,Cu Server-Cert cert-pki-ca u,u,u auditSigningCert cert-pki-ca u,u,Pu caSigningCert cert-pki-ca ba83f324-5e50-4114-b109-acca05d6f1dc u,u,u ocspSigningCert cert-pki-ca u,u,u subsystemCert cert-pki-ca u,u,u
注意新子 CA 证书自动传输到安装有证书系统实例的所有副本。
20.1.4. 通过 IdM CLI 禁用子 CA
按照以下流程,从 IdM CLI 禁用子 CA。如果子 CA 发布的证书仍没有过期,则不应删除它,但您可以禁用它。如果您删除子 CA,撤销对该子 CA 的调用检查将不再工作。
先决条件
- 确保您已获取管理员的凭据。
流程
运行
ipa ca-find
命令以确定您要删除的子 CA 的名称:[root@ipaserver ~]# ipa ca-find ------------- 3 CAs matched ------------- Name: ipa Description: IPA CA Authority ID: 5195deaf-3b61-4aab-b608-317aff38497c Subject DN: CN=Certificate Authority,O=IPA.TEST Issuer DN: CN=Certificate Authority,O=IPA.TEST Name: webclient-ca Authority ID: 605a472c-9c6e-425e-b959-f1955209b092 Subject DN: CN=WEBCLIENT,O=IDM.EXAMPLE.COM Issuer DN: CN=Certificate Authority,O=IPA.TEST Name: webserver-ca Authority ID: 02d537f9-c178-4433-98ea-53aa92126fc3 Subject DN: CN=WEBSERVER,O=IDM.EXAMPLE.COM Issuer DN: CN=Certificate Authority,O=IPA.TEST ---------------------------- Number of entries returned 3 ----------------------------
运行
ipa ca-disable
命令以禁用您的子 CA,在这个示例中是webserver-ca
:ipa ca-disable webserver-ca -------------------------- Disabled CA "webserver-ca" --------------------------
20.1.5. 通过 IdM CLI 删除子 CA
按照以下流程,从 IdM CLI 删除轻量级子 CA。
-
如果您删除子 CA,撤销对该子 CA 的调用检查将不再工作。只有当没有其
notAfter
过期时间是将来的子 CA 发布的证书时,才删除子 CA。 - 当仍存在由该子 CA 发布的证书时,您应该只禁用子 CA。如果子 CA 发布的所有证书都已过期,您可以删除该子 CA。
- 您无法禁用或删除 IdM CA。
先决条件
- 确保您已获取管理员的凭据。
流程
要显示 sub-CA 和 CA 列表,请运行
ipa ca-find
命令:# ipa ca-find ------------- 3 CAs matched ------------- Name: ipa Description: IPA CA Authority ID: 5195deaf-3b61-4aab-b608-317aff38497c Subject DN: CN=Certificate Authority,O=IPA.TEST Issuer DN: CN=Certificate Authority,O=IPA.TEST Name: webclient-ca Authority ID: 605a472c-9c6e-425e-b959-f1955209b092 Subject DN: CN=WEBCLIENT,O=IDM.EXAMPLE.COM Issuer DN: CN=Certificate Authority,O=IPA.TEST Name: webserver-ca Authority ID: 02d537f9-c178-4433-98ea-53aa92126fc3 Subject DN: CN=WEBSERVER,O=IDM.EXAMPLE.COM Issuer DN: CN=Certificate Authority,O=IPA.TEST ---------------------------- Number of entries returned 3 ----------------------------
运行
ipa ca-disable
命令以禁用您的子 CA,在这个示例中是webserver-ca
:# ipa ca-disable webserver-ca -------------------------- Disabled CA "webserver-ca" --------------------------
删除子 CA,本例中为
webserver-ca
:# ipa ca-del webserver-ca ------------------------- Deleted CA "webserver-ca" -------------------------
验证
运行
ipa ca-find
以显示 CAs 和 sub-CAs 列表。webserver-ca
不再位于列表中。# ipa ca-find ------------- 2 CAs matched ------------- Name: ipa Description: IPA CA Authority ID: 5195deaf-3b61-4aab-b608-317aff38497c Subject DN: CN=Certificate Authority,O=IPA.TEST Issuer DN: CN=Certificate Authority,O=IPA.TEST Name: webclient-ca Authority ID: 605a472c-9c6e-425e-b959-f1955209b092 Subject DN: CN=WEBCLIENT,O=IDM.EXAMPLE.COM Issuer DN: CN=Certificate Authority,O=IPA.TEST ---------------------------- Number of entries returned 2 ----------------------------
20.2. 从 IdM WebUI 下载子 CA 证书
先决条件
- 确保您已获取 IdM 管理员的凭据。
流程
在 Authentication 菜单中点击 Certificates > Certificates。
图 20.2. 证书列表中的子 CA 证书
- 单击子 CA 证书的序列号,以打开证书信息页面。
- 在证书信息页面中,点击 Actions > Download。
在 CLI 中,将子 CA 证书移到
/etc/pki/tls/private/
目录中:# mv path/to/the/downloaded/certificate /etc/pki/tls/private/sub-ca.crt
20.3. 为 Web 服务器和客户端身份验证创建 CA ACL
证书颁发机构访问控制列表(CA ACL)规则定义哪些配置文件可用于向哪些用户、服务或主机发布证书。通过关联配置文件、主体和组,CA ACL 允许主体或组使用特定配置集请求证书。
例如,利用 CA ACL,管理员可以将适用于从伦敦办事处工作的员工的配置文件的使用限制为属于伦敦办事处相关组的成员的用户。
20.3.1. 在 IdM CLI 中查看 CA ACL
按照以下流程查看 IdM 部署中提供的证书颁发机构访问控制列表(CA ACL)以及特定 CA ACL 的详情。
流程
要查看 IdM 环境中的所有 CA ACL,请输入
ipa caacl-find
命令:$ ipa caacl-find ----------------- 1 CA ACL matched ----------------- ACL name: hosts_services_caIPAserviceCert Enabled: TRUE
要查看 CA ACL 的详细信息,请输入
ipa caacl-show
命令并指定 CA ACL 名称。例如,要查看 hosts_services_caIPAserviceCert CA ACL 的详情,请输入:$ ipa caacl-show hosts_services_caIPAserviceCert ACL name: hosts_services_caIPAserviceCert Enabled: TRUE Host category: all Service category: all CAs: ipa Profiles: caIPAserviceCert Users: admin
20.3.2. 使用 webserver-ca 发布的证书,为认证 Web 客户端的 Web 服务器创建 CA ACL
按照以下流程,在为 HTTP/my_company.idm.example.com@IDM.EXAMPLE.COM 服务请求证书时,创建需要系统管理员使用 webserver-ca 子 CA 和 caIPAserviceCert 配置文件的 CA ACL。如果用户从其他子 CA 或不同配置集请求证书,则请求会失败。唯一的例外是在启用了另一个匹配的 CA ACL 时。要查看可用的 CA ACL,请参阅在 IdM CLI 中查看 CA ACL。
先决条件
- 确保 HTTP/my_company.idm.example.com@IDM.EXAMPLE.COM 服务是 IdM 的一部分。
- 确保您已获取 IdM 管理员的凭据。
流程
使用
ipa caacl
命令创建 CA ACL,并指定其名称:$ ipa caacl-add TLS_web_server_authentication -------------------------------------------- Added CA ACL "TLS_web_server_authentication" -------------------------------------------- ACL name: TLS_web_server_authentication Enabled: TRUE
使用
ipa caacl-mod 命令修改
CA ACL 以指定 CA ACL 的说明:$ ipa caacl-mod TLS_web_server_authentication --desc="CAACL for web servers authenticating to web clients using certificates issued by webserver-ca" ----------------------------------------------- Modified CA ACL "TLS_web_server_authentication" ----------------------------------------------- ACL name: TLS_web_server_authentication Description: CAACL for web servers authenticating to web clients using certificates issued by webserver-ca Enabled: TRUE
将 webserver-ca 子 CA 添加到 CA ACL 中:
$ ipa caacl-add-ca TLS_web_server_authentication --ca=webserver-ca ACL name: TLS_web_server_authentication Description: CAACL for web servers authenticating to web clients using certificates issued by webserver-ca Enabled: TRUE CAs: webserver-ca ------------------------- Number of members added 1 -------------------------
使用
ipa caacl-add-service
指定主体可以请求证书的服务:$ ipa caacl-add-service TLS_web_server_authentication --service=HTTP/my_company.idm.example.com@IDM.EXAMPLE.COM ACL name: TLS_web_server_authentication Description: CAACL for web servers authenticating to web clients using certificates issued by webserver-ca Enabled: TRUE CAs: webserver-ca Services: HTTP/my_company.idm.example.com@IDM.EXAMPLE.COM ------------------------- Number of members added 1 -------------------------
使用
ipa caacl-add-profile
命令为请求的证书指定证书配置集:$ ipa caacl-add-profile TLS_web_server_authentication --certprofiles=caIPAserviceCert ACL name: TLS_web_server_authentication Description: CAACL for web servers authenticating to web clients using certificates issued by webserver-ca Enabled: TRUE CAs: webserver-ca Profiles: caIPAserviceCert Services: HTTP/my_company.idm.example.com@IDM.EXAMPLE.COM ------------------------- Number of members added 1 -------------------------
您可以直接使用新创建的 CA ACL。它在创建后默认启用。
CA ACL 的重点是指定允许哪些 CA 和配置文件组合用于来自特定主体或组的请求。CA ACL 不会影响证书验证或信任。它们不会影响签发的证书的使用方式。
20.3.3. 为用户 Web 浏览器创建 CA ACL,使用 webclient-ca 发布的证书向 Web 服务器进行身份验证
按照以下流程,创建在请求证书时需要系统管理员使用 webclient-ca 子 CA 和 IECUserRoles 配置文件的 CA ACL。如果用户从其他子 CA 或不同配置集请求证书,则请求会失败。唯一的例外是在启用了另一个匹配的 CA ACL 时。要查看可用的 CA ACL,请参阅在 IdM CLI 中查看 CA ACL。
先决条件
- 确保您已获取 IdM 管理员的凭据。
流程
使用
ipa caacl
命令创建 CA ACL 并指定其名称:$ ipa caacl-add TLS_web_client_authentication -------------------------------------------- Added CA ACL "TLS_web_client_authentication" -------------------------------------------- ACL name: TLS_web_client_authentication Enabled: TRUE
使用
ipa caacl-mod 命令修改
CA ACL 以指定 CA ACL 的说明:$ ipa caacl-mod TLS_web_client_authentication --desc="CAACL for user web browsers authenticating to web servers using certificates issued by webclient-ca" ----------------------------------------------- Modified CA ACL "TLS_web_client_authentication" ----------------------------------------------- ACL name: TLS_web_client_authentication Description: CAACL for user web browsers authenticating to web servers using certificates issued by webclient-ca Enabled: TRUE
将 webclient-ca 子 CA 添加到 CA ACL 中:
$ ipa caacl-add-ca TLS_web_client_authentication --ca=webclient-ca ACL name: TLS_web_client_authentication Description: CAACL for user web browsers authenticating to web servers using certificates issued by webclient-ca Enabled: TRUE CAs: webclient-ca ------------------------- Number of members added 1 -------------------------
使用
ipa caacl-add-profile
命令为请求的证书指定证书配置集:$ ipa caacl-add-profile TLS_web_client_authentication --certprofiles=IECUserRoles ACL name: TLS_web_client_authentication Description: CAACL for user web browsers authenticating to web servers using certificates issued by webclient-ca Enabled: TRUE CAs: webclient-ca Profiles: IECUserRoles ------------------------- Number of members added 1 -------------------------
使用
ipa caacl-mod 命令修改
CA ACL,以指定 CA ACL 适用于所有 IdM 用户:$ ipa caacl-mod TLS_web_client_authentication --usercat=all ----------------------------------------------- Modified CA ACL "TLS_web_client_authentication" ----------------------------------------------- ACL name: TLS_web_client_authentication Description: CAACL for user web browsers authenticating to web servers using certificates issued by webclient-ca Enabled: TRUE User category: all CAs: webclient-ca Profiles: IECUserRoles
您可以直接使用新创建的 CA ACL。它在创建后默认启用。
CA ACL 的重点是指定允许哪些 CA 和配置文件组合用于来自特定主体或组的请求。CA ACL 不会影响证书验证或信任。它们不会影响签发的证书的使用方式。
20.4. 使用 certmonger 为服务获取 IdM 证书
为确保浏览器和在 IdM 客户端上运行的 Web 服务之间的通信安全且加密,请使用 TLS 证书。如果要将 Web 浏览器限制为信任 webserver-ca
子 CA 发布但没有其它 IdM 子 CA 发布的证书,请从 webserver-ca
子 CA 获取 Web 服务的 TLS 证书。
按照以下流程,使用 certmonger
获取在 IdM 客户端上运行的服务(HTTP/my_company.idm.example.com
@IDM.EXAMPLE.COM
)的 IdM 证书。
使用 证书监控
器自动请求证书意味着,certmonger
在到期需要续订时管理和续订证书。
有关 certmonger
请求服务证书时发生的可视化表示,请参阅 certmonger 请求服务证书的通信流。
先决条件
- Web 服务器已注册为 IdM 客户端。
- 您有正在运行的 IdM 客户端的 root 访问权限。
- 请求证书的服务不必在 IdM 中预先存在。
流程
在运行
HTTP
服务的 my_company.idm.example.com
IdM 客户端中,请求与HTTP/my_company.idm.example.com@IDM.EXAMPLE.COM
主体对应的服务的证书,并指定:-
证书将存储在本地
/etc/pki/tls/certs/httpd.pem
文件中 -
私钥存储在本地
/etc/pki/tls/private/httpd.key
文件中 -
The
webserver-ca
子 CA 将作为发行证书颁发机构 将
SubjectAltName
的 extensionRequest 添加到签名请求中,其 DNS 名称为my_company.idm.example.com
:# ipa-getcert request -K HTTP/my_company.idm.example.com -k /etc/pki/tls/private/httpd.key -f /etc/pki/tls/certs/httpd.pem -g 2048 -D my_company.idm.example.com -X webserver-ca -C "systemctl restart httpd" New signing request "20190604065735" added.
在以上命令中:
-
ipa-getcert request
命令指定要从 IdM CA 获取证书。ipa-getcert request
命令是getcert request -c IPA
的快捷方式。 -
g
选项指定要生成的密钥的大小(如果尚未到位)。 -
D
选项指定
要添加到请求的SubjectAltName
DNS 值。 -
X 选项指定
证书的签发者必须是webserver-ca,
而不是ipa
。 -
C
选项
指示certmonger 在获取证书后重新启动
httpd
服务。
-
要指定证书与特定的配置集一起发布,请使用
-T
选项。
注意RHEL 8 在 Apache 中使用与 RHEL 7 中使用的不同的 SSL 模块。SSL 模块依赖于 OpenSSL 而不是 NSS。因此,在 RHEL 8 中,您无法使用 NSS 数据库存储
HTTPS
证书和私钥。-
-
证书将存储在本地
可选:检查请求的状态:
# ipa-getcert list -f /etc/pki/tls/certs/httpd.pem Number of certificates and requests being tracked: 3. Request ID '20190604065735': status: MONITORING stuck: no key pair storage: type=FILE,location='/etc/pki/tls/private/httpd.key' certificate: type=FILE,location='/etc/pki/tls/certs/httpd.crt' CA: IPA issuer: CN=WEBSERVER,O=IDM.EXAMPLE.COM [...]
输出显示请求处于 MONITOR
ING
状态,这表示已获取了证书。密钥对和证书的位置是请求的位置。
20.5. 请求服务证书的证书的通信流
这些图显示了当 certmonger
从身份管理(IdM)证书认证机构(CA)服务器请求服务证书时发生什么情况的阶段。序列由这些图表组成:
在图中,webserver-ca
子 CA 由通用 IdM CA 服务器
表示。
未加密通信 显示初始情况:没有 HTTPS 证书,Web 服务器之间的通信和浏览器未加密。
图 20.3. 未加密的通信

请求服务证书的 certmonger 显示系统管理员使用 certmonger
手动为 Apache web 服务器请求 HTTPS 证书。请注意,在请求 Web 服务器证书时,certmonger 不会直接与 CA 通信。它通过 IdM 代理。
图 20.4. Certmonger 请求服务证书

发出服务证书的 IdM CA 显示为 web 服务器发出 HTTPS 证书的 IdM CA。
图 20.5. 发布服务证书的 IdM CA

Certmonger 应用服务证书显示,certmonger
把 HTTPS 证书放置到 IdM 客户端的正确位置,如果指定,会重启 httpd
服务。随后 Apache 服务器使用 HTTPS 证书来加密自身和浏览器之间的流量。
图 20.6. Certmonger 应用服务证书

当旧证书接近过期时,cert monger
会在证书过期前自动从 IdM CA 续订服务证书。IdM CA 发布一个新证书。
图 20.7. 当旧证书即将过期时,Certmonger 请求一个新证书

20.6. 设置单实例 Apache HTTP 服务器
您可以设置单实例 Apache HTTP 服务器来提供静态 HTML 内容。
如果 Web 服务器应该为与服务器关联的所有域提供相同的内容,请按照以下流程操作。如果要为不同的域提供不同的内容,请设置基于名称的虚拟主机。详情请参阅配置基于 Apache 名称的虚拟主机。
流程
安装
httpd
软件包:# yum install httpd
如果使用
firewalld
,请在本地防火墙中打开 TCP 端口80
:# firewall-cmd --permanent --add-port=80/tcp # firewall-cmd --reload
启用并启动
httpd
服务:# systemctl enable --now httpd
可选:将 HTML 文件添加到
/var/www/html/
目录中。注意在
/var/www/html/
中添加内容时,httpd 默认运行httpd
的用户必须可读文件和目录。内容所有者可以是root 用户和 root
用户组
,也可以是管理员选择的其他用户或组。如果内容所有者是root
用户和root
用户组,则文件必须可由其他用户读取。所有文件和目录的 SELinux 上下文必须为httpd_sys_content_t
,默认应用于/var/www
目录中的所有内容。
验证
使用 Web 浏览器连接到
http://my_company.idm.example.com/ 或
http://server_IP/
。如果
/var/www/html/
目录为空,或者不包含index.html
或index.htm
文件,则 Apache 会显示Red Hat Enterprise Linux 测试页
。如果/var/www/html/
包含具有不同名称的 HTML 文件,您可以通过在该文件中输入 URL 来加载这些文件,如http://server_IP/example.html
或http://my_company.idm.example.com/example.html
。
其它资源
- Apache 手册: 安装 Apache HTTP 服务器手册.
-
请参见您系统上的
httpd.service (8)
手册页。
20.7. 在 Apache HTTP 服务器中添加 TLS 加密
您可以在 idm.example.com
域的 my_company.idm.example.com
Apache HTTP 服务器上启用 TLS 加密。
先决条件
-
my_company.idm.example.com
Apache HTTP 服务器已安装并在运行。 -
您已从 webserver-ca 子 CA 获取 TLS 证书,并将其存储在
/etc/pki/tls/certs/httpd.pem
文件中,如 使用 certmonger 为服务获取 IdM 证书 中所述。如果您使用其他路径,请调整该流程的对应步骤。 -
对应的私钥存储在
/etc/pki/tls/private/httpd.key
文件中。如果您使用其他路径,请调整该流程的对应步骤。 -
webserver-ca CA 证书存储在
/etc/pki/tls/private/sub-ca.crt
文件中。如果您使用其他路径,请调整该流程的对应步骤。 - 客户端和 my_company.idm.example.com Web 服务器将服务器的主机名解析为 Web 服务器的 IP 地址。
流程
安装
mod_ssl
软件包:# yum install mod_ssl
编辑
/etc/httpd/conf.d/ssl.conf
文件,并将以下设置添加到<VirtualHost _default_:443>
指令中:设置服务器名称:
ServerName my_company.idm.example.com
重要服务器名称必须与证书的
Common Name 字段中
设置的条目匹配。可选: 如果证书在
Subject Alt Names
(SAN)字段中包含额外主机名,您可以将mod_ssl
配置为为这些主机名提供 TLS 加密。要配置此功能,使用对应的名称添加ServerAliases
参数:ServerAlias www.my_company.idm.example.com server.my_company.idm.example.com
设置到私钥、服务器证书和 CA 证书的路径:
SSLCertificateKeyFile "/etc/pki/tls/private/httpd.key" SSLCertificateFile "/etc/pki/tls/certs/httpd.pem" SSLCACertificateFile "/etc/pki/tls/certs/ca.crt"
出于安全考虑,配置只有
root
用户可以访问私钥文件:# chown root:root /etc/pki/tls/private/httpd.key # chmod 600 //etc/pki/tls/private/httpd.key
警告如果私钥被设置为可以被未授权的用户访问,则需要撤销证书,然后再创建一个新私钥并请求一个新证书。否则,TLS 连接就不再安全。
如果您使用
firewalld
,在本地防火墙中打开端口443
:# firewall-cmd --permanent --add-port=443/tcp # firewall-cmd --reload
重启
httpd
服务:# systemctl restart httpd
注意如果您使用密码保护私钥文件,则必须在每次
httpd
服务启动时输入此密码。-
使用浏览器并连接到
https://my_company.idm.example.com
-
使用浏览器并连接到
20.8. 在 Apache HTTP 服务器中设置支持的 TLS 协议版本
默认情况下,RHEL 上的 Apache HTTP 服务器使用系统范围的加密策略来定义安全默认值,它们也与最近浏览器兼容。例如,DEFAULT
策略定义 TLSv1.2
和 TLSv1.3
协议版本仅在 apache 中启用。
您可以手动配置 my_company.idm.example.com Apache HTTP 服务器支持哪些 TLS 协议版本。如果您的环境只需要启用特定的 TLS 协议版本,请按照以下步骤操作,例如:
-
如果您的环境要求客户端也可以使用弱
TLS1
(TLSv1.0)或TLS1.1
协议。 -
如果要配置 Apache 仅支持
TLSv1.2 或
TLSv1.3
协议。
先决条件
- TLS 加密在 my_company.idm.example.com 服务器上启用,如 将 TLS 加密添加到 Apache HTTP 服务器 中所述。
流程
编辑
/etc/httpd/conf/httpd.conf
文件,并将以下设置添加到您要为其设置 TLS 协议版本的<VirtualHost> 指令中
。例如,只启用TLSv1.3
协议:SSLProtocol -All TLSv1.3
重启
httpd
服务:# systemctl restart httpd
验证
使用以下命令来验证服务器是否支持
TLSv1.3
:# openssl s_client -connect example.com:443 -tls1_3
使用以下命令验证服务器不支持
TLSv1.2
:# openssl s_client -connect example.com:443 -tls1_2
如果服务器不支持该协议,命令会返回一个错误:
140111600609088:error:1409442E:SSL routines:ssl3_read_bytes:tlsv1 alert protocol version:ssl/record/rec_layer_s3.c:1543:SSL alert number 70
- 可选:重复用于其他 TLS 协议版本的命令。
其它资源
-
您系统上的
update-crypto-policies (8)
手册页 - 使用系统范围的加密策略。
-
有关
SSLProtocol
参数的详情,请参考 Apache 手册中的mod_ssl
文档: 安装 Apache HTTP 服务器手册。
20.9. 在 Apache HTTP 服务器中设置支持的密码
默认情况下,Apache HTTP 服务器使用系统范围的加密策略来定义安全默认值,它们也与最近浏览器兼容。有关系统范围加密允许的密码列表,请查看 /etc/crypto-policies/back-ends/openssl.config
文件。
您可以手动配置 my_company.idm.example.com Apache HTTP 服务器支持哪些密码。如果您的环境需要特定的加密系统,请按照以下步骤操作。
先决条件
- TLS 加密在 my_company.idm.example.com 服务器上启用,如 将 TLS 加密添加到 Apache HTTP 服务器 中所述。
流程
编辑
/etc/httpd/conf/httpd.conf
文件,并将SSLCipherSuite
参数添加到您要为其设置 TLS 密码的<VirtualHost> 指令中
:SSLCipherSuite "EECDH+AESGCM:EDH+AESGCM:AES256+EECDH:AES256+EDH:!SHA1:!SHA256"
这个示例只启用
EECDH+AESGCM
、EDH+AESGCM
、AES256+EECDH
和AES256+EDH
密码,并禁用使用SHA1 和 SHA
256
消息身份验证代码(MAC)的所有密码。重启
httpd
服务:# systemctl restart httpd
验证
显示 Apache HTTP 服务器支持的密码列表:
安装
nmap
软件包:# yum install nmap
使用
nmap
工具显示支持的加密:# nmap --script ssl-enum-ciphers -p 443 example.com ... PORT STATE SERVICE 443/tcp open https | ssl-enum-ciphers: | TLSv1.2: | ciphers: | TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (ecdh_x25519) - A | TLS_DHE_RSA_WITH_AES_256_GCM_SHA384 (dh 2048) - A | TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256 (ecdh_x25519) - A ...
其它资源
-
您系统上的
update-crypto-policies (8)
手册页 - 使用系统范围的加密策略。
- 安装 Apache HTTP 服务器手册 - SSLCipherSuite
20.10. 配置 TLS 客户端证书身份验证
客户端证书身份验证仅允许使用证书进行身份验证的用户访问 my_company.idm.example.com Web 服务器上的资源。您可以为 /var/www/html/Example/
目录配置客户端证书身份验证。
如果 my_company.idm.example.com Apache 服务器使用 TLS 1.3 协议,则某些客户端需要额外的配置。例如,在 Firefox 中,将 about:config
菜单中的 security.tls.enable_post_handshake_auth
参数设置为 true
。详情请查看 Red Hat Enterprise Linux 8 中的传输层安全版本 1.3。
先决条件
- TLS 加密在 my_company.idm.example.com 服务器上启用,如 将 TLS 加密添加到 Apache HTTP 服务器 中所述。
流程
编辑
/etc/httpd/conf/httpd.conf
文件,并将以下设置添加到要为其配置客户端验证的<VirtualHost> 指令中
:<Directory "/var/www/html/Example/"> SSLVerifyClient require </Directory>
SSLVerifyClient require
设置定义服务器必须成功验证客户端证书,然后客户端才能访问/var/www/html/Example/
目录中的内容。重启
httpd
服务:# systemctl restart httpd
验证
使用
curl
工具在没有客户端身份验证的情况下访问https://my_company.idm.example.com/Example/
URL:$ curl https://my_company.idm.example.com/Example/ curl: (56) OpenSSL SSL_read: error:1409445C:SSL routines:ssl3_read_bytes:tlsv13 alert certificate required, errno 0
此错误表示 my_company.idm.example.com Web 服务器需要客户端证书身份验证。
将客户端私钥和证书以及 CA 证书传递给
curl
以访问与客户端身份验证相同的 URL:$ curl --cacert ca.crt --key client.key --cert client.crt https://my_company.idm.example.com/Example/
如果请求成功,c
url
会显示存储在/var/www/html/Example/
目录中的index.html 文件
。
20.11. 请求新的用户证书并将其导出到客户端
作为身份管理(IdM)管理员,您可以配置在 IdM 客户端上运行的 Web 服务器,以请求使用 Web 浏览器访问服务器的用户对特定 IdM 子 CA 发布的证书进行身份验证。按照以下流程,从特定的 IdM 子 CA 请求用户证书,并将证书和对应的私钥导出到用户希望使用 Web 浏览器访问 Web 服务器的主机上。之后 ,将证书和私钥导入到浏览器中。
流程
可选:创建一个新目录,如
~/certdb/
,并使其成为临时证书数据库。当系统提示时,创建一个 NSS 证书数据库密码来加密后续步骤中生成的证书的密钥:# mkdir
~/certdb/
# certutil -N -d~/certdb/
Enter a password which will be used to encrypt your keys. The password should be at least 8 characters long, and should contain at least one non-alphabetic character. Enter new password: Re-enter password:创建证书签名请求(CSR),并将输出重定向到文件。例如,要为
IDM.EXAMPLE.COM
领域中的idm_user
用户创建一个4096
位、名称为certificate_request.csr
的 CSR,请将证书私钥的昵称设为idm_user
以便于查找,并将主题设为CN=idm_user,O=IDM.EXAMPLE.COM
:# certutil -R -d
~/certdb/
-a -g4096
-nidm_user
-s "CN=idm_user
,O=IDM.EXAMPLE.COM" >certificate_request.csr
出现提示时,输入您在使用
certutil
创建临时数据库时输入的相同密码。然后继续键入 rundlomly 直到通知停止:Enter Password or Pin for "NSS Certificate DB": A random seed must be generated that will be used in the creation of your key. One of the easiest ways to create a random seed is to use the timing of keystrokes on a keyboard. To begin, type keys on the keyboard until this progress meter is full. DO NOT USE THE AUTOREPEAT FUNCTION ON YOUR KEYBOARD! Continue typing until the progress meter is full:
将证书请求文件提交到服务器。指定要与新发布的证书关联的 Kerberos 主体、存储证书的输出文件,以及可选的证书配置集。指定您要签发证书的 IdM 子 CA。例如,要获取
IECUserRoles
配置集的证书,带有添加的用户角色扩展的配置文件,idm_user
@IDM.EXAMPLE.COM
主体来自webclient-ca
,并将证书保存到~/idm_user.pem
文件中:# ipa cert-request
certificate_request.csr
--principal=idm_user
@IDM.EXAMPLE.COM
--profile-id=IECUserRoles
--ca=webclient-ca
--certificate-out=~/idm_user.pem
将证书添加到 NSS 数据库。使用
-n
选项设置之前创建 CSR 时所用的相同 nickname,以便该证书与 NSS 数据库中的私钥相匹配。t
选项设置信任级别。详情请查看 certutil(1)man page。i 选项指定
输入证书文件。例如,要将存储在~/certdb/
数据库中~/idm_user.pem
文件中的带有idm_user
昵称的证书添加到 NSS 数据库中:# certutil -A -d
~/certdb/
-nidm_user
-t "P,," -i~/idm_user.pem
验证 NSS 数据库中的密钥是否未显示
(或称为)
作为其 nickname。例如,验证存储在~/certdb/ 数据库中
的证书没有被孤立:# certutil -K -d
~/certdb/
< 0> rsa 5ad14d41463b87a095b1896cf0068ccc467df395 NSS Certificate DB:idm_user使用
pk12util
命令将证书从 NSS 数据库导出到 PKCS12 格式。例如,将/root/certdb
NSS 数据库中的idm_user
nickname 的证书导出到~/idm_user.p12
文件:# pk12util -d
~/certdb
-o~/idm_user.p12
-nidm_user
Enter Password or Pin for "NSS Certificate DB": Enter password for PKCS12 file: Re-enter password: pk12util: PKCS12 EXPORT SUCCESSFUL将证书传输到您要启用
idm_user
的证书身份验证的主机:# scp
~/idm_user.p12
idm_user@client.idm.example.com:/home/idm_user/
在传输了证书的主机上,出于安全原因使 'pkcs12 文件被 'other' 组无法访问的目录:
# chmod o-rwx
/home/idm_user/
出于安全考虑,请从服务器中删除临时 NSS 数据库和 .pkcs12 文件:
# rm
~/certdb/
# rm~/idm_user.p12
20.12. 配置浏览器以启用证书身份验证
若要在使用 Web UI 登录身份管理(IdM)时通过证书进行身份验证,您需要将用户和相关证书颁发机构(CA)证书导入到 Mozilla Firefox 或 Google Chrome 浏览器。浏览器运行的主机本身不必是 IdM 域的一部分。
IdM 支持以下浏览器来连接到 WebUI:
- Mozilla Firefox 38 及更新的版本
- Google Chrome 46 及更新的版本
以下流程演示了如何配置 Mozilla Firefox 57.0.1 浏览器。
先决条件
- 您可以使用 PKCS#12 格式在浏览器中导入 用户证书。
- 您已 下载了子 CA 证书,并以 PEM 格式进行了处理。
流程
打开 Firefox,然后导航到
Preferences
→Privacy & Security
。图 20.8. Preferences 中的隐私和安全部分
单击
。图 20.9. 查看隐私和安全性中的证书
-
在您的
证书
选项卡中,单击 。以 PKCS12 格式查找并打开用户证书,然后点 和 。 要确保您的 IdM 子 CA 被 Firefox 识别为可信颁发机构,请导入在从 IdM WebUI 下载子 CA证书部分中保存的 IdM 子 CA 证书作为可信证书颁发机构证书:
打开 Firefox,导航到 Preferences 并点击
。图 20.10. Preferences 中的隐私和安全部分
单击
。图 20.11. 查看隐私和安全性中的证书
-
在"
颁发机构
"选项卡中,单击 。查找并打开子 CA 证书。信任证书来识别网站,然后点 和 。
第 22 章 使用 Ansible 管理 IdM 证书
您可以使用 ansible-freeipa
ipacert
模块为身份管理(IdM)用户、主机和服务请求、撤销和检索 SSL 证书。您还可以恢复已搁置的证书。
22.1. 使用 Ansible 为 IdM 主机、服务和用户请求 SSL 证书
您可以使用 ansible-freeipa
ipacert
模块为身份管理(IdM)用户、主机和服务请求 SSL 证书。然后,他们可以使用这些证书向 IdM 进行身份验证。
完成此流程,使用 Ansible playbook ,从 IdM 证书颁发机构(CA)为 HTTP 服务器请求证书。
先决条件
在控制节点上:
- 您使用 Ansible 版本 2.13 或更高版本。
-
您已安装
ansible-freeipa
软件包。 - 您已在 ~/MyPlaybooks/ 目录中创建了一个带有 IdM 服务器的完全限定域名(FQDN)的 Ansible 清单文件。
-
您已将
ipaadmin_password
存储在 secret.yml Ansible vault 中。
- 您的 IdM 部署有一个集成的 CA。
流程
为您的用户、主机或服务生成一个证书签名请求(CSR)。例如,要使用
openssl
工具为运行在 client.idm.example.com 上的HTTP
服务生成一个 CSR,请输入:# openssl req -new -newkey rsa:2048 -days 365 -nodes -keyout new.key -out new.csr -subj '/CN=client.idm.example.com,O=IDM.EXAMPLE.COM'
因此,CSR 存储在 new.csr 中。
使用以下内容创建 Ansible playbook 文件 request-certificate.yml :
--- - name: Playbook to request a certificate hosts: ipaserver vars_files: - /home/user_name/MyPlaybooks/secret.yml tasks: - name: Request a certificate for a web server ipacert: ipaadmin_password: "{{ ipaadmin_password }}" state: requested csr: | -----BEGIN CERTIFICATE REQUEST----- MIGYMEwCAQAwGTEXMBUGA1UEAwwOZnJlZWlwYSBydWxlcyEwKjAFBgMrZXADIQBs HlqIr4b/XNK+K8QLJKIzfvuNK0buBhLz3LAzY7QDEqAAMAUGAytlcANBAF4oSCbA 5aIPukCidnZJdr491G4LBE+URecYXsPknwYb+V+ONnf5ycZHyaFv+jkUBFGFeDgU SYaXm/gF8cDYjQI= -----END CERTIFICATE REQUEST----- principal: HTTP/client.idm.example.com register: cert
将证书请求替换为 new.csr 中的 CSR。
请求证书:
$ ansible-playbook --vault-password-file=password_file -v -i <path_to_inventory_directory>/hosts <path_to_playbooks_directory>/request-certificate.yml
22.2. 使用 Ansible 为 IdM 主机、服务和用户撤销 SSL 证书
您可以使用 ansible-freeipa
ipacert
模块撤销身份管理(IdM)用户、主机和服务用来向 IdM 进行身份验证的 SSL 证书。
完成此流程,使用 Ansible playbook 为 HTTP 服务器撤销证书。吊销证书的原因是 "keyCompromise"。
先决条件
在控制节点上:
- 您使用 Ansible 版本 2.13 或更高版本。
-
您已安装
ansible-freeipa
软件包。 - 您已在 ~/MyPlaybooks/ 目录中创建了一个带有 IdM 服务器的完全限定域名(FQDN)的 Ansible 清单文件。
-
您已将
ipaadmin_password
存储在 secret.yml Ansible vault 中。 -
您已获得证书的序列号,例如通过输入
openssl x509 -noout -text -in <path_to_certificate>
命令。在本例中,证书的序列号为 123456789。
- 您的 IdM 部署有一个集成的 CA。
流程
使用以下内容创建 Ansible playbook 文件 revoke-certificate.yml :
--- - name: Playbook to revoke a certificate hosts: ipaserver vars_files: - /home/user_name/MyPlaybooks/secret.yml tasks: - name: Revoke a certificate for a web server ipacert: ipaadmin_password: "{{ ipaadmin_password }}" serial_number: 123456789 revocation_reason: "keyCompromise" state: revoked
吊销证书:
$ ansible-playbook --vault-password-file=password_file -v -i <path_to_inventory_directory>/hosts <path_to_playbooks_directory>/revoke-certificate.yml
其它资源
-
ansible-freeipa
上游 docs 中的 cert 模块 - RFC 5280 中的 原因代码
22.3. 使用 Ansible 为 IdM 用户、主机和服务恢复 SSL 证书
您可以使用 ansible-freeipa
ipacert
模块恢复之前撤销的由身份管理(IdM)用户、主机或服务用来向 IdM 进行身份验证的 SSL 证书。
您只能恢复搁置的证书。您可能已将其搁置,例如,您不确定私钥是否已丢失。但是,您现在已恢复了密钥,因为您确定此时没有人访问它,您希望重新恢复证书。
完成此流程,以使用 Ansible playbook 为注册到 IdM 中处于搁置状态的服务发布证书。这个示例描述了如何为处于搁置状态的 HTTP 服务发布证书。
先决条件
在控制节点上:
- 您使用 Ansible 版本 2.13 或更高版本。
-
您已安装
ansible-freeipa
软件包。 - 您已在 ~/MyPlaybooks/ 目录中创建了一个带有 IdM 服务器的完全限定域名(FQDN)的 Ansible 清单文件。
-
您已将
ipaadmin_password
存储在 secret.yml Ansible vault 中。
- 您的 IdM 部署有一个集成的 CA。
-
您已获得证书的序列号,例如,通过输入
openssl x509 -noout -text -in path/to/certificate
命令。在本例中,证书序列号为 123456789。
流程
使用以下内容创建 Ansible playbook 文件 restore-certificate.yml :
--- - name: Playbook to restore a certificate hosts: ipaserver vars_files: - /home/user_name/MyPlaybooks/secret.yml tasks: - name: Restore a certificate for a web service ipacert: ipaadmin_password: "{{ ipaadmin_password }}" serial_number: 123456789 state: released
运行 playbook:
$ ansible-playbook --vault-password-file=password_file -v -i <path_to_inventory_directory>/hosts <path_to_playbooks_directory>/restore-certificate.yml
22.4. 使用 Ansible 为 IdM 用户、主机和服务检索 SSL 证书
您可以使用 ansible-freeipa
ipacert
模块来检索为身份管理(IdM)用户、主机或服务发布的 SSL 证书,并将其存储在受管节点上的一个文件中。
先决条件
在控制节点上:
- 您使用 Ansible 版本 2.13 或更高版本。
-
您已安装
ansible-freeipa
软件包。 - 您已在 ~/MyPlaybooks/ 目录中创建了一个带有 IdM 服务器的完全限定域名(FQDN)的 Ansible 清单文件。
-
您已将
ipaadmin_password
存储在 secret.yml Ansible vault 中。
-
您已获得证书的序列号,例如通过输入
openssl x509 -noout -text -in <path_to_certificate>
命令。在本例中,证书的序列号为 123456789,存储检索到的证书的文件是 cert.pem。
流程
使用以下内容创建 Ansible playbook 文件 retrieve-certificate.yml :
--- - name: Playbook to retrieve a certificate and store it locally on the managed node hosts: ipaserver vars_files: - /home/user_name/MyPlaybooks/secret.yml tasks: - name: Retrieve a certificate and save it to file 'cert.pem' ipacert: ipaadmin_password: "{{ ipaadmin_password }}" serial_number: 123456789 certificate_out: cert.pem state: retrieved
检索证书:
$ ansible-playbook --vault-password-file=password_file -v -i <path_to_inventory_directory>/hosts <path_to_playbooks_directory>/retrieve-certificate.yml
第 23 章 使用 IdM Healthcheck 验证证书
了解更多有关理解和在身份管理(IdM)中使用 Healthcheck 工具的信息,以识别与 certmonger
维护的 IPA 证书相关的问题。
详情请查看 IdM 中的 Healthcheck。
先决条件
- Healthcheck 工具只在 RHEL 8.1 及更新版本中可用。
23.1. IdM 证书健康检查测试
Healthcheck 工具包括多个测试,用于验证 Identity Management(IdM)中由 certmonger 维护的证书状态。有关 certmonger 的详情,请参阅使用 certmonger 为服务获取 IdM 证书。
此测试套件检查过期、验证、信任和其他问题。对于相同的根本问题,可能会抛出多个错误。
要查看所有证书测试,请运行带有 --list-sources
选项的 ipa-healthcheck
:
# ipa-healthcheck --list-sources
您可以在 ipahealthcheck.ipa.certs
源下找到所有测试:
- IPACertmongerExpirationCheck
此测试检查
certmonger 中的过期时间
。如果报告错误,证书已过期。
如果出现警告,证书很快就会过期。默认情况下,此测试在证书过期前 28 天或更短的时间内适用。
您可以在
/etc/ipahealthcheck/ipahealthcheck.conf
文件中配置天数。打开该文件后,更改 default 部分中的cert_expiration_days
选项。注意Certmonger 加载和维护自己的证书过期视图。此检查不会验证磁盘中的证书。
- IPACertfileExpirationCheck
此测试检查证书文件或 NSS 数据库是否无法打开。此测试还会检查过期情况。因此,请仔细阅读错误或警告输出中的
msg
属性。消息指定了问题。注意此测试会检查磁盘中的证书。如果证书丢失、不可读取等单独错误,也可以引发单独的错误。
- IPACertNSSTrust
- 此测试比较存储在 NSS 数据库中的证书的信任。对于 NSS 数据库中的预期跟踪证书,会将信任与预期值进行比较,并在不匹配时引发错误。
- IPANSSChainValidation
-
此测试会验证 NSS 证书的证书链。测试执行:
certutil -V -u V -e -d [dbdir] -n [nickname]
- IPAOpenSSLChainValidation
此测试会验证 OpenSSL 证书的证书链。与
NSSChain
验证相当的 OpenSSL 命令是我们执行的 OpenSSL 命令:openssl verify -verbose -show_chain -CAfile /etc/ipa/ca.crt [cert file]
- IPARAAgent
-
此测试将磁盘上的证书与
uid=ipara,ou=People,o=ipaca
中 LDAP 中的等效记录进行比较。 - IPACertRevocation
- 此测试使用 certmonger 验证证书是否已被撤销。因此,测试只能查找与 certmonger 维护的证书连接的问题。
- IPACertmongerCA
此测试将验证证书授权机构(CA)配置。IdM 无法在没有 CA 的情况下发布证书。
Certmonger 维护一组 CA 帮助程序。在 IdM 中,有一个名为 IPA 的 CA,它通过 IdM 发布证书,它作为主机或用户主体进行身份验证,用于主机或服务证书。
还有一个
dogtag-ipa-ca-renew-agent
和dogtag-ipa-ca-renew-agent-reuse
(续订 CA 子系统证书)
当尝试检查问题时,在所有 IdM 服务器中运行这些测试。
23.2. 使用 Healthcheck 工具验证证书
按照以下流程,使用 Healthcheck 工具对身份管理(IdM)证书健康检查进行独立手动测试。
因此,Healthcheck 工具包括了许多测试,您可以使用以下方法缩短结果:
-
排除所有成功的测试:
--failures-only
-
仅包含证书测试:
--source=ipahealthcheck.ipa.certs
先决条件
-
您必须以
root
用户身份执行 Healthcheck 测试。
流程
要使用证书的警告、错误和严重问题运行健康检查,请输入:
# ipa-healthcheck --source=ipahealthcheck.ipa.certs --failures-only
成功测试会显示空括号:
[]
失败的测试会显示以下输出:
{ "source": "ipahealthcheck.ipa.certs", "check": "IPACertfileExpirationCheck", "result": "ERROR", "kw": { "key": 1234, "dbdir": "/path/to/nssdb", "error": [error], "msg": "Unable to open NSS database '/path/to/nssdb': [error]" } }
在打开 NSS 数据库时,这个 IPACertfileExpirationCheck
测试失败。
其它资源
-
请参阅
man ipa-healthcheck
。
第 24 章 使用 IdM Healthcheck 验证系统证书
了解如何使用 Healthcheck 工具识别与身份管理(IdM)中系统证书相关的问题。
详情请查看 IdM 中的 Healthcheck。
先决条件
- Healthcheck 工具仅在 RHEL 8.1 或更新版本中可用。
24.1. 系统证书健康检查测试
Healthcheck 工具包括一些用于验证系统(DogTag)证书的测试。
要查看所有测试,请运行带有 --list-sources
选项的 ipa-healthcheck
:
# ipa-healthcheck --list-sources
您可以在 ipahealthcheck.dogtag.ca
源下找到所有测试:
- DogtagCertsConfigCheck
此测试将其 NSS 数据库中的 CA(证书授权机构)证书与存储在
CS.cfg
中的相同值进行比较。如果不匹配,CA 无法启动。具体来说,它会检查:
-
auditSigningCert cert-pki-ca
againstca.audit_signing.cert
-
ocspSigningCert cert-pki-ca
againstca.ocsp_signing.cert
-
caSigningCert cert-pki-ca
againstca.signing.cert
-
subsystemCert cert-pki-ca
againstca.subsystem.cert
-
针对
ca.sslserver.cert
的Server-Cert cert-pki-ca
如果安装了 Key Recovery Authority(KRA):
-
transportCert cert-pki-kra
againstca.connector.KRA.transportCert
-
- DogtagCertsConnectivityCheck
此测试验证连接性。这个测试等同于检查的
ipa cert-show 1
命令:- Apache 中的 PKI 代理配置
- IdM 能够找到 CA
- RA 代理客户端证书
- CA 回复请求的正确性
请注意,测试会使用 serial #1 检查证书,因为您要验证是否
可以执行证书
并返回 CA 中的预期结果(证书或未找到)。
当尝试找到问题时,在所有 IdM 服务器中运行这些测试。
24.2. 使用 Healthcheck 强制系统证书
按照以下流程,使用 Healthcheck 工具运行身份管理(IdM)证书的独立手动测试。
由于 Healthcheck 工具包含许多测试,因此您可以通过仅包含 DogTag 测试来缩小结果范围:-- source=ipahealthcheck.dogtag.ca
流程
要运行限制为 DogTag 证书的 Healthcheck,请输入:
# ipa-healthcheck --source=ipahealthcheck.dogtag.ca
测试成功示例:
{ "source: ipahealthcheck.dogtag.ca", "check: DogtagCertsConfigCheck", "result: SUCCESS", "uuid: 9b366200-9ec8-4bd9-bb5e-9a280c803a9c", "when: 20191008135826Z", "duration: 0.252280", "kw:" { "key": "Server-Cert cert-pki-ca", "configfile": "/var/lib/pki/pki-tomcat/conf/ca/CS.cfg" } }
测试失败的示例:
{ "source: ipahealthcheck.dogtag.ca", "check: DogtagCertsConfigCheck", "result: CRITICAL", "uuid: 59d66200-1447-4b3b-be01-89810c803a98", "when: 20191008135912Z", "duration: 0.002022", "kw:" { "exception": "NSDB /etc/pki/pki-tomcat/alias not initialized", } }
其它资源
-
请参阅
man ipa-healthcheck
。
第 25 章 了解 IdM 内部使用的证书
您可以安装带有集成证书颁发机构(CA)或没有 CA 的 Red Hat Identity Management (IdM)服务器。访问和管理 IdM 所需的证书会根据您的 CA 是否是集成的而进行不同的管理:
-
集成的 CA:证书由
certmonger
自动创建和跟踪。certmonger
会自动续订证书,确保 IdM 服务持续有效。 - 没有 CA:从第三方授权请求证书。在这种情况下,您需要监控其过期,并确保它们被续订,以确保 IdM 服务的持续有效。
25.1. 关于 IdM 中的内部证书
Red Hat Enterprise Linux Identity Management (IdM)使用通过网络访问的许多服务,包括 LDAP 服务器和 HTTP 服务器。您可以使用 SSL/TLS 端口访问这些服务,其需要服务器证书。在安装 IdM 服务器的过程中需要 HTTP 和 LDAP 服务器证书。
您可以根据您安装和配置 IdM 的方式以多种方式获取证书:
带有可以由外部 CA 自签名或签名的集成的 CA : IdM 为 IdM 管理的用户、主机和服务发布所有证书,您不需要提供证书文件。
certmonger
自动监控证书的到期日期,并在需要时自动续订。带有外部签名的 CA:安装是一个多个步骤过程。
-
您需要使用
--external-ca
选项运行安装来生成 CSR。 - 将 CSR 提交给外部 CA,并以 PEM 文件或 Base64 编码证书的形式检索发布的证书和 CA 证书链。
再次运行 IdM 服务器安装,指定新发布的 CA 证书和 CA 链文件的位置和名称。您的 IdM 证书颁发机构被配置为外部 CA 的子 CA,这个子 CA 发布所需的 HTTP 和 LDAP 服务器证书。
certmonger
自动监控证书的到期日期,并在需要时自动续订。
-
您需要使用
没有 CA:要求您从第三方认证机构请求以下证书:
- LDAP 服务器证书
- Apache 服务器证书
- PKINIT 证书
发布 LDAP 和 Apache 服务器证书的 CA 完整 CA 证书链
这些证书不会被
certmonger
跟踪,管理员负责在过期日期前续订证书。
其它资源
25.2. IdM 内部的证书
您的内部证书可以取决于您是如何安装 IdM 的,以及该安装中包含了哪些组件。根据该安装,您可能在您的系统上存储了以下证书。
IdM CA 证书
IdM 使用 IdM CA 证书来签名所有其他证书。请注意,它没有出现在 CA-less 安装中。
caSigningCert | 描述 |
---|---|
文件系统位置 |
|
LDAP 位置 |
|
发布者 | 由外部 CA 自签名或签名 |
主题 |
请注意,这是默认值,但可以在 IdM 服务器安装过程中进行自定义。 |
附加信息 |
必须具有 |
外部 CA 证书
如果您使用外部 CA,则 IdM 中必须有外部 CA 链以验证 IdM 证书。对于无 CA 的安装,外部 CA 证书必须存在于不同的位置,包括 LDAP 和 /etc/ipa/ca.crt
目录中,以验证 HTTPD 和 LDAP 证书。
您不必手动将外部 CA 证书添加到所有所需位置,因为在安装过程中会自动完成。但是,如果以后更新外部 CA 证书,您应该遵循 使用外部 CA 续订 IdM CA 续订服务器证书 中的步骤,以确保将新证书添加到需要它的每个位置。
外部证书 | 描述 |
---|---|
文件系统位置 |
|
LDAP 位置 |
|
发布者 | 外部 CA 签名的 |
主题 | 外部 CA 主题 |
附加信息 |
您必须在链中有 DER 格式的所有证书,您必须将它们导入到 LDAP 中。在 NSS 数据库中必须有 |
子系统 CA 证书
此证书用于在写入 LDAP 数据库时向 LDAP 服务器进行身份验证。无 CA 的安装中没有此证书。
subsystemCert | 描述 |
---|---|
文件系统位置 |
|
LDAP 位置 |
|
发布者 | IPA CA |
主题 |
|
附加信息 |
注意 LDAP 中的序列号和 blob 不匹配。例如, |
审计签名证书
此证书用于签名审计日志。请注意,它没有出现在 CA-less 安装中。
auditSigningCert | 描述 |
---|---|
文件系统位置 |
|
LDAP 位置 |
没有专用的 LDAP 位置,通过 |
发布者 | IPA CA |
主题 |
|
附加信息 |
在 NSS 数据库中必须有 |
OCSP 签名证书
此证书用于提供在线证书状态协议(OCSP)服务。请注意,它没有出现在 CA-less 安装中。
ocspSigningCert | 描述 |
---|---|
文件系统位置 |
|
LDAP 位置 |
没有专用的 LDAP 位置,通过 |
发布者 | IPA CA |
主题 |
|
附加信息 |
Tomcat servlet 证书
当客户端联系 PKI 时,使用此证书。请注意,这个服务器证书特定于主机,它不会出现在 CA-less 安装中。
server-Cert | 描述 |
---|---|
文件系统位置 |
|
LDAP 位置 | |
发布者 | IPA CA |
主题 | CN=$HOSTNAME,O=REALM.NAME |
附加信息 |
注册颁发机构证书
certmonger
以及 IdM 框架用来认证到 PKI 的证书。例如,如果您运行 ipa cert-show 1
,则 HTTPD 与 PKI 进行通信,并使用此证书进行身份验证。在 CA-less 安装中不存在。
RA 代理 | 描述 |
---|---|
文件系统位置 |
|
LDAP 位置 |
|
发布者 | IPA CA |
主题 |
|
附加信息 |
注意 LDAP 中的序列号和 blob 不匹配。例如, |
HTTPD 前端证书
用于 HTTPD 前端的证书,以保护到 Web UI 和 API 的连接。必须存在。
HTTPD | 描述 |
---|---|
文件系统位置 |
|
LDAP 位置 | |
发布者 | 无 CA 安装中的 IPA CA 或外部 CA |
主题 |
|
附加信息 |
必须包含一个主体名称为 |
LDAP TLS 和 STARTTLS 证书
用于 LDAP TLS 和 STARTTLS 连接的证书。必须存在。
LDAP | 描述 |
---|---|
文件系统位置 |
|
LDAP 位置 | |
发布者 | 无 CA 安装中的 IPA CA 或外部 CA |
主题 |
|
附加信息 |
必须包含一个主体名称为 |
KDC 证书
用于 IdM KDC 的 PKINIT 的证书。
KDC | 描述 |
---|---|
文件系统位置 |
|
LDAP 位置 | |
发布者 | 无 CA 安装中的 IPA CA 或外部 CA |
主题 |
|
附加信息 |
必须有扩展的密钥用法 |
25.3. IdM 内部证书续订过程
默认情况下,certmonger
跟踪内部证书,触发续订并请求 IdM CA 发布新证书。
如果您使用外部 CA,且您的内部证书由这个 CA 发布,则它们不会自动续订。在这种情况下,您应该监控证书的到期日期,以确保在证书过期前续订它们。续订过程会非常耗时,如果您没有仔细跟踪到期日期,您的证书将过期,某些服务将不再可用。
如果您的内部 Red Hat Enterprise Linux Identity Management (IdM)证书过期,IdM 无法启动。
IdM CA 续订服务器在过期日期前 28 天续订共享的内部证书。certmonger
会触发此续订,并将新证书上传到 cn=<nickname>,cn=ca_renewal,cn=ipa,cn=etc,$BASEDN
。certmonger
还触发其他 IdM 服务器上的续订进程,但它是在非 CA 续订服务器上执行的,它不会请求新证书,但会从从 LDAP 下载证书。请注意,Server-Cert cert-pki-ca
、HTTP、LDAP 和 PKINIT 证书特定于每个副本,在主题中包含主机名。
如果您在证书过期前使用 getcert
手动续订共享证书,则不会在其他副本上触发续订进程,您必须在其他副本上运行 getcert
,来执行从 LDAP 下载更新的证书。