14.6. 自定义 Web 服务


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

14.6.1. 自定义子系统 Web 应用程序

每个 PKI 子系统都有对应的 Web 应用,其中包含:
  • 包含文本、JavaScript 代码、页面布局、CSS 格式等的 HTML 页面
  • web.xml 文件,用于定义 servlet、路径、安全限制和其他
  • 到 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>
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

14.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>
docBase 指向默认主题目录 /usr/share/pki/ 的位置。
要自定义主题,请将默认主题目录复制到实例的 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

14.6.3. 自定义 TPS 令牌状态标签

默认令牌状态标签存储在 /usr/share/pki/tps/conf/token-states.properties 文件中,并在 第 2.5.2.4.1.4 节 “令牌状态和转换标签” 中描述。
要自定义标签,将文件复制到实例目录中:
$ 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
Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

© 2024 Red Hat, Inc.