概述
前文《PostgreSQL 性能调优:内存、I/O 与连接管理》与《PostgreSQL 高可用集群:流复制、Patroni 与 Pgpool-II》已从资源管理和容灾架层面保障了数据库的稳定性与效率。然而,一个真正成熟的数据库系统还需要一道关键防线------安全。数据安全是数据库运维的生命线,也是任何生产级系统不可逾越的红线。PostgreSQL 的安全机制不是功能的简单堆砌,而是一套环环相扣的纵深防御体系:pg_hba.conf 在最外层控制谁可以连接、以什么方式认证;SSL/TLS 在中间层加密传输内容防止窃听;RLS 行级安全在核心层隔离用户数据防止越权访问;审计日志在后方记录一切操作行为,为事后追溯提供依据。本文将逐层拆解这四大安全支柱,从 scram-sha-256 密码认证到 SSL 双向 mTLS,从多租户数据隔离的 RLS 策略到 pgaudit 审计配置,帮助你构建一套可落地的 PG 安全运维方案。
核心要点:
- 客户端认证 :
pg_hba.conf的匹配规则、scram-sha-256安全密码认证与cert证书认证(mTLS)。 - SSL 传输加密 :单向认证与双向认证的证书生成与配置、
sslmode参数详解。 - 行级安全(RLS) :
POLICY的USING/WITH CHECK组合、current_user实现多租户隔离与 RLS bypass 权限边界。 - 审计日志 :内置
log_statement与pgaudit扩展的细粒度审计配置与分析。 - 故障模拟:认证失败与 SSL 握手失败的完整排查流程。
文章组织架构图
架构图说明:
-
总览说明:全文 7 个模块严格遵循从"认证到加密,再到行级隔离与事后审计"的逻辑递进。模块 1 是入口守门人,模块 2 是传输隧道防护,模块 3 是数据核心层隔离,模块 4 是行为记录与追溯。模块 5 和 6 则通过实战演练和对比分析,巩固和拓展知识体系,最终在模块 7 通过面试题完成能力升华。
-
逐模块说明:
- 模块 1-2 构建了通信安全的基础。客户端首先通过
pg_hba.conf进行身份合法性校验,然后通过 SSL/TLS 握手建立加密隧道。这两个模块共同决定了"谁能连进来"以及"通信是否安全"。 - 模块 3 深入数据层的细粒度隔离。即使通过了认证和安全传输,RLS 策略也在内核层面确保用户只能访问其被授权的数据行,是实现多租户 SaaS 应用数据隔离的核心手段。
- 模块 4 提供事后追溯的审计能力。它与前三个防御层互补,不阻止攻击,但记录一切,满足合规要求并为安全事件调查提供依据。
- 模块 5 通过真实的故障场景来验证安全配置的正确性,使理论与实践紧密结合,提升动手排查能力。
- 模块 6 通过对比 MySQL 8.x 的安全机制,帮助读者理解不同数据库的设计哲学,拓展技术选型视野。
- 模块 7 以面试题为载体,对全文知识进行系统性回顾与拔高。
- 模块 1-2 构建了通信安全的基础。客户端首先通过
-
关键结论 :PostgreSQL 的安全体系通过四层纵深防御------
pg_hba.conf认证、SSL/TLS 加密、RLS 行级隔离、pgaudit 审计------提供了从通信到数据到行为的完整保护。理解 RLS 的USING/WITH CHECK策略和pgaudit的审计配置,是构建安全合规 PG 环境的关键能力。
1. 客户端认证机制:pg_hba.conf 与 scram-sha-256
PostgreSQL 的客户端认证是整个安全防御体系的第一个关卡。其设计哲学是将"身份验证"与"用户管理"分离。数据库用户(ROLE)管理在 SQL 层面完成,而谁可以连接、从哪连接、用什么方式验证,则由基于主机的配置文件 pg_hba.conf(Host-Based Authentication)来决定。这种职责分离的设计模式,赋予了管理员极大的灵活性。
1.1 pg_hba.conf:基于主机的访问控制基石
pg_hba.conf 文件的核心在于其规则集的顺序匹配原则。PostgreSQL 的主进程(Postmaster)派生的 Backend 进程在成功建立 TCP 连接后,会读取 pg_hba.conf,并按记录从上到下的顺序逐个匹配,一旦命中则立即停止并使用该条规则进行认证。如果所有规则都不匹配,连接将被最终拒绝。这一机制要求我们通常将更严格的、更具体的规则放在文件前面,而将备用的、宽松的规则放在后面。
1.1.1 文件格式深度解读
一条完整的 pg_hba.conf 记录格式如下,本质上是基于元组(Tuple)的访问控制列表。
ini
# TYPE DATABASE USER ADDRESS METHOD [OPTIONS]
hostssl all all 192.168.1.0/24 scram-sha-256
- TYPE :定义连接协议。
local:Unix 域套接字连接,无需 SSL。这是我们第 12 篇讨论 PgBouncer 时,它通过 Unix socket 连接后端的常用类型。host:TCP/IP 连接,无论是否使用 SSL。当使用 SSL 时,它会覆盖为hostssl的参数。hostssl:强制使用 SSL 加密的 TCP/IP 连接。如果客户端不支持 SSL 或 SSL 握手失败,连接将被拒绝。这是生产环境中最常用的类型。hostnossl:强制不使用 SSL 加密的 TCP/IP 连接,仅用于特殊调试场景。
- DATABASE :指定目标数据库,可为
all、sameuser(用户名与数据库名相同)、samerole或具体的数据库名列表(逗号分隔)。 - USER :指定目标用户,可为
all、具体的用户名,或一个角色组名(前缀+)。 - ADDRESS :客户端的 IP 或 CIDR 地址段。对于
local类型此项为空。这可以与pg_ident.conf进行集成,实现更深度的系统级用户映射。 - METHOD:认证方法,是本文探讨的核心,决定了密码如何在网络上传输和验证。
- OPTIONS :方法特定的选项,例如对于
ldap方法,需要在此指定 LDAP 服务器地址、Base DN 等。
1.1.2 pg_hba.conf 记录匹配流程图
TYPE?"} E -- "不匹配" --> F{"还有下一条记录?"} F -- "是" --> G["读取 pg_hba.conf 下一条记录"] G --> E F -- "否" --> H["拒绝连接
FATAL: no pg_hba.conf entry"] E -- "匹配" --> I{"匹配数据库
DATABASE?"} I -- "不匹配" --> F I -- "匹配" --> J{"匹配用户
USER?"} J -- "不匹配" --> F J -- "匹配" --> K{"匹配客户端地址
ADDRESS 或 Unix User?"} K -- "不匹配" --> F K -- "匹配" --> L["命中规则"] L --> M["执行 METHOD 定义的认证流程
scram-sha-256/cert/ldap等"] M -- "认证成功" --> N["连接建立,授权"] M -- "认证失败" --> O["拒绝连接
FATAL: password authentication failed"] classDef decision fill:#fff4e6,stroke:#ff9800,stroke-width:2px,color:#333; class B,E,F,I,J,K decision;
图表主旨概括 :本图描绘了 Backend 进程在接收到客户端连接后,如何按图索骥地执行 pg_hba.conf 规则匹配,最终决定允许或拒绝连接的全生命周期。
逐层/逐元素分解:
- 连接准入:从 TCP 连接建立,到主进程 Postmaster 将连接"委派"给一个专门服务的 Backend 进程(详见第 3 篇多进程架构),是认证的起点。
- 规则遍历引擎 :Backend 进程不加判断地、自上而下地遍历规则。连接类型(TYPE)、数据库(DATABASE)、用户(USER)和地址(ADDRESS)这四个维度必须同时匹配,这条规则才会被命中。
- 认证执行与终结:规则命中后,无论认证成功还是失败,遍历过程都立即结束。如果认证失败,会立即返回 Fatal 错误,不会尝试后续规则。这正是"顺序是关键"这一设计原则的根源。
设计原理映射:这实现了一种**责任链模式(Chain of Responsibility)**的变体。每个规则都是一个处理器,请求(连接)在链上传递,直到被某个处理器处理(即允许或拒绝)。与经典责任链模式不同的是,这里一旦被处理,链就终止了。
工程联系与关键结论 :在处理一条 FATAL: no pg_hba.conf entry for host 错误时,首要任务是检查是否有任何规则能匹配该连接的所有四个维度,而不是怀疑网络不通。同时,要特别注意 all 通配符的使用,避免意外的规则覆盖。
1.2 核心认证方法(METHOD)详解
认证方法是安全体系中的"战术武器",针对不同环境需要选择最合适的方案。PostgreSQL 通过插件化的方式支持多种认证,极具体现了其可扩展的设计哲学。
1.2.1 scram-sha-256:当前最安全的密码认证
scram-sha-256 是 PostgreSQL 10 之后引入的,并于 14 开始成为默认方法,它实现了 SASL(Simple Authentication and Security Layer)协议中的 SCRAM-SHA-256 机制。
工作原理:挑战/应答(Challenge-Response)机制 这是其安全性的核心。与 md5 或明文 password 不同,用户凭据 secret 从不在网络上传输。
- 客户端启动认证:客户端声明用户名。
- 服务器挑战(Server-First) :Backend 进程查询内部
pg_authid目录,找到属于该用户的SCRAM-SHA-256格式的"隐秘凭证"(verifier,包含 salt、迭代次数iterations和StoredKey、ServerKey)。服务器生成随机数server-nonce,连同 salt 和 iterations 发给客户端。 - 客户端应答与证明(Client-First) :客户端使用用户输入的明文密码,结合 salt 和 iterations 进行
SaltedPassword派生。然后生成自己的client-nonce,拼接得到client-first-message,并计算ClientProof作为自己对密码拥有权的"证明",发送给服务器。 - 服务器验证与签名(Server-Final) :服务器用客户端发来的
ClientProof,结合自己存储的StoredKey进行校验。若匹配,则验证成功。同时,服务器会用ServerKey生成ServerSignature作为自己对客户端的证明,回应给客户端。 - 客户端验证服务器 :客户端同样计算
ServerSignature并与服务器返回的对比,有效防止中间人攻击。
这种机制下,即使攻击者截获了服务器存储的 verifier,也无法直接冒充客户端(因为需要 StoredKey 和 ServerKey 进行双向计算),也无法逆向出原始密码。这比 md5 仅对密码进行加盐哈希并存储在服务器上、以及在网络上传输哈希+盐的方式,安全性有质的提升。
1.2.2 cert(证书)认证:零信任架构下的 mTLS
当 TYPE 为 hostssl 且 METHOD 为 cert 时,即启用基于客户端证书的认证。此认证发生在 SSL/TLS 握手阶段(详见第 2 节)。 工作流程:客户端提供其 SSL 证书,服务器验证该证书是否由服务器配置的受信任证书颁发机构(CA)签发。验证通过后,服务器从客户端证书的 Common Name(CN)字段提取用户名,并验证该用户是否在数据库中存(或通过 pg_ident.conf 映射)。这一切网络传输没有密码,安全性极高,常用于微服务间的双向 TLS(mTLS)。
1.2.3 其他重要方法
- peer(对等认证) :仅适用于
local连接。操作系统级别的用户身份被直接映射为数据库用户。通过内核调用获取对端进程的操作系统用户名,无需任何密码。它安全且便捷,是本地 DBA 管理的首选,但它依赖于操作系统的用户隔离。 - ldap(企业目录认证):将认证请求转发给 LDAP/AD 服务器。适用于企业内已有统一身份管理平台的情况,用户密码不在 PG 中管理,实现了单点登录(SSO)前提下的集中管控。
- md5(旧版哈希认证) :一种基于 MD5 哈希的挑战/应答机制。由于 MD5 算法的脆弱性,它已无法抵抗现代攻击,强烈不建议在生产环境使用 。即使是在内网,其安全性也远低于
scram-sha-256。 - password(明文密码):以明文形式在网络上传输密码,仅用于有 SSL 加密隧道掩护的极端测试环境,或兼容老旧客户端。
1.3 弱密码与暴力破解防护:堵住安全短板
再复杂的认证机制,也无法防护一个密码为 123456 的用户。
1.3.1 passwordcheck 模块:强制密码复杂度
PG 内置了 passwordcheck 模块,通过在 shared_preload_libraries 中加入,并在创建/修改密码时进行钩子(hook)检查。
ini
# postgresql.conf
shared_preload_libraries = 'passwordcheck' # 需要重启生效
此模块会检查密码长度不少于 8 个字符,且不能与用户名太相似。更强大的社区插件如 cracklib_password_check,可以与 Linux 的 cracklib 字典集成,检查密码是否包含在常见密码字典中。
1.3.2 登录失败锁定与延迟
PostgreSQL 内核本身不提供 类似于 MySQL FAILED_LOGIN_ATTEMPTS 的原生失败锁定功能。这是一个设计权衡:PG 认为认证属于系统安全范畴,应交由更成熟的外部工具处理。
- auth_failover 与 fail2ban :生产环境的标配是
fail2ban。它会分析 PG 日志文件,当发现来自同一 IP 的多次认证失败记录(如FATAL: password authentication failed for user)时,会通过配置的 action(如 iptables)短暂或永久封禁该 IP 地址。 - auth_delay:PG 内置的一个辅助模块。当认证失败时,它会在返回错误前休眠几秒钟(默认 5s),有效减缓暴力破解的速率。
ini
# postgresql.conf
shared_preload_libraries = 'auth_delay' # 也需要重启
# 当认证失败时,休眠 10 秒再返回错误
auth_delay.milliseconds = 10000
这种组合拳------passwordcheck 保证密码本身够强、auth_delay 增加破解成本、fail2ban 锁定来源------构成了对暴力破解的纵深防御。
1.4 认证方法选择决策表
选择合适的认证方法是一个工程权衡,需综合安全等级、运维复杂度、网络环境等因素。
| 场景 | 推荐方法 | 配置示例 (pg_hba.conf) |
理由 |
|---|---|---|---|
| 内网高安全环境 | scram-sha-256 |
host all all 10.0.0.0/8 scram-sha-256 |
安全的挑战/应答,密码不落盘、不传输。标准选择。 |
| 云原生/零信任 | cert (mTLS) |
hostssl all all all cert |
完全无密码,证书即身份,是微服务架构和零信任网络的最佳实践。 |
| 企业 AD 域集成 | ldap |
host all all all ldap ldapserver=ad.company.com ldapprefix="uid=" ldapsuffix=",cn=users,dc=company,dc=com" |
与公司统一身份源集成,用户免密管理,符合 IT 政策。 |
| 本地 DBA 管理 | peer 或 scram-sha-256 |
local all postgres peer host all myuser 127.0.0.1/32 scram-sha-256 |
peer 无密码,方便自动化脚本,但要求强 OS 用户隔离。通过 TCP 管理则用安全密码。 |
2. SSL/TLS 传输加密:单向与双向认证
认证确保"你是谁",而传输加密确保"你说的话不被偷听和篡改"。PostgreSQL 通过 OpenSSL 库原生支持 TLS 协议。SSL 不仅是数据通道的加密工具,其证书体系还能与认证机制(cert 方法)无缝集成,实现双向身份验证。
2.1 SSL 连接加密原理
当客户端要求建立 SSL 连接时,TCP 连接建立后,PostgreSQL 使用类似于 HTTPS 的方式,在常规的查询协议启动前进行一个独立的 SSL 握手协商。
- SSLRequest :客户端发送一个特殊报文
SSLRequest给服务器。 - 协商确认 :如果服务器配置了 SSL(
ssl = on),它会回应一个单字节S,随后双方进入标准 TLS 握手;否则回应N,并进入普通连接或断开。 - TLS 握手:握手期间,服务器必须出示其证书,以证明"我是合法的 PostgreSQL 服务"。双方通过 Elliptic Curve Diffie-Hellman Ephemeral(ECDHE)或类似算法交换密钥,完成对称加密隧道的建立。
与 MySQL 不同,PostgreSQL 不通过 SET GLOBAL ssl_* 变量动态管理部分 SSL 参数,而是通过文件系统路径指定证书、私钥和 CA 根证书,简洁且安全(私钥文件权限只需设为 600,由操作系统控制)。
2.2 单向认证:客户端验证服务器
这是最常见的模型,类似于浏览 HTTPS 网站。客户端需要确信它连接的是正确的、未被劫持的数据库服务器。
2.2.1 证书准备与服务器配置
首先,我们需要一套 PKI 体系,通常是一个自签名的 CA 和由它签发的服务器证书。
bash
# 1. 生成 CA 私钥 (root.key) 和自签名 CA 根证书 (root.crt)
# 此步骤生成的是信任锚,有效期10年
openssl req -new -nodes -text -out root.csr -keyout root.key -subj "/CN=MyCompany Root CA"
chmod 600 root.key
openssl x509 -req -in root.csr -extensions v3_ca -signkey root.key -out root.crt -days 3650
# 2. 生成服务器私钥 (server.key) 和证书签名请求 (server.csr)
# 注意 CN 必须是客户端连接时使用的主机名或 IP
openssl req -new -nodes -text -out server.csr -keyout server.key -subj "/CN=pg-primary.internal"
chmod 600 server.key
# 3. 用 CA 签发生成服务器证书 (server.crt)
openssl x509 -req -in server.csr -days 365 -CA root.crt -CAkey root.key -CAcreateserial -out server.crt
# 4. 部署文件到 PostgreSQL 数据目录
cp server.key server.crt root.crt /var/lib/pgsql/16/data/
chown postgres:postgres /var/lib/pgsql/16/data/server.*
chmod 600 /var/lib/pgsql/16/data/server.key # 私钥权限必须严格为600
然后,在 postgresql.conf 中指向这些文件:
ini
# postgresql.conf
ssl = on
ssl_ca_file = 'root.crt' # CA根证书,用于签发客户端证书时使用
ssl_cert_file = 'server.crt' # 服务器证书
ssl_key_file = 'server.key' # 服务器私钥
执行 pg_ctl reload 或 SELECT pg_reload_conf(); 使配置生效。
2.2.2 sslmode 参数:客户端行为控制
客户端的 sslmode 参数决定了它对加密和证书验证的严格程度,这是一个从"无"到"极严"的滑动标尺。
disable:根本不尝试 SSL 连接。allow:先尝试非 SSL,如果服务器要求 SSL,则尝试 SSL。prefer(默认):先尝试 SSL,如果服务器不支持 SSL,则退回非 SSL。require:强制使用 SSL,但不验证服务器证书。能防窃听,不能防中间人。verify-ca:强制 SSL,必须验证服务器证书是否由受信任的 CA 签发。客户端需指定sslrootcert=root.crt。verify-full:在verify-ca的基础上,还要求证书CN与客户端连接的主机名完全匹配。这是最安全的模式。
bash
# 客户端连接示例
psql "host=pg-primary.internal sslmode=verify-full sslrootcert=root.crt dbname=mydb user=appuser"
2.3 双向认证(mTLS):服务器也验证客户端
在零信任网络中,不仅要让客户端知道服务器是真实的,也要让服务器知道客户端是合法的。这就是 Mutual TLS(mTLS),对应 pg_hba.conf 中的 cert 认证方法。
配置双向认证,我们继续签发客户端证书。
bash
# 5. 生成客户端私钥 (client.key) 和证书签名请求 (client.csr)
# CN 必须等于数据库中的用户名
openssl req -new -nodes -text -out client.csr -keyout client.key -subj "/CN=appuser"
chmod 600 client.key
# 6. 用同一个 CA 签发客户端证书 (client.crt)
openssl x509 -req -in client.csr -days 365 -CA root.crt -CAkey root.key -CAcreateserial -out client.crt
pg_hba.conf 中设置使用 cert 认证,同时服务器要能验证客户端证书的 CA。
ini
# postgresql.conf (确认 ssl_ca_file 已配置)
ssl_ca_file = 'root.crt'
# pg_hba.conf
hostssl all all 0.0.0.0/0 cert
客户端连接时,除了 sslrootcert,还需要指定自己的证书和密钥:
bash
psql "host=pg-primary.internal sslmode=verify-full sslrootcert=root.crt sslcert=client.crt sslkey=client.key dbname=mydb user=appuser"
Backend 进程将从客户端证书的 CN 中提取 appuser,并尝试在 pg_hba.conf 中匹配该用户。这种"证书即身份"的模型,消除了网络凭据泄露的风险。
2.4 SSL 单向与双向认证握手序列图
检查 CN (如果 verify-full) C->>S: 加密的会话密钥 Note over C,S: SSL 加密隧道建立
客户端已验证服务器身份 S->>C: 准备开始查询 C->>S: scram-sha-256 密码认证 (或 peer/ldap...) S->>C: 认证成功,连接就绪 Note over C,S: 双向认证 (cert / mTLS) C->>S: TCP 连接建立 C->>S: SSLRequest 报文 S-->>C: 'S' (同意 SSL) S-->>C: TLS 1.3 ServerHello, 证书(server.crt), 密钥交换参数,
CertificateRequest (要求客户端证书) C->>C: 用 root.crt 验证 server.crt C-->>S: TLS Certificate, 客户端证书(client.crt) S->>S: 用 root.crt 验证 client.crt
从 client.crt CN 提取 'appuser' Note over C,S: SSL 加密隧道建立
服务器与客户端互相验证身份 S-->>C: TLS Finished (握手完成) Note over S: 将从证书提取的 'appuser'
直接交给认证子系统 S->>C: 认证成功,连接就绪 (无额外密码交互)
图表主旨概括 :本序列图清晰地对比了 HTTPS 式单向 TLS 验证客户端和 mTLS 双向证书验证的全握手交互过程,尤其突出了 cert 认证方法下,SSL 与认证系统的完美融合。
逐层/逐元素分解:
- SSL Request/Response:这是 PG 特有的协议扩展,独立于标准 TLS。它使得客户端可以与服务器就"是否使用加密"进行快速协商。
- 单向认证流程:服务器被强制出示证书。TLS 握手在这个阶段就已经完成了服务器的身份验证。随后,应用层再进行用户的密码(如 scram-sha-256)认证。
- 双向认证流程 :服务器在发出自己的证书后,额多了一个
CertificateRequest步骤。客户端必须回应自己的证书。TLS 握手在此阶段完成了双方身份验证。连接建立后,cert方法直接从证书提取身份,完全旁路了密码验证流程。
设计原理映射 :此设计将传输安全(加密)与身份认证(证书验证)深度整合。hostssl + cert 的组合,确保如果未通过双向 TLS 验证,连接根本不会被建立,更不可能到达 pg_hba.conf 匹配的步骤。这实现了从网络层到应用层的统一安全准入。
工程联系与关键结论 :在实施 mTLS 后,务必确认客户端证书的 CN 字段与数据库用户名严格匹配(或通过 pg_ident.conf 映射)。ssl_ca_file 指定的根证书,必须是既能签发服务器证书,又能签发客户端证书的那个 CA(或其上级 CA),否则服务器将无法验证客户端证书,导致 TLS 握手在服务器端失败。
2.5 SSL 证书更新与热重载
生产系统中,SSL 证书有有效期,需要定期轮换。PostgreSQL 在 SSL 证书管理上,实现了一个对运维友好的特性:不需要重启服务即可重新加载新证书 。 只需替换数据目录下的 server.crt 和 server.key 文件,然后执行:
bash
pg_ctl reload
# 或在 psql 中执行
SELECT pg_reload_conf();
PostgreSQL 的主进程收到 SIGHUP 信号后,会重新读取配置文件,并在此过程中加载新的证书和私钥。所有现有连接将继续使用旧证书完成会话,而新进来的连接将基于新证书进行 TLS 1.3 握手。 这实现了无缝、平滑的证书切换,业务零感知。
2.6 SSL 性能影响评估
无可否认,加密会带来性能开销,主要集中在这几个方面。
- 连接建立延迟:TLS 握手涉及证书验证和密钥交换,会比非加密多出几到几十毫秒的延迟。对于短连接(每次查询都重新连接)影响被放大,这凸显了连接池(详见第 12 篇 PgBouncer)的重要性。PgBouncer 通过保持一组常驻 TLS 连接,将握手开销均摊。
- 数据传输吞吐量(TPS):AES-NI 等现代加密算法在硬件支持下,对称加解密已不再是主要瓶颈。实测下来,CPU 开销通常增加 5% 到 15%。对于 I/O 密集型的查询,影响几乎可以忽略不计。
- 硬件加速建议 :确保 OpenSSL 编译时启用了硬件加速,并核对 CPU 是否支持 AES-NI 指令集(
grep aes /proc/cpuinfo)。使用现代 CPU(Intel Westmere 及以上、AMD Zen 及以上)几乎可以无损地获得线速的 TLS 吞吐能力。
3. 行级安全策略(RLS):多租户数据隔离
通过了认证(我是合法用户)和建立了加密隧道(通信安全),我们的防御体系进入其最深奥的部分:数据库内核对数据行的访问控制。这就是 Row-Level Security (RLS)。RLS 不是简单的权限(GRANT)替代品,而是一种对 SQL 透明的、基于策略的细粒度过滤机制。
3.1 RLS 的原理与启用
在 RLS 启用前,PostgreSQL 的权限模型是基于对象的,例如对一个表的 SELECT 权限,意味着用户可见该表的所有行。RLS 则在此基础上增加一个新的维度:即使你有表的 SELECT 权限,你能看到哪些行,也将受到策略的约束。 RLS 默认是关闭的。必须由表的所有者或超级用户显式地为表启用它。
sql
-- 启用 RLS,并将表"锁定"为默拒状态
ALTER TABLE projects ENABLE ROW LEVEL SECURITY;
一旦启用,所有访问------包括表的所有者、执行查询的后端------都会被隐式应用策略过滤。 唯一例外的是表所有者(owner)和具有 BYPASSRLS 属性的超级用户。这个默认拒绝(default-deny)的开局,是安全设计的最佳实践。
3.2 CREATE POLICY 的核心子句:USING 与 WITH CHECK
RLS 的强大之处在于 CREATE POLICY 语句,它允许我们精确描述"什么操作(FOR)在什么条件下(USING/WITH CHECK)被允许"。
sql
CREATE POLICY name ON table_name
[ AS { PERMISSIVE | RESTRICTIVE } ] -- 策略组合模式
[ FOR { ALL | SELECT | INSERT | UPDATE | DELETE } ]
[ TO { role_name | PUBLIC | current_user | SESSION_USER } ]
[ USING ( using_expression ) ]
[ WITH CHECK ( check_expression ) ];
USING (expression):作为"读"过滤器。它对查询中已存在的行 生效。对于SELECT,只返回USING表达式为 true 的行;对于UPDATE和DELETE,只有USING表达式为 true 的行才能被更新或删除。可以将其理解为查询优化器自动添加的隐式WHERE条件。WITH CHECK (expression):作为"写"校验器。这个表达式在新行被INSERT或现有行被UPDATE之后 进行校验。如果校验失败,整个写入操作会被拒绝并报错。它确保任何落在表里的数据,都依然符合策略的要求。对于 UPDATE,如果新旧行都需要过滤,则USING和WITH CHECK都必须返回 true。PERMISSIVEvsRESTRICTIVE:这是 PG 10 引入的。PERMISSIVE(默认)策略是多条策略逻辑上是"OR"的关系,即任一条允许就允许;而RESTRICTIVE策略是多条策略是"AND"的关系,必须全部允许。这为构建复杂的复合安全策略提供了可能。
3.3 多租户 SaaS 数据隔离实战
这是 RLS 最经典的工程应用场景:一个表里存储了多个租户的数据,通过 RLS 确保租户 A 的用户绝无可能看到租户 B 的数据。
场景 :一个项目管理 SaaS 平台,所有项目数据存于 projects 表,用一个 tenant_id 字段区分所属租户。
步骤 1:建表与用户隔离模型
sql
-- 创建一个公共的表
CREATE TABLE projects (
id serial PRIMARY KEY,
tenant_id text NOT NULL, -- 租户标识
project_name text NOT NULL,
budget numeric
);
-- 创建两个租户对应的数据库用户
CREATE ROLE tenant_a_user WITH LOGIN PASSWORD 'password_a';
CREATE ROLE tenant_b_user WITH LOGIN PASSWORD 'password_b';
-- 赋予基本表权限,这是RLS生效的前提
GRANT SELECT, INSERT, UPDATE, DELETE ON projects TO tenant_a_user, tenant_b_user;
GRANT USAGE ON SEQUENCE projects_id_seq TO tenant_a_user, tenant_b_user;
步骤 2:启用 RLS 并创建策略
sql
-- 表所有者 (通常是超级用户或 DBA 角色) 来启用
ALTER TABLE projects ENABLE ROW LEVEL SECURITY;
-- 创建 PERMISSIVE 策略,让每个租户用户只能看到自己的数据
CREATE POLICY tenant_isolation ON projects
FOR ALL -- 对所有操作生效
TO tenant_a_user, tenant_b_user -- 仅对这两个租户用户生效
USING (tenant_id = current_user) -- 读取时的过滤器
WITH CHECK (tenant_id = current_user); -- 写入时的校验器
-- 对于不同租户使用相同 DB 用户的情况,可通过 current_setting 实现
-- 策略1:读取时过滤
CREATE POLICY tenant_isolation_select ON projects
FOR SELECT
USING (tenant_id = current_setting('app.current_tenant'));
-- 策略2:写入时自动注入当前租户
CREATE POLICY tenant_isolation_insert ON projects
FOR INSERT
WITH CHECK (tenant_id = current_setting('app.current_tenant'));
步骤 3:性能优化------索引加速 RLS 的 USING 子句本质是增加了 WHERE 条件,那么这个条件能否被索引加速就至关重要。
sql
-- 在 tenant_id 上创建索引,对于筛选特定租户的所有项目,将启用索引扫描
CREATE INDEX idx_projects_tenant_id ON projects (tenant_id);
没有这个索引,即使 RLS 过滤了行,也可能变成对整个表的顺序扫描。正确的索引设计是 RLS 能够高性能运行的前提。
步骤 4:连接与验证 应用层在为用户建立数据库连接时,需要"告知"PG 用户身份。
- 方案 A(独立用户) :应用使用
tenant_a_user身份连接。RLS 通过current_user自动匹配,最简单且安全。 - 方案 B(共享用户+运行时参数) :所有连接使用同一个数据库用户(如
app_user),但由受控的中间件设置application_name或自定义 GUC 参数。
java
// Java 端示例
// String url = "jdbc:postgresql://host/db?ApplicationName=tenant_a&..."
对应 PG 侧可通过 current_setting 获取。
sql
CREATE POLICY tenant_isolation_setting ON projects
USING (tenant_id = current_setting('application_name'));
务必注意 :方案 B 的安全性完全依赖于应用层 。如果用户可以篡改 JDBC URL 的 ApplicationName,他就能看到其他租户的数据!因此,方案 A(使用独立的 PG 用户)是从数据库层面保证安全性的最佳实践。
3.4 RLS Bypass 与 SECURITY DEFINER 函数
RLS 并不是无懈可击的,需要警惕几个绕过的路径。
- 表所有者(Owner)与 BYPASSRLS 属性 :这是最常见的误解 ------认为启用 RLS 后所有用户都受限。实际上,表的创建者(
owner)和被赋予BYPASSRLS属性的超级用户,是直接绕过 RLS 的。因此,在多租户系统中,创建表的 DBA 角色绝对不能直接接触用户数据,应用永远不应使用这类高级别角色连接。 - SECURITY DEFINER 函数:这是一种强大的机制,允许函数以其创建者的权限执行,而不是以调用者的权限。这是一个巨大的 RLS 盲区。
sql
-- DBA (RLS 的 bypasser) 无意中创建了一个 SECURITY DEFINER 函数
CREATE FUNCTION public.count_projects() RETURNS bigint AS $$
SELECT count(*) FROM projects; -- 可能是想提供公共统计
$$ LANGUAGE sql SECURITY DEFINER;
-- 一个受限用户调用此函数
-- 结果:函数以 DBA 身份执行,绕过了 RLS,租户 A 的用户能查到 *所有* 租户的总项目数!
SELECT public.count_projects();
最佳实践 :任何 SECURITY DEFINER 函数,如果查询了启用了 RLS 的表,必须在其函数体内部执行 SET LOCAL row_security = force; 或慎重评估其必要性。在大多数情况下,应避免使用此类模式来暴露 RLS 表的数据。
3.5 RLS 与查询优化器的协作
为了理解 RLS 如何工作,我们需要结合第 6 篇(MVCC)和第 5 篇(索引)的知识。当一个会话对某表执行 SELECT * FROM projects,CREATE POLICY ... USING (tenant_id = current_user) 便介入。
sql
-- 原始用户查询
SELECT * FROM projects;
-- 查询重写器/优化器的等效视图
SELECT * FROM projects WHERE tenant_id = current_user;
这个 WHERE 子句在查询规划的早期阶段生效,与在 SQL 中直接书写的 WHERE 条件毫无二致。优化器会基于表统计信息和索引进行相同的成本估算。这意味着:
- 如果
tenant_id上有索引,查询SELECT * FROM projects会以Index Scan的方式执行,性能极高。 - RLS 条件与用户查询中显式指定的条件会通过 AND 逻辑组合,优化器可以进行联合优化。
插入 RLS POLICY 执行流程图
SELECT * FROM projects"] --> B{"pg_hba.conf 认证通过?"} B -- "否" --> C["拒绝访问"] B -- "是" --> D["SQL 解析与重写"] D --> E{"表 projects 启用了 RLS?"} E -- "否" --> F["正常执行查询计划"] E -- "是" --> G{"调用者是表 Owner 或有 BYPASSRLS?"} G -- "是" --> F G -- "否" --> H["查阅 RLS 策略
匹配当前角色和操作的Policy"] H --> I["提取符合条件的 PERMISSIVE 和 RESTRICTIVE 策略"] I --> J["将策略的 USING 和 WITH CHECK 条件
作为隐式 WHERE 子句注入查询树"] J --> K["查询优化器分析
合并、简化条件,选择最优执行计划"] L["执行查询计划
进行索引/顺序扫描"] --> M{"输出结果行"} K --> L M --> N["结果返回客户端"] classDef decision fill:#fff4e6,stroke:#ff9800,stroke-width:2px,color:#333; class B,E,G,M decision;
图表主旨概括:本图清晰地展现了 RLS 如何在 SQL 执行流程中,通过"装饰器模式"般的技术,无缝地为查询添加安全过滤条件,并与查询优化器深度整合。
逐层/逐元素分解:
- 权限序曲:RLS 的执行总是发生在认证与连接授权成功之后。它是对已建立的、可信连接的进一步细粒度控制。
- RP 检测与 Bypass:这是 RLS 的第一道"门禁"。如果不是表所有者且无 BYPASSRLS,才会进入策略评估流程,这确保了 RLS 对高级管理角色不可见。
- 策略注入(关键步骤) :RLS 的核心动作------将声明式的安全策略(
POLICY)转换为关系代数的过滤谓词(WHERE clause),然后将其"装饰"到用户原始的查询逻辑表达式上。 - 优化与执行:注入后的"增强版"查询逻辑表达式进入优化器。这是 RLS 能够高效运行的最终保障,使得安全开销可控。
设计原理映射 :RLS 是装饰器模式(Decorator Pattern)在数据库内核的精妙实现。它不改变查询引擎的核心接口(SQL 语句),而是在查询编译阶段,透明地为其附加上安全检查的功能。这使得安全逻辑与业务 SQL 完全解耦。
工程联系与关键结论 :永远不要依赖应用程序的 WHERE 子句来隔离多租户数据。DB 层 RLS 策略是最后、最不可逾越的防线。同时,必须为 RLS 策略条件中使用的列(如 tenant_id, user_name)创建索引,否则看似简单的租户隔离查询也可能引发全表扫描,在高并发下拖垮系统。
4. 审计日志:log_statement 与 pgaudit
认证和加密好比高墙和密码锁,保护着数据不被未授权者获取;行级安全是内部进一步分区隔离;而审计则像个摄像机,记录下发生在墙内的一切。没有审计的安全体系,在发生数据泄露或篡改时将溯源无门。
4.1 内置日志记录:粗粒度的行为监控
PostgreSQL 的 postgresql.conf 提供了一系列内置参数,用于记录 SQL 执行活动,构成了最基本的审计能力。
log_statement:这是最直接的方式。设置不同级别记录不同类别的 SQL。none(默认):不记录。ddl:记录所有数据定义语言,如CREATE,ALTER,DROP。mod:记录ddl加上所有数据修改语言,如INSERT,UPDATE,DELETE,TRUNCATE,COPY FROM。all:记录所有语句,包括SELECT。在性能敏感的生产环境中开启all会带来巨大的 I/O 和日志量开销。
log_duration:在每条语句后记录其持续时间。它与log_statement结合可以找出执行时间过长的异常操作。但注意,如果没有设置log_statement,log_duration只会输出duration: X ms,你并不知道执行了什么语句。log_connections/log_disconnections:记录每次客户端的连接建立和断开事件。在结合第 12 篇 PgBouncer 连接池使用时,这有助于分析哪些应用或用户在频繁长/短连接,是否存在连接泄露,或发现来自异常 IP 的试探。
这些内置功能共同的问题是:缺乏上下文 。比如 log_statement=all 产生的日志是:
text
LOG: statement: SELECT * FROM accounts WHERE id = 123;
我们无法从这条日志中知道是哪个应用用户发出了该命令,也无法关联绑定的参数。
4.2 pgaudit 扩展:事件驱动的细粒度审计
pgaudit 是 PG 生态中执行标准审计的事实标准,它提供了比内置日志精细得多的会话/对象审计能力。其设计是基于事件触发器(event triggers)和钩子,可以拦截所有 SQL 命令执行的入口出口。
4.2.1 安装与配置
ini
# postgresql.conf
shared_preload_libraries = 'pgaudit' # 需要重启
sql
-- 在每个需要审计的数据库(或 template1)中创建扩展
CREATE EXTENSION IF NOT EXISTS pgaudit;
配置由一系列 GUC 参数控制,所有参数都支持 SET 命令在线修改,无需重启。
sql
-- 设置审计策略,通过逗号分隔的类来定义要审计的操作
ALTER SYSTEM SET pgaudit.log = 'write, ddl, role';
SELECT pg_reload_conf();
4.2.2 审计策略与类(Class)
pgaudit.log 可配置为多个类的组合,类的设计遵循了最小惊讶原则,清晰易读:
| 类名 | 涵盖的 SQL 命令/操作 | 典型用途 |
|---|---|---|
| READ | SELECT, COPY TO |
追踪敏感数据的读取,如工资、医疗记录。 |
| WRITE | INSERT, UPDATE, DELETE, TRUNCATE, COPY FROM |
监控任何数据更改,是数据完整性审计的核心。 |
| FUNCTION | 函数调用 (DO 块) |
审计存储过程的执行,特别是包含业务逻辑的。 |
| ROLE | 角色/用户创建、修改、删除,授权/回收 (GRANT/REVOKE) | 跟踪权限变更,防内鬼提权。 |
| DDL | 所有 CREATE, ALTER, DROP 语句,但不包括 ROLE 相关 |
跟踪数据库架构的所有变化。 |
| MISC | DISCARD, FETCH, CHECKPOINT, VACUUM 等 |
捕获不太常见的、可能用于探索或攻击的命令。 |
| ALL | 上述所有 | 全覆盖审计,仅适用于受控的合规环境。 |
还有两个重要参数:
pgaudit.log_catalog(boolean):设置为on时,会审计对系统表(pg_catalog模式)的查询。生产系统通常设为off以减少噪音,因为很多客户端工具会后台查询系统表。pgaudit.log_client(boolean):设为on时,审计日志除了写入服务器日志文件外,还会返回给连接的客户端。便于调试,但绝不能在生产环境开启,因为它可能向潜在攻击者泄露审计配置。
4.2.3 审计日志的上下文与格式
pgaudit 生成的审计日志是结构化、带有丰富元数据的,这完美弥补了内置日志的不足。
text
LOG: AUDIT: SESSION,1,1,WRITE,INSERT,TABLE,public.accounts,"INSERT INTO accounts (id, name, balance) VALUES (1, 'Alice', 1000);",<not logged>
分析这条记录:
- LOG: AUDIT: 标明这是一条 pgaudit 输出。
- SESSION,1,1:审计类型、语句和子语句的序列号,用于关联复杂操作。
- WRITE,INSERT,TABLE,public.accounts:操作的类、SQL命令、对象类型和完全限定对象名。这正是我们审计策略配置的目标。
- INSERT INTO accounts...:完整的 SQL 文本,这是溯源的关键证据。
**<not logged>**:SQL 语句里的参数如果有占位符,此处会显示参数值,但可通过pgaudit.log_parameter配置。
4.2.4 审计日志集中化管理(ELK 集成思路)
为了在海量日志中发现异常并生成报表,必须将这些分布在各个数据库节点的审计日志集中采集。业界标准方案是 ELK(Elasticsearch, Logstash, Kibana)或 EFK(Fluentd)。
-
PG 端 :使用
csvlog输出格式,减少解析难度。inilog_destination = 'csvlog' # 便于Logstash解析 logging_collector = on log_directory = 'pg_log' log_filename = 'postgresql-%a.log' # 每日切分 -
采集端 :使用 Filebeat 或 Fluentd 作为 Agent 部署在数据库服务器上,实时 tail
pg_log目录下的 CSV 文件。 -
处理端 :Logstash/Fluentd 过滤器根据
AUDIT:前缀识别审计日志,解析出字段(user, database, command, object_name, SQL text)后发送到 ElasticSearch。 -
展示端 :在 Kibana 上创建监控仪表板,实时展示失败认证趋势、敏感表
READ操作 Top N、DDL 变更历史等。
4.3 审计策略实战示例
1. 审计除 SELECT 之外的所有写操作和模式变更 这是一个生产系统最基础的审计策略,平衡了安全性与日志量。
ini
# postgresql.conf
pgaudit.log = 'write, ddl'
2. 审计针对敏感表 salaries 的所有 SELECT 访问 对于高度敏感的核心数据,需要开启更严苛的审计。这可以通过对象审计级别实现。
sql
-- 首先确保 pgaudit.log 未全局开启 READ
ALTER SYSTEM SET pgaudit.log = 'none'; SELECT pg_reload_conf();
-- 对特定表启用对 SELECT 的审计
ALTER SYSTEM SET pgaudit.log_level = 'notice'; -- 可选,将审计日志级别提高
-- 通过 pgaudit 的表审计功能 (依赖 pgaudit.log = 'ROLE' 和 GRANT)
GRANT SELECT ON salaries TO auditor;
-- 注意:pgaudit 的对象审计需要通过 GRANT/REVOKE 来控制,对象所有权本身不触发审计。
一个更直接的方法是创建自定义的审计触发器函数,但 pgaudit 的此功能已提供了一种非侵入式的替代方案。
3. 查询和筛选审计日志 当审计数据进入集中平台后,你可以执行强大的查询。例如,找出非上班时间访问工资表的可疑操作:
sql
-- 假设这是上传到Elasticsearch后的近似SQL查询语法
SELECT user, timestamp, query
FROM pgaudit_logs
WHERE table_name = 'salaries'
AND command = 'SELECT'
AND timestamp BETWEEN '2024-01-01 00:00:00' AND '2024-01-31 23:59:59'
AND EXTRACT(HOUR FROM timestamp) NOT BETWEEN 9 AND 18
ORDER BY timestamp DESC;
5. 故障模拟与排查:认证失败与 SSL 握手失败
理论固本,实战防身。本节我们将模拟两个高频故障,串联起前文所学的 pg_hba.conf、SSL 配置和日志分析知识。
5.1 故障一:认证失败排查
故障现象 :应用端报错 FATAL: no pg_hba.conf entry for host "10.0.1.5", user "appuser", database "mydb", no encryption。
排查流程:
-
重演与信息收集 :错误日志已经给出了强有力的线索。它明确告诉我们:有一个连接尝试来自主机
10.0.1.5,想要以用户appuser身份访问数据库mydb,且此次连接没有使用 SSL 加密。问题直接指向pg_hba.conf中的规则集。 -
分析
pg_hba.conf配置 : 我们查看服务器上的pg_hba.conf,发现当前相关规则有以下几条:ini# 第 1 条:允许本地 loopback 的所有连接 host all all 127.0.0.1/32 scram-sha-256 # 第 2 条:允许内网网段 10.0.0.0/16,但仅限 produser 用户且必须 SSL hostssl mydb produser 10.0.0.0/16 scram-sha-256 # 第 3 条:一个看似想允许所有内网无 SSL 连接的备选规则 host mydb appuser 10.0.1.0/24 md5 -
定位根源 :
- 客户端来自
10.0.1.5,它本想匹配10.0.1.0/24网段,这没问题。 - 客户端用户是
appuser,数据库是mydb,也都与第 2 条和第 3 条匹配。 - 但是 ,客户端报错
no encryption。根据规则从上到下匹配的原则,10.0.1.5首先遇上了第 2 条规则hostssl mydb produser ...。 - 第 2 条规则要求 TYPE 必须是
hostssl。因客户端是no encryption,此项匹配失败。 - 然而,第 2 条在
USER字段是produser,而客户端是appuser,> 这里也匹配失败。 - 引擎继续搜寻下一条规则,即第 3 条
host mydb appuser 10.0.1.0/24 md5。 - 但是,第 3 条的 METHOD 是
md5,而appuser可能最近刚更新密码为 scram-sha-256 加密,或者应用配置使用的就是 scram-sha-256 认证!因此,认证在md5环节失败,导致输出日志不是no pg_hba.conf entry,而是password authentication failed。我们假设appuser确实配置了 md5 密码,但还有一个可能:第 3 条规则输入的 TYPE 是host,它本应匹配无 SSL 的连接。 - 真实根因 :检查
pg_hba.conf后会发现,原来第 3 条规则是hostssl mydb appuser 10.0.1.0/24 md5,hostssl导致它必须要求 SSL,但客户端又是无 SSL 的。因此,这条规则也无法匹配。 - 由于所有规则都未命中,最终客户端得到
FATAL: no pg_hba.conf entry...。
- 客户端来自
-
修复 :将第 3 条规则的 TYPE 改为
host或hostnossl,或者让应用侧强制启用 SSL(推荐)。inihost mydb appuser 10.0.1.0/24 scram-sha-256 -
验证:应用重连,问题解决。
5.2 故障二:SSL 握手失败排查
故障现象 :尝试用 sslmode=verify-full 连接,失败,错误信息可能为 FATAL: certificate verify failed 或 sslmode=verify-full error。
排查流程:使用 openssl s_client 利器 这是一个完全可以脱离应用,直接诊断 TLS 握手问题的标准方法。
bash
# 1. 诊断命令。尝试用 openssl 模拟客户端与 PG 进行 TLS 握手
# -connect: 指定 PG 的主机和端口
# -starttls postgres: 关键!告诉 openssl 先发送PG的 SSLRequest,再进行TLS握手
openssl s_client -connect pg-primary.internal:5432 -starttls postgres
输出解读与分析: 假设执行上述命令后,我们在冗长的输出中看到这样一行:
text
Verify return code: 19 (self-signed certificate in certificate chain)
这提供了明确的根因线索。
-
服务器端验证 :首先,在
openssl s_client的输出中找到服务器证书链(Server certificate),确认subject=CN = pg-primary.internal的内容与期望一致。这基本证明服务器端配置了证书,并成功返回了。 -
客户端信任链检查 :"
self-signed certificate in certificate chain" 这个错误明确指出,客户端的openssl库(以及 psql)在尝试验证服务器证书时,发现了证书链中存在自签名证书。这通常意味着:- 服务器使用的证书
server.crt是一个自签名证书,而不是由 CA 签发的。 - 或者,服务器正确返回了 CA 签发的
server.crt,但是客户端没有将签发该证书的 CA 根证书(root.crt)加入其信任库。
- 服务器使用的证书
-
指定 CA 进行复测 :我们模拟客户端的
sslrootcert参数,显式指定 CA 根证书进行重试。bash# -CAfile 指定客户端用于验证服务器证书的 CA 证书路径 openssl s_client -connect pg-primary.internal:5432 -starttls postgres -CAfile /path/to/root.crt- 如果这次连接成功,并且末尾显示
Verify return code: 0 (ok),那就证实了问题根源是客户端缺少或未正确配置sslrootcert。 - 如果仍然返回错误,比如
Verify return code: 21 (unable to verify the first certificate),则很可能是服务器配置文件ssl_ca_file或ssl_cert_file指向有误,或者server.crt的 CA 根本就不是我们提供的这个root.crt。
- 如果这次连接成功,并且末尾显示
修复 :将正确的 root.crt 文件提供给 psql 或 JDBC 驱动程序,并确保 JDBC 连接字符串中指定了 sslrootcert=root.crt,同时保持 sslmode=verify-ca 或 verify-full。
插入认证失败排查决策树
listen_addresses"] N2 --> N3["检查防火墙规则/安全组"] end NetIssue --> NetIssue_Detail subgraph HBAIssue_Detail ["pg_hba.conf 排查"] H1["确认客户端 IP、用户、数据库"] --> H2["逐条对比 pg_hba.conf 记录
TYPE -> DATABASE -> USER -> ADDRESS"] H2 -- "所有不匹配" --> H3["添加正确的规则"] H2 -- "匹配但失败" --> H4["检查 METHOD 是否匹配
如未开启 SSL 却匹配了 hostssl"] H4 --> H3 end HBAIssue --> HBAIssue_Detail subgraph PassIssue_Detail ["密码/认证排查"] P1["确认用户名和密码是否正确"] --> P2{"密码是否过期?"} P2 -- "可能" --> P3["修改密码"] P2 -- "否" --> P4["检查 pg_hba.conf METHOD
是否与用户预期一致"] P4 -- "e.g., 用户是 scram, 规则是 md5" --> P5["调整规则 METHOD 为 scram-sha-256"] end PassIssue --> PassIssue_Detail subgraph SSLIssue_Detail ["SSL 证书排查"] S1["使用 openssl s_client 诊断"] --> S2{"客户端能否完成握手?"} S2 -- "能,但验证码非0" --> S3["检查客户端 root.crt 是否正确
且服务器证书由其签发"] S3 --> S4["更新客户端的 root.crt"] S2 -- "不能,握手直接失败" --> S5["检查服务器端证书和私钥
ssl_cert_file/ssl_key_file"] S5 --> S6["确认证书文件权限正确
私钥0700 或 0600"] end SSLIssue --> SSLIssue_Detail Start --> End["问题解决,连接成功"]
图表主旨概括:这张决策树流程图提供了一个标准化、可操作的路径,指导 DBAs 和开发者根据具体的错误信息,一步步缩小范围、定位并解决 PostgreSQL 连接失败的根本原因。
逐层/逐元素分解:
- 错误分流:第一层决策点依据 PG 返回的 FATAL 错误信息将问题分为四个大类,这是最高效的诊断起点。
- 网络层诊断 :检查最基础的 TCP/IP 连通性,是排查
pg_hba.conf或 SSL 问题前必须排除的物理前提。 - HBA 规则诊断 :复现了我们已掌握的从上到下匹配原则,并强调了
hostvshostssl的匹配条件。 - 密码与 SSL 深度诊断 :分别对应了认证方法和证书信任链这两个最常出错的环节,并给出了类似
openssl s_client和确认 METHOD 的具体工具和方法。
设计原理映射:这是一个典型的故障排除决策树,它将经验知识(常见报错和对应根因)形式化为一个逻辑分支,形成一套可复用的排错心智模型。
工程联系与关键结论 :精确阅读和理解错误日志是解决问题的捷径。FATAL: no pg_hba.conf entry 和 FATAL: password authentication failed 有明确的根因指向。而当遇到 certificate verify failed 等 SSL 错误时,不急于修改配置,应先用 openssl s_client -starttls postgres 命令模拟 TLS 握手,将客户端与服务器的问题剥离开,这是定位 TLS 故障的最强利器。
6. 与 MySQL 8.x 的差异对比
理解 PostgreSQL 和 MySQL 在安全设计上的异同,能帮助技术决策者在多数据库栈中做出正确选择。下表从四大维度对比两者关键差异。
| 特性 | PostgreSQL 16.x | MySQL 8.x | 关键差异与工程影响 |
|---|---|---|---|
| 认证模型 | 基于文件的访问控制 :pg_hba.conf 是独立的、中心化的配置文件,实现基于主机、用户、数据库的多维规则匹配。认证方法(scram-sha-256, cert, ldap)以插件化形式存在。 |
基于表的访问控制 :用户账户和权限统一存储在 mysql.user 系统表中。认证方法通常与用户绑定,如 IDENTIFIED WITH caching_sha2_password。 |
PG 将"谁能连接"的防火墙规则与"用户的密码/认证方式"管理分离,更灵活。MySQL 两者绑定更紧密,管理上与传统的 RDBMS 用户管理模型更接近。 |
| 密码认证 | scram-sha-256 是其最安全的原生挑战/应答机制。不支持明文存储密码,也从不传输哈希。 |
caching_sha2_password 从 MySQL 8.0 开始成为默认选项,同样基于 SHA-256,也支持安全的公钥/私钥交换,比旧的 mysql_native_password 安全得多。 |
两者在密码安全级别上趋于一致,但实现机制不同。PG 的 passwordcheck 模块强制密码复杂度,而 MySQL 有内置的 validate_password 组件。 |
| 行级安全(RLS) | 原生支持 RLS + 灵活 POLICY 。通过 CREATE POLICY,可以精细控制到 SELECT、INSERT、UPDATE、DELETE 级别的 USING 和 WITH CHECK。这是内核级的多租户隔离方案。 |
无原生 RLS。要实现类似功能,通常需要借助视图(Views)、触发器(Triggers)或应用层代码,这增加了复杂度、维护成本和安全风险,无法做到对 SQL 完全透明。 | 这是 PG 在安全领域的一个决定性优势。对于需要在 DB 层实现数据隔离的 SaaS 应用,PG 的 RLS 是最佳选择。 |
| 审计能力 | pgaudit 扩展是事实标准,功能强大,提供基于类(READ/WRITE/DDL 等)和对象级的细粒度审计,日志结构丰富。 |
audit_log 插件(企业版或社区版 Percona/MariaDB)。MySQL 8.x 企业版才内置细粒度审计,社区版需借助第三方插件。 |
pgaudit 对所有 PG 用户免费、开放,是其生态完整性的一大体现。MySQL 的审计更像一个商业分层的功能,在生产中使用可能需要额外成本。 |
| SSL/TLS 证书管理 | 基于文件系统的管理 。通过 ssl_cert_file, ssl_key_file, ssl_ca_file 指向文件。pg_ctl reload 即可热加载新证书,实现零感知轮换。 |
基于文件系统+系统变量混合 。通过 ssl_cert, ssl_key, ssl_ca 等系统变量指定,但也可以 SET GLOBAL 动态重载部分文件,例如 ALTER INSTANCE RELOAD TLS。 |
理念相似,但 PG 的方法更 Unix 哲学,简单可靠,操作系统权限管理文件安全。MySQL 则提供了一条 SQL 命令来刷新 SSL 上下文,在某些自动化场景下可能更方便。 |
7. 面试高频专题
1. PostgreSQL 的 pg_hba.conf 是如何工作的?host 和 local 有什么不同?
- 一句话回答 :
pg_hba.conf是持有一个顺序规则集的基于主机的访问控制文件,Backend 进程按记录从上到下匹配;host用于 TCP/IP 连接,local用于 Unix 域套接字连接。 - 详细解释 :
pg_hba.conf是 PG 网络安全的闸门。local类型的连接发生在数据库服务器本机,通过 Unix Socket 文件通信,不经过 TCP/IP 栈,性能极高且天然隔离了远程攻击。其认证方法常用peer,即直接映射操作系统用户。host类型处理所有 TCP/IP 连接,是远程客户端接入的唯一方式。host可以升级为hostssl以强制加密。理解它们的区别是设计分区域的网络认证策略的前提。 - 多角度追问 :
- 如果一个连接同时匹配了两条规则,哪条生效?为什么?
hostssl+cert的组合与host+scram-sha-256在安全模型上有什么本质不同?- 如何配置
pg_hba.conf以允许某个特定 IP 的 DBA 无密码本地登录,而拒绝所有远程postgres用户的密码尝试?
- 加分回答 :可以提及
pg_hba.conf支持从pg_ident.conf进行用户名映射,实现操作系统用户到数据库用户的多对一或一对多映射,这对于统一企业内 UID 与数据库 ROLE 名不匹配的场景非常有用。
2. scram-sha-256 认证如何提供比 md5 或 password 更高的安全性?
- 一句话回答 :
scram-sha-256采用挑战/应答机制,密码从不以任何形式(明文或哈希)在网络上传输,并且服务器也能向客户端证明自己,提供了双向验证能力。 - 详细解释 :其安全性体现在三点:1) 网络不可见性 :
md5会泄露加盐哈希,可被暴力破解;password更是明文传输。而scram-sha-256传输的是通过复杂密码派生和随机数生成的ClientProof和ServerSignature,无法逆向出密码。2) 双向认证 :scram-sha-256能让客户端也验证服务器,从而防范中间人攻击。3) 存储安全 :服务端存储的verifier即使泄露,也不能被直接用来冒充客户端登录,因为冒充需要SaltedPassword,而从verifier计算SaltedPassword在计算上不可行。 - 多角度追问 :
- SCRAM 握手中
server-first-message包含哪些内容,各自作用是什么? - 如果现有系统用户密码都是
md5加密的,如何平滑迁移至scram-sha-256? scram-sha-256能防范重放攻击吗?原理是什么?
- SCRAM 握手中
- 加分回答 :PG 14 版本后,
scram-sha-256成为默认方法。迁移可通过ALTER ROLE ... PASSWORD ...让用户在下次登录时通过 MD5 验证后, PG 自动用 SCRAM-SHA-256 算法重新封装存储其新密码密文。PG 在pg_authid目录中会同时兼容存储多种加密格式的密文。
3. PostgreSQL SSL 单向认证和双向认证(mTLS)有什么区别?各自如何配置?
- 一句话回答 :单向认证(
verify-ca/full)是客户端验证服务器的身份;双向认证(cert方法)是服务器也验证客户端证书,将其 CN 作为数据库用户身份。 - 详细解释 :单向认证对应标准 TLS 握手,服务器出示证书,客户端用 CA 根证书验证,确保连接的是真实服务器,这是加密通信的基础。其配置核心是服务器端设置好
ssl_cert_file,客户端携带sslrootcert。双向认证则在服务器端指令ssl_ca_file后,额外的在 TLS 握手中要求客户端提供证书,并通过pg_hba.conf中cert方法集成。这完全消除了密码,证书即身份,是零信任架构的基石。 - 多角度追问 :
sslmode=require和verify-full在安全性上有多大差距?在理论上分别能防御什么攻击?- 在实施 mTLS 时,客户端证书的 CN 与数据库用户名不符怎么办?
pg_ident.conf起了什么作用? - 签发客户端和服务器证书的 CA 可以是同一个吗?在大型企业环境中,通常如何规划 CA 的多级信任链?
- 加分回答 :
pg_ident.conf在cert认证中充当核心的"映射者"角色。例如,证书 CN 可能是firstname.lastname,通过pg_ident.conf可以映射到数据库的简写flast,这种松耦合设计非常实用。
4. 什么是行级安全(RLS)?如何用 RLS 实现多租户数据隔离?
- 一句话回答 :RLS 是一种数据库内核级的授权机制,在表上定义
POLICY来过滤用户可访问的数据行;多租户隔离的核心是利用current_user或current_setting在策略中实现按tenant_id的过滤。 - 详细解释 :传统的
GRANT SELECT ON table权限是全有或全无的。RLS 在此之上叠加了"条件访问",策略的USING(tenant_id = current_user)会如同隐式 WHERE 子句一样加到所有查询上。它最大的价值在于将安全策略从应用代码下沉到数据库层,即使 DBA 不小心写错了应用逻辑,RLS 依然能作为最后防线防止跨租户的数据泄露。 - 多角度追问 :
- 如果一个表有多条策略,它们是 AND 还是 OR 的关系?
PERMISSIVE和RESTRICTIVE如何改变这个组合逻辑? - 表的所有者能否被 RLS 限制?如果不能,在多租户系统中如何管理表?
- 为什么 RLS 策略中使用的
tenant_id列一定要创建索引?
- 如果一个表有多条策略,它们是 AND 还是 OR 的关系?
- 加分回答 :RLS 的性能关键在于优化器。本质上,RLS 策略会增加查询的启动成本(startup cost),但与普通 WHERE 条件无本质差异。一个常见的陷阱是在
SECURITY DEFINER函数中访问 RLS 表,默认为 Bypass 状态,可能导致数据泄露,必须显式在函数内SET row_security = force。
5. PostgreSQL 的审计日志如何配置?log_statement 和 pgaudit 有什么功能差异?
- 一句话回答 :
log_statement是 PG 内置的粗粒度 SQL 记录功能,而pgaudit是功能更强的扩展,能提供基于事件类型、对象级的细粒度、结构化审计日志。 - 详细解释 :
log_statement = 'mod'只能告诉你一次 INSERT 发生了,但无法分辨是针对哪张表的哪个字段。pgaudit则可以精确审计所有对finances.accounts表balance列的UPDATE,并能统计影响行数。更重要的是,pgaudit输出的每一条审计记录都包含AUDIT:标识、审计类、对象名(完全限定)和完整的 SQL 文本,这对于法律取证至关重要。log_statement主要用于调试和一般的运维监控,而pgaudit用于安全审计和合规(如 SOX、PCI DSS)。 - 多角度追问 :
- 如何在
pgaudit中配置只审计某个特定用户的所有操作,而忽略其他用户? pgaudit.log_catalog这个参数的作用是什么?为什么生产环境通常建议关闭?- 如果
pgaudit产生的审计日志量过大,如何做日志的降噪或采样?
- 如何在
- 加分回答 :
pgaudit支持会话审计和对象审计。会话审计基于pgaudit.log参数,对会话中所有符合条件的操作生效。对象审计则通过GRANT/REVOKE和角色体系来更精细地控制,例如,只对auditor角色授予对敏感表的SELECT权限(但不希望其真正能查数据),同时开启对auditor的审计,就可以记录任何尝试读取该敏感表的行为,无论是否成功。
6. 如何排查 FATAL: no pg_hba.conf entry for host 这个错误?
- 一句话回答 :该错误表示客户端的连接请求没有命中
pg_hba.conf中的任何一条规则,需要按照"连接类型、数据库、用户、客户端 IP"四个维度逐一排查规则的匹配顺序。 - 详细解释 :排查步骤:1) 复现并确认错误信息中的主机、用户、数据库、是否加密等细节。2) 在服务器上打开
pg_hba.conf,从第一条规则开始,代入客户端参数,模拟向后端进程匹配逻辑。3) 常见原因包括:IP 网段写错(如 /24 写成 /32);TYPE 写为hostssl但客户端未开启 SSL;规则顺序错误,导致在匹配本应可用的规则前,先命中了另一条 DENY 或其他 METHOD 不匹配的规则。4) 修正后,务必通过pg_ctl reload触发生效,不需要重启。 - 多角度追问 :
- 如果错误信息是
no pg_hba.conf entry for host "::1"又该怎么办?这跟 IPv6 有什么关系? - 有什么快捷的 SQL 命令可以查看客户端 IP 正在匹配哪条
pg_hba.conf规则吗? - 在
pg_hba.conf规则的最后加一条host all all 0.0.0.0/0 reject是不是个好主意?
- 如果错误信息是
- 加分回答 :可以看到,PG 没有内置的动态视图来精确映射"一个IP会命中哪条规则"。一个高效的手工排查技巧是,在
pg_hba.conf中为不同网段暂时使用不同的认证方法(如一个用trust一个用reject),通过尝试连接看返回的错误是trust的成功还是reject的失败,来反向推断命中了哪条规则。但切勿将trust留在生产环境。
7. RLS 的 USING 和 WITH CHECK 子句分别控制什么?使用时需要注意什么?
- 一句话回答 :
USING控制"读"时哪些数据行可见,以及在更新/删除前要满足的条件;WITH CHECK控制"写"操作后,新生成的行必须满足的条件。 - 详细解释 :对于
INSERT操作,只有WITH CHECK会被检查,因为它只关乎新行的状态。对于DELETE,只有USING会被检查,因为它只关乎旧行的状态。对于UPDATE,情况最复杂:USING检查将被修改的旧行 是否允许被访问,而WITH CHECK检查生成的新行 是否满足策略。需要特别注意,如果 SQLUPDATE试图将某行从合法状态修改为非法状态,会因为WITH CHECK失败而整体回滚。另一个常见陷阱是,如果只为表创建了FOR SELECT USING策略,而没有FOR INSERT策略,用户将无法向该表插入数据,因为默认拒绝所有。 - 多角度追问 :
- 如果一条
UPDATE语句同时需要USING和WITH CHECK检查,它们各自的检查时机是在什么 MVCC 状态下? - 在创建策略时,什么情况下只需要
USING而不需要WITH CHECK? - 如果用户对一个表有
INSERT权限,但所有 RLS 策略都不允许插入,会立即报错吗?
- 如果一条
- 加分回答 :RLS 和 PG 的 MVCC 紧密结合(详见第6篇)。
USING的检查会在扫描可见的元组时进行,与普通的WHERE条件过滤一样。而WITH CHECK的检查则发生在ExecInsert或ExecUpdate的后期,新元组被提出后、实际写入堆和 WAL 之前。这保证了即使并发操作,也不会发生数据违反策略被持久化的情况。
8. SSL 握手失败时,如何诊断是客户端还是服务器端的证书配置问题?
- 一句话回答 :使用
openssl s_client -connect <host>:<port> -starttls postgres命令独立于应用程序进行 TLS 握手诊断,可以清晰区分出是服务器未提供有效证书,还是客户端不信任该证书。 - 详细解释 :此命令完美模拟了 PG 客户端的 SSL 请求与 TLS 握手全过程。它能展示服务器返回的完整证书链。如果命令能顺利建立起 TLS 隧道,并输出
Verify return code: 0 (ok),那问题基本在客户端配置(如 JDBC 未指定sslrootcert)。如果返回码非 0,例如 19 (self-signed certificate in certificate chain),那问题在于 PKI 信任链。如果握手直接失败,可能是服务器私钥不可访问(Permission denied)或ssl_cert_file与ssl_key_file不匹配。这是隔离 SSL/TLS 问题最高效的手段。 - 多角度追问 :
- 如果服务器端使用的是通配符证书(
*.mycompany.com),openssl s_client会如何显示 CN?这对于verify-full模式意味着什么? - 客户端报
ssl error: tlsv1 alert unknown ca是什么意思?根因通常在哪里? - 如何在 Java 应用中使用
keytool导入根证书到 JVM 的默认信任库,从而全局解决 SSL 验证问题?
- 如果服务器端使用的是通配符证书(
- 加分回答 :对于排查 mTLS 失败,可以在
openssl s_client命令中增加-cert和-key参数来模拟客户端发送证书。如果命令执行后能看到完整的双向 TLS 握手成功,那么问题肯定出在 JDBC 驱动配置或应用的证书文件路径上。
9. PostgreSQL 如何与企业的 LDAP/AD 集成进行认证?
- 一句话回答 :在
pg_hba.conf中将认证方法设置为ldap,并配置 LDAP 服务器地址、前缀、后缀,PG 即会通过绑定操作(simple bind)将用户认证转发给 LDAP/AD 服务器。 - 详细解释 :配置的核心是在
pg_hba.conf中。例如host all all 0.0.0.0/0 ldap ldapserver=ad.mycompany.com ldapprefix="uid=" ldapsuffix=",ou=people,dc=mycompany,dc=com"。当用户john登录时,PG 将尝试以 DNuid=john,ou=people,dc=mycompany,dc=com和用户提供的密码向 AD 服务器发起simple bind认证。优点十分突出:密码管理完全交给企业 IT,数据库运维团队无需触碰用户密码,天然支持集中式密码策略与过期、锁定等。缺点是需要 PG 服务器能与 AD 服务器稳定通信,且simple bind方式在某些高安全策略下可能被禁用。 - 多角度追问 :
ldapsearch命令在配置ldap认证前的测试中有多重要?典型用法是什么?- 如何实现基于 LDAP 组(group)的认证?
samerole在这里能起作用吗? - 当 LDAP 服务器宕机时,PG 的连接会发生什么?如何设计一个后备认证方案?
- 加分回答 :虽然
pg_hba.conf支持多种 LDAP 参数,但其simple bind模式只是一个基础方案。对于更复杂的场景,如需要 Kerberos/SSPI 单点登录,PG 本身就支持 GSSAPI 认证,那是与企业 AD 域更深度的集成方式,可以实现用户无密码登录。
10. RLS 策略中的 current_user 和 current_setting 是如何提供多租户隔离的?
- 一句话回答 :它们都是动态上下文信息,
current_user反映当前连接的数据库角色,适用于为每个租户创建独立 DB 用户;current_setting读取运行时参数,适用于共享 DB 用户、但由应用设置标识的场景。 - 详细解释 :
current_user是安全的基石。如果你为每个租户创建了一个 DB 用户(如t_a_user),RLS 策略USING(tenant_id = current_user)就直接将数据库身份与数据隔离绑定,无法篡改。current_setting则更为灵活,它允许应用通过SET命令或 JDBC 连接参数(options=-c app.tenant_id=123)来传递上下文。这使得你可以在一个共享的数据库用户下服务多个租户。但代价是安全完全取决于应用层的 SET 操作不被用户注入或篡改。 - 多角度追问 :
- 使用
current_setting是否有被 SQL 注入的风险? - 如何通过
ALTER ROLE ... SET为每个用户预先定义一个不可变的租户上下文? - 在什么场景下,混合使用这两种方式是合理的?
- 使用
- 加分回答 :一个进阶的安全实践是利用 PG 的自定义 GUC 参数类,它允许你定义一套与应用业务相关的、带命名空间的参数。例如,创建一个参数
myapp.tenant,并用 PL/pgSQL 或初始化脚本限制其只能由超级用户或特定的高权限角色修改,这就为current_setting模式增加了一道防御,使其变的不那么容易被注入。
11. 如何在不重启 PostgreSQL 的情况下更新 SSL 证书?
- 一句话回答 :替换数据目录下的证书和私钥文件后,执行
pg_ctl reload或SELECT pg_reload_conf(),PG 主进程收到 SIGHUP 信号后会自动重载证书,新连接使用新证书,旧连接不受影响。 - 详细解释 :这是 PG 运维友好性的体现之一。整个过程极为平滑:1) 首先生成并替换
server.crt和server.key文件,确保新文件的权限(0600)和属主(postgres)正确。2) 执行pg_ctl reload。这个操作并不打断任何已有的查询或事务,它是一个软重载。Postmaster 在处理新连接时,会重新打开并读取证书文件,完成无缝切换。这为证书的自动化短期轮换提供了可能,可以将其集成到 CI/CD Pipeline 或 Cron 任务中,免除了计划性停机的烦恼。 - 多角度追问 :
pg_ctl reload和SELECT pg_reload_conf()在效果上完全等价吗?- 如果替换了错误的证书,现有连接会断吗?如何验证新证书是否已生效?
pg_hba.conf也可以用reload方式热加载吗?这在规则变更时有什么注意事项?
- 加分回答 :虽然 SSL 证书可以热加载,但
shared_preload_libraries,ssl本身的开启,或者ssl_ca_file等核心路径的变更,仍然需要重启数据库服务。对这种需要重启的场景,可以将其与大版本升级、或与流复制中计划内的主备切换(switchover,见第 11 篇)结合进行,以最大限度减少对业务的影响。
12. (系统设计题)为一个 SaaS 多租户平台设计数据安全方案,要求:① 每个租户的数据在逻辑上完全隔离;② 所有敏感操作需留下审计轨迹;③ 数据传输全程加密。请结合 PG 的 RLS、pgaudit、SSL 等能力设计安全架构。
- 一句话回答 :通过
ssl=verify-full双向认证(mTLS)确保传输加密与身份双强验证;通过为每个租户创建独立数据库用户并用 RLS 实现数据行级隔离;通过pgaudit开启对所有WRITE和DDL在敏感表上的全操作审计,并将日志集中至 ELK。 - 详细解释 :
- 数据传输加密(Layer 2) :数据库服务器强制使用
hostssl。应用所有微服务与数据库建立连接时,统一切换至sslmode=verify-ca或verify-full,确保数据传输不被窃听。在服务网格内部,采用 mTLS,使用cert认证,淘汰密码,实现零信任。 - 多租户数据隔离(Layer 3) :不采用共享用户 +
current_setting模式,因其应用层安全风险高。采用独立的数据库用户(CREATE ROLE tenant_<id>_user)。在业务表(orders,projects)上启用 RLS,并创建策略USING (tenant_id = current_user)。租户用户的访问被牢牢限制在数据库内核层,即使应用 SQL 注入或代码缺陷,也无法越权访问其他租户数据。租户 ID 列必须设置索引。 - 审计日志(Layer 4) :部署并配置
pgaudit,pgaudit.log = 'write, ddl, role',记录所有数据变更和架构变更。通过pgaudit的对象审计,专门监控对所有包含 PII(个人身份信息,如address,phone)表的所有READ操作,以满足 GDPR/数据安全法的事后审查要求。 - 日志集中:使用 Fluentd 采集 PG 的 CSV 日志,统一发送到 Kafka,再入 ElasticSearch。通过 Kibana 构建多种安全仪表盘,例如"非工作时间敏感表访问","短时间内同一用户多 IP 连接尝试","连续 DDL 操作"等,并对这些事件建立告警。
- 数据传输加密(Layer 2) :数据库服务器强制使用
- 多角度追问 :
- 在微服务架构中,
cert认证的一个证书泄露了如何应急响应?PG 的 CRL(证书吊销列表)如何配置? - 如果这个 SaaS 平台的一个租户数据量极大,为其单独分库(Database-per-tenant)和共享库+RLS 的优劣对比是什么?
- 如何设计一个流程让租户的管理员能够安全地自助下载其专属的审计日志?
- 在微服务架构中,
- 加分回答 :在设计上,可以结合 PG 的分区表(Partitioning)。如果业务表按
tenant_id进行了 HASH 或者 LIST 分区,那么一个租户的 RLS 过滤查询,在规划器作用下,可以直接通过分区裁剪(Partition Pruning)只访问其所在的那个物理分区,从而将逻辑隔离与物理隔离的优势结合,实现性能和安全性的极致升华。
PG 安全配置速查表
| 安全层 | 核心参数 / 命令 | 作用 | 适用场景 | 注意事项 |
|---|---|---|---|---|
| 认证 | pg_hba.conf |
基于主机、用户、数据库的访问控制 | 所有环境,安全基石 | 规则顺序从上到下,匹配即停。修改后 pg_ctl reload。 |
scram-sha-256 |
安全密码挑战/应答认证 | 密码认证通用场景 | 需要客户端支持,PG 14+ 默认。 | |
cert |
基于 TLS 客户端证书的认证 | mTLS、零信任微服务 | 需要 PKI,证书 CN 需与用户映射。 | |
peer |
OS 用户直接映射为 DB 用户 | 本地高安全脚本、Unix Socket 连接 | 仅限本地连接。 | |
ldap |
集成企业 AD/LDAP 认证 | 有统一身份认证源的企业 | 需确保 PG 主机到 LDAP 的网络通畅。 | |
passwordcheck |
强制密码复杂度 | 所有使用密码的环境 | 作为 shared_preload_libraries 加载。 |
|
auth_delay |
认证失败后暂停响应 | 防止在线暴力破解 | 暂停时间(ms)越长,对正常用户影响越大。 | |
| 传输加密 | ssl = on, ssl_cert_file... |
启用 TLS 加密传输 | 生产环境必备 | 私钥权限 0600,属主 postgres。 |
sslmode=verify-full |
客户端要求加密并验证服务器 CN | 最强客户端 SSL 安全要求 | 需正确部署根证书到客户端。 | |
openssl s_client -starttls postgres |
诊断 TLS 握手问题 | SSL 故障排查的终极武器 | 快速判断是客户端还是服务器端问题。 | |
pg_ctl reload |
热重载证书 | SSL 证书轮换 | 不可重载 shared_preload_libraries,那需要重启。 |
|
| 行级安全 | ALTER TABLE ... ENABLE ROW LEVEL SECURITY |
开启表的 RLS(默拒) | 多租户数据隔离、细粒度授权 | 表 owner 和 BYPASSRLS 用户不受限。 |
CREATE POLICY ... USING |
定义行读取和更新/删除前的过滤规则 | 多租户查询隔离、隐藏软删除数据 | 为 USING 中使用的列创建索引。 |
|
CREATE POLICY ... WITH CHECK |
定义行插入和更新后的校验规则 | 确保写入的数据也符合隔离原则 | 对 UPDATE 操作,新旧行都需满足各自的策略。 | |
current_user / current_setting |
提供动态会话上下文给 RLS 策略 | current_user 隔离租户,current_setting 透传应用上下文 |
current_setting 有被篡改风险,需上层应用确保安全。 |
|
| 审计 | log_statement = 'mod' |
内置功能,粗粒度记录 DDL 和写 SQL | 日常运维监控、慢查询分析 | 日志量较大,无法识别具体对象和上下文。 |
pgaudit.log = 'write, ddl' |
细粒度事件类审计 | 安全合规、数据操作追溯 | 需作为扩展安装和加载。 | |
log_destination = 'csvlog' |
设置日志为 CSV 格式 | 便于 Filebeat 等工具解析上送 | 结构化,是集中式日志平台的标准数据入口。 |