跳转到主要内容

ssl_crl_file

ssl_crl_file 定义 SSL 证书吊销列表文件的位置。
说明

Fact — 官方简述译文:设置 SSL 证书吊销列表文件的位置。

身份

类型 , string
上游 pg_settings 类型
Context , sighup
配置 reload 后生效
单位 ,
原始单位
范围 ,
最后在档版本的原始上下限
枚举值 ,
非枚举类型记为 —
分类 , Connections and Authentication / SSL
上游分类
最后 boot 值 , ""
empty string

生命周期

Fact
首次观测 PG9.2
在档版本 PG9.2–19 Beta 3
移除版本
引入提交 a445cb92ef5b — Add parameters for controlling locations of server-side SSL files
提交日期 2012-02-22
Discussion

默认值变迁

PG9.0–19 Beta 3 实测 boot 默认值
版本 原始 boot_val 单位 人类可读值
PG9.2–19 Beta 3 "" empty string

机制详解

ssl_crl_file:设置 SSL 证书吊销列表文件的位置。验证客户端证书时会读取该 PEM 吊销列表,并应随颁发机构发布的新吊销状态更新。

ssl_crl_file 属于 SIGHUP 上下文:重新加载配置即可在不重启的情况下激活服务器新值,后续读取它的操作使用刷新值。既有 TLS 会话不会重新协商。

它参与新握手使用的 TLS 上下文。ssl 启用传输,pg_hba.conf 决定哪些连接类别必须使用它,而证书、私钥、CA、吊销、协议与密码参数必须组成一套有效策略。

调优建议

提示

Advice。 以下建议是工作负载起点,必须用真实测量验证。

场景 建议
OLTP 在颁发 CA 的 next-update 截止前刷新 ssl_crl_file,验证签名与颁发者覆盖,重载 PostgreSQL,并证明新吊销客户端证书会被拒绝。
OLAP 分析客户端遵循相同吊销策略;不能因会话更长或频率更低而延后 CRL 刷新。
小规格 若没有受管 CRL 源,应明确记录客户端证书吊销状态不再新鲜,而不是依赖过期文件;在每个故障转移节点监控文件与重载流程。

Pigsty 取值

以下值来自固定 8 核、32 GiB、100 GiB SSD 夹具,并按 PG19 Beta 3 渲染当前 Pigsty 模板;这不表示 Pigsty 当前支持该历史或测试版本。

模板 有效值 与上游 boot 比较 源表达式
OLTP 未修改
OLAP 未修改
CRIT 未修改
TINY 未修改
注意

Advice — 待人工复核。 当前 Pigsty 模板投影事实:OLTP: PG9.2–19 Beta 3 未修改;OLAP: PG9.2–19 Beta 3 未修改;CRIT: PG9.2–19 Beta 3 未修改;TINY: PG9.2–19 Beta 3 未修改。 未发现覆盖值,因此不推断 Pigsty 专属理由。

常见坑

  • 编辑 ssl_crl_file 后没有重新加载配置,也没有核对有效值与后续行为。
  • 只更新一个 TLS 文件或策略参数,留下无效证书链、不可读私钥或不兼容协议集合。
  • 误以为重新加载会重新协商既有会话;TLS 策略变化只影响新握手。
  • 没有回滚计划及客户端或运维兼容测试,就全局修改 ssl_crl_file。

ssl · ssl_cert_file · ssl_key_file · ssl_ca_file · ssl_min_protocol_version

参考资料