第 9 章 证书系统配置文件


每个子系统的主配置文件是其 CS.cfg 文件。本章论述了编辑 CS.cfg 文件的基本信息和规则。本章还描述了子系统使用的一些其他有用配置文件,如密码和 Web 服务文件。

9.1. 证书系统子系统的文件和目录位置

证书系统服务器由一个 Apache Tomcat 实例组成,其中包含 一个或多个子系统。每个子系统由一个 Web 应用组成,它处理特定类型的 PKI 功能的请求。

可用的子系统有:CA、KRA、TKS、TKS 和 TPS。每个实例只能包含每种 PKI 子系统类型之一。

可使用 pkispawn 命令在特定实例中安装子系统。

9.1.1. 实例特定信息

有关默认实例的实例信息(pki-tomcat,如果您在运行 pkispawn 时没有指定 pki_instance_name,请参阅 表 2.2 “Tomcat 实例信息”

Expand
表 9.1. 证书服务器端口分配(默认)
端口类型端口号备注

安全端口

8443

通过 HTTPS 通过最终用户、代理和管理员访问 PKI 服务的主要端口。

不安全的端口

8080

用于通过 HTTP 对某些最终用户功能不安全访问服务器。用于提供 CRL,这些 CRL 已签名,因此不需要加密。

过程端口

8009

用于通过 IaaS 连接从前端 Apache 代理服务器访问服务器。重定向到 HTTPS 端口。

Tomcat 端口

8005

Web 服务器使用。

9.1.2. CA 子系统信息

本节包含有关 CA 子系统的详细信息,这是可以作为 Web 应用在证书服务器实例中安装的子系统之一。

Expand
表 9.2. 默认实例的 CA 子系统信息(pki-tomcat)
设置

主目录

/var/lib/pki/pki-tomcat/ca/

配置目录

/var/lib/pki/pki-tomcat/ca/conf/ [a]

配置文件

/var/lib/pki/pki-tomcat/ca/conf/CS.cfg

子系统证书

CA 签名证书

OCSP 签名证书(用于 CA 的内部 OCSP 服务)

TLS 服务器证书

审计日志签名证书

子系统证书 [b]

安全数据库

/var/lib/pki/pki-tomcat/alias/ [c]

日志文件

/var/lib/pki/pki-tomcat/ca/logs/ [d]

安装日志

/var/log/pki/pki-ca-spawn.date.log

卸载日志

/var/log/pki/pki-ca-destroy.date.log

审计日志

/var/log/pki/pki-tomcat/ca/logs/signedAudit/

配置集文件

/var/lib/pki/pki-tomcat/ca/profiles/ca/

电子邮件通知模板

/var/lib/pki/pki-tomcat/ca/emails/

Web 服务文件 [e]

代理服务: /usr/share/pki/ca/webapps/ca/agent/

管理服务: /usr/share/pki/ca/webapps/ca/admin/

最终用户服务: /usr/share/pki/ca/webapps/ca/ee/

[a] 别名为 /etc/pki/pki-tomcat/ca/
[b] 子系统证书始终由安全域发布,以便需要客户端身份验证的域级操作基于此子系统证书。
[c] 请注意,如果实例创建时,所有子系统证书都存储在实例安全数据库或关联的 HSM 中。
[d] 别名为 /var/lib/pki/pki-tomcat/ca
[e] 现在,现在有指向 webapp 位置的 web 描述符,而不是像过去一样特定于实例的 web 应用程序 文件。e.g. 在 /var/lib/pki/rhcs10-RSA-SubCA/conf/Catalina/localhost/ca.xml: <Context docBase="/usr/share/pki/ca/webapps/ca" crossContext="true">

9.1.3. KRA 子系统信息

本节包含有关 KRA 子系统的详细信息,这是可以作为 Web 应用在证书服务器实例中安装的子系统之一。

Expand
表 9.3. 默认实例(pki-tomcat)的 KRA 子系统信息.
设置

主目录

/var/lib/pki/pki-tomcat/kra/

配置目录

/var/lib/pki/pki-tomcat/kra/conf/ [a]

配置文件

/var/lib/pki/pki-tomcat/kra/conf/CS.cfg

子系统证书

传输证书

存储证书

TLS 服务器证书

审计日志签名证书

子系统证书 [b]

安全数据库

/var/lib/pki/pki-tomcat/alias/ [c]

日志文件

/var/lib/pki/pki-tomcat/kra/logs/

安装日志

/var/log/pki/pki-kra-spawn-date.log

卸载日志

/var/log/pki/pki-kra-destroy-date.log

审计日志

/var/log/pki/pki-tomcat/kra/logs/signedAudit/

Web 服务文件 [d]

代理服务: /usr/share/pki/kra/webapps/kra/agent/

管理服务: /usr/share/pki/kra/webapps/kra/admin/

[a] 链接到 /etc/pki/pki-tomcat/kra/
[b] 子系统证书始终由安全域发布,以便需要客户端身份验证的域级操作基于此子系统证书。
[c] 请注意,如果实例创建时,所有子系统证书都存储在实例安全数据库或关联的 HSM 中。
[d] 现在,现在有指向 webapp 位置的 web 描述符,而不是像过去一样特定于实例的 web 应用程序 文件。e.g. 在 /var/lib/pki/rhcs10-RSA-SubCA/conf/Catalina/localhost/ca.xml: <Context docBase="/usr/share/pki/ca/webapps/ca" crossContext="true">

9.1.4. OCSP 子系统信息

本节包含有关 OCSP 子系统的详细信息,这是可以作为 Web 应用在证书服务器实例中安装的子系统之一。

Expand
表 9.4. 默认实例的 OCSP 子系统信息(pki-tomcat)
设置

主目录

/var/lib/pki/pki-tomcat/ocsp/

配置目录

/var/lib/pki/pki-tomcat/ocsp/conf/ [a]

配置文件

/var/lib/pki/pki-tomcat/ocsp/conf/CS.cfg

子系统证书

传输证书

存储证书

TLS 服务器证书

审计日志签名证书

子系统证书 [b]

安全数据库

/var/lib/pki/pki-tomcat/alias/ [c]

日志文件

/var/lib/pki/pki-tomcat/ocsp/logs/

安装日志

/var/log/pki/pki-ocsp-spawn-date.log

卸载日志

/var/log/pki/pki-ocsp-destroy-date.log

审计日志

/var/log/pki/pki-tomcat/ocsp/logs/signedAudit/

Web 服务文件 [d]

代理服务: /var/lib/pki/pki-tomcat/ocsp/webapps/ocsp/agent/

管理员服务: /var/lib/pki/pki-tomcat/ocsp/webapps/ocsp/admin/

[a] 链接到 /etc/pki/pki-tomcat/ocsp/
[b] 子系统证书始终由安全域发布,以便需要客户端身份验证的域级操作基于此子系统证书。
[c] 请注意,如果实例创建时,所有子系统证书都存储在实例安全数据库或关联的 HSM 中。
[d] 现在,现在有指向 webapp 位置的 web 描述符,而不是像过去一样特定于实例的 web 应用程序 文件。e.g. 在 /var/lib/pki/rhcs10-RSA-SubCA/conf/Catalina/localhost/ca.xml: <Context docBase="/usr/share/pki/ca/webapps/ca" crossContext="true">

9.1.5. TKS 子系统信息

本节包含有关 TKS 子系统的详细信息,这是可以作为 Web 应用在证书服务器实例中安装的子系统之一。

Expand
表 9.5. 每次通过初始安装创建子系统时,或者使用(pki-tomcat)创建其他实例。
设置

主目录

/var/lib/pki/pki-tomcat/tks/

配置目录

/var/lib/pki/pki-tomcat/tks/conf/ [a]

配置文件

/var/lib/pki/pki-tomcat/tks/conf/CS.cfg

子系统证书

传输证书

存储证书

TLS 服务器证书

审计日志签名证书

子系统证书 [b]

安全数据库

/var/lib/pki/pki-tomcat/alias/ [c]

日志文件

/var/lib/pki/pki-tomcat/tks/logs/

安装日志

/var/log/pki/pki-tks-spawn-date.log

卸载日志

/var/log/pki/pki-tks-destroy-date.log

审计日志

/var/log/pki/pki-tomcat/tks/logs/signedAudit/

Web 服务文件 [d]

代理服务: /usr/share/pki/tks/webapps/tks/agent/

管理服务: /usr/share/pki/tks/webapps/tks/admin/

[a] 链接到 /etc/pki/pki-tomcat/tks/
[b] 子系统证书始终由安全域发布,以便需要客户端身份验证的域级操作基于此子系统证书。
[c] 请注意,如果实例创建时,所有子系统证书都存储在实例安全数据库或关联的 HSM 中。
[d] 现在,现在有指向 webapp 位置的 web 描述符,而不是像过去一样特定于实例的 web 应用程序 文件。e.g. 在 /var/lib/pki/rhcs10-RSA-SubCA/conf/Catalina/localhost/ca.xml: <Context docBase="/usr/share/pki/ca/webapps/ca" crossContext="true">

9.1.6. TPS 子系统信息

本节包含有关 TPS 子系统的详细信息,这是可以作为 Web 应用在证书服务器实例中安装的子系统之一。

Expand
表 9.6. TPS 子系统信息(pki-tomcat)
设置

主目录

/var/lib/pki/pki-tomcat/tps

配置目录

/var/lib/pki/pki-tomcat/tps/conf/ [a]

配置文件

/var/lib/pki/pki-tomcat/tps/conf/CS.cfg

子系统证书

传输证书

存储证书

TLS 服务器证书

审计日志签名证书

子系统证书 [b]

安全数据库

/var/lib/pki/pki-tomcat/alias/ [c]

日志文件

/var/lib/pki/pki-tomcat/tps/logs/

安装日志

/var/log/pki/pki-tps-spawn-date.log

卸载日志

/var/log/pki/pki-tps-destroy-date.log

审计日志

/var/log/pki/pki-tomcat/tps/logs/signedAudit/

Web 服务文件 [d]

代理服务: /usr/share/pki/tps/webapps/tps/agent/

管理服务: /usr/share/pki/tps/webapps/tps/admin/

[a] 链接到 /etc/pki/pki-tomcat/tps/
[b] 子系统证书始终由安全域发布,以便需要客户端身份验证的域级操作基于此子系统证书。
[c] 请注意,如果实例创建时,所有子系统证书都存储在实例安全数据库或关联的 HSM 中。
[d] 现在,现在有指向 webapp 位置的 web 描述符,而不是像过去一样特定于实例的 web 应用程序 文件。e.g. 在 /var/lib/pki/rhcs10-RSA-SubCA/conf/Catalina/localhost/ca.xml: <Context docBase="/usr/share/pki/ca/webapps/ca" crossContext="true">

9.1.7. 共享证书系统子系统文件位置

表 9.7 “子系统文件位置” 中列出了所有证书系统子系统实例用于常规服务器操作的目录或通用的目录。

Expand
表 9.7. 子系统文件位置
目录位置内容

/var/lib/pki/instance_name

包含主实例目录,这是实例特定目录位置的位置,以及自定义配置文件、配置文件、证书数据库和其他文件,供子系统实例使用。

/usr/share/java/pki

包含由证书系统子系统共享的 Java 存档文件。

/usr/share/pki

包含用于创建证书系统实例的常用文件和模板。除了所有子系统的共享文件外,子文件夹中还有特定于子系统的文件:

  • pki/ca/ (CA)
  • pki/kra/ (KRA)
  • pki/ocsp/ (OCSP)
  • pki/tks/ (TKS)
  • pki/tps (TPS)

/usr/bin /usr/sbin

包含证书系统子系统共享的 pki 命令行脚本和工具(Java、原生和安全性)。

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2025 Red Hat