13.6. 自定义 Web 服务
所有子系统(TKS 除外)都有一些基于 Web 的服务页面,用于代理,另一些用于其他角色,如管理员或结束实体。这些基于 Web 的服务页面使用基本的 HTML 和 JavaScript,它们可以自定义为使用不同的颜色、徽标和其他设计元素适合现有站点或内部网。
13.6.1. 自定义子系统 Web 应用程序
每个 PKI 子系统都有对应的 Web 应用,其中包含:
- 包含文本、JavaScript 代码、页面布局、CSS 格式等的 HTML 页面
- 
								一个 web.xml文件,用于定义 servlets、路径、安全限制和其他
- 到 PKI 库的链接。
						子系统 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
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
$ 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
Context docBase="ca" crossContext="true" allowLinking="true"
    ...
/Context这些更改将立即生效,而无需重新启动服务器。
						要删除自定义 Web 应用程序,只需恢复 docBase 并删除自定义 Web 应用程序目录:
					
rm -rf /var/lib/pki/pki-tomcat/webapps/ca
$ rm -rf /var/lib/pki/pki-tomcat/webapps/ca13.6.2. 自定义 Web UI 主题
同一实例的子系统 Web 应用程序共享相同的主题,其中包含:
- CSS 文件,该文件决定了全局外观
- 镜像文件,包括徽标、图标和其他
- 品牌属性,它决定了页面标题、徽标链接、标题颜色和其他。
						Web UI 使用 /var/lib/pki/pki-tomcat/conf/Catalina/localhost/ 目录中的 pki.xml 上下文文件进行部署:
					
Context docBase="/usr/share/pki/common-ui" crossContext="true" allowLinking="true"
    ...
/Context
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
$ cp -r /usr/share/pki/common-ui /var/lib/pki/pki-tomcat/webapps/pki
						然后,将 docBase 更改为相对于 webapps 目录中的自定义主题目录:
					
Context docBase="pki" crossContext="true" allowLinking="true"
    ...
/Context
Context docBase="pki" crossContext="true" allowLinking="true"
    ...
/Context这些更改将立即生效,而无需重新启动服务器。
						要删除自定义主题,只需恢复 docBase 并删除自定义主题目录:
					
rm -rf /var/lib/pki/pki-tomcat/webapps/pki
$ rm -rf /var/lib/pki/pki-tomcat/webapps/pki13.6.3. 自定义 TPS 令牌状态标签
						默认令牌状态标签存储在 /usr/share/pki/tps/conf/token-states.properties 文件中,如下所述。
					
要自定义标签,将文件复制到实例目录中:
cp /usr/share/pki/tps/conf/token-states.properties /var/lib/pki/pki-tomcat/tps/conf
$ 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
$ rm /var/lib/pki/pki-tomcat/tps/conf/token-states.properties