13.6. 自定义 Web 服务

所有子系统(TKS 除外)都有一些基于 Web 的服务页面，用于代理，另一些用于其他角色，如管理员或结束实体。这些基于 Web 的服务页面使用基本的 HTML 和 JavaScript，它们可以自定义为使用不同的颜色、徽标和其他设计元素适合现有站点或内部网。

每个 PKI 子系统都有对应的 Web 应用，其中包含：

子系统 Web 应用使用位于 /var/lib/pki/pki-tomcat/conf/Catalina/localhost/ direcotry 中的上下文文件进行部署，例如 ca.xml 文件：

Context docBase="/usr/share/pki/ca/webapps/ca" crossContext="true" allowLinking="true"
    ...
/Context

docBase 指向默认 Web 应用目录 /usr/share/pki/ 的位置。

要自定义 Web 应用程序，请将 Web 应用程序目录复制到实例的 webapps 目录中：

$ cp -r /usr/share/pki/ca/webapps/ca /var/lib/pki/pki-tomcat/webapps

然后，将 docBase 更改为指向相对于 webapps 目录中的自定义 Web 应用程序目录：

Context docBase="ca" crossContext="true" allowLinking="true"
    ...
/Context

这些更改将立即生效，而无需重新启动服务器。

要删除自定义 Web 应用程序，只需恢复 docBase 并删除自定义 Web 应用程序目录：

$ rm -rf /var/lib/pki/pki-tomcat/webapps/ca

同一实例的子系统 Web 应用程序共享相同的主题，其中包含：

Web UI 使用 /var/lib/pki/pki-tomcat/conf/Catalina/localhost/ 目录中的 pki.xml 上下文文件进行部署：

Context docBase="/usr/share/pki/common-ui" crossContext="true" allowLinking="true"
    ...
/Context

docBase 指向默认主题目录 /usr/share/pki/ 的位置。

要自定义主题，请将默认的me 目录复制到实例的 webapps 目录中的 pki 目录中：

$ cp -r /usr/share/pki/common-ui /var/lib/pki/pki-tomcat/webapps/pki

然后，将 docBase 更改为相对于 webapps 目录中的自定义主题目录：

Context docBase="pki" crossContext="true" allowLinking="true"
    ...
/Context

这些更改将立即生效，而无需重新启动服务器。

要删除自定义主题，只需恢复 docBase 并删除自定义主题目录：

$ rm -rf /var/lib/pki/pki-tomcat/webapps/pki

默认令牌状态标签存储在 /usr/share/pki/tps/conf/token-states.properties 文件中，如下所述。

要自定义标签，将文件复制到实例目录中：

$ cp /usr/share/pki/tps/conf/token-states.properties /var/lib/pki/pki-tomcat/tps/conf

这些更改将立即生效，而无需重新启动服务器。

要删除自定义标签，只需删除自定义文件：

$ rm /var/lib/pki/pki-tomcat/tps/conf/token-states.properties

返回顶部