服务注册与分布式协调 / 系统课时
构建认证授权加密检查表
构建认证授权加密检查表
本节把 ZooKeeper 上线前的安全配置收敛成可执行检查表:不只确认“配置存在”,而是为客户端端口、认证 scheme、ACL、证书链、主机名校验、Quorum TLS 和管理入口分别定义验证动作与失败标准,形成可复核的上线证据。
学习目标
- 建立覆盖认证、授权、传输加密和管理面的生产检查表。
- 为每项控制定义“怎么验证”和“什么情况必须阻断上线”。
- 用脚本完成快速基线检查,再补齐 ACL 与运行态验证。
先定义统一的失败标准
安全检查最容易失效的地方,是把“配置文件里有这一行”当成通过。上线门禁应以运行结果为准:未授权身份不能访问敏感 znode,TLS 必须完成证书与主机名校验,Quorum 通信不能回落到明文,管理入口不能暴露到非管理网络。
对于有意保留的例外,例如迁移期同时开放明文 clientPort,必须有负责人、结束日期和网络隔离证据;否则应直接按失败处理,而不是在检查表里写“已知风险”后继续上线。
按控制面逐项验收
| 控制项 | 验证方法 | 通过标准 | 失败标准 |
|---|---|---|---|
| 客户端端口 | 检查监听端口并从业务网段执行 TLS 握手 | 业务只使用 secureClientPort;若无迁移需求则不开放 clientPort |
明文端口对业务网段可达,或 TLS 端口未监听 |
| 认证 scheme | 检查实际启用的认证提供者,并分别用合法与非法身份建立会话 | 只启用业务需要的 x509、sasl 等 scheme,非法身份不能获得受保护权限 |
存在未使用的弱认证入口,或匿名会话获得敏感权限 |
| ACL | 在受控客户端执行 getAcl,再用无权限身份实际读写关键路径 |
敏感 znode 只授予明确主体和最小权限 | 出现不必要的 world:anyone 写权限,或越权读写成功 |
| 证书链 | 用 openssl verify、keytool -list 或等价工具检查叶子证书、中间 CA 和根 CA |
链完整、用途正确、未过期,并留有轮换窗口 | 链构建失败、证书过期、EKU 不符或私钥与证书不匹配 |
| 主机名校验 | 检查 ssl.hostnameVerification 与 ssl.quorum.hostnameVerification,并以真实主机名握手 |
两类校验均开启,证书 SAN 覆盖实际连接名 | 任一校验关闭,或 SAN 与连接目标不匹配 |
| Quorum TLS | 检查 sslQuorum,并在每个成员上确认节点间新连接建立为 TLS |
所有参与者都使用 TLS,迁移完成后不再依赖端口统一回退 | 任一节点仍以明文加入 quorum,或只有部分节点启用 |
| 管理入口 | 检查 AdminServer 绑定地址、HTTPS、客户端认证和 4LW 白名单 | AdminServer 禁用或仅绑定管理网;需要暴露时使用受控 HTTPS;4LW 最小白名单 | 监听 0.0.0.0 且无网络隔离、允许 HTTP 管理,或 4lw.commands.whitelist=* |
表格里的“通过标准”应形成证据,例如命令输出、配置快照、TLS 握手结果和 ACL 结果。没有证据的勾选项只代表人工判断,不能替代上线门禁。
用脚本做快速基线检查
下面脚本给出一个 TLS-only 生产基线示例。它要求显式配置双向 TLS、主机名校验和 Quorum TLS,并拒绝明文客户端端口与 4LW 通配符。CERT 指向从实际部署证书导出的 PEM 文件,用于检查剩余有效期至少 30 天。
set -u
CFG="<PATH>/zoo.cfg"
CERT="<PATH>/server.pem"
failed=0
value_of() {
awk -F= -v key="$1" '
{
k=$1
gsub(/^[[:space:]]+|[[:space:]]+$/, "", k)
if (k == key) {
v=substr($0, index($0, "=") + 1)
gsub(/^[[:space:]]+|[[:space:]]+$/, "", v)
print v
}
}
' "${CFG}" | tail -n1
}
pass() { printf 'PASS %s\n' "$1"; }
fail() { printf 'FAIL %s\n' "$1"; failed=1; }
expect_eq() {
local key="$1" expected="$2"
local actual
actual="$(value_of "${key}")"
if [ "${actual}" = "${expected}" ]; then
pass "${key}=${expected}"
else
fail "${key} expected ${expected}, got ${actual:-<unset>}"
fi
}
if [ -n "$(value_of secureClientPort)" ]; then
pass "secureClientPort configured"
else
fail "secureClientPort missing"
fi
if [ -z "$(value_of clientPort)" ]; then
pass "clientPort disabled"
else
fail "clientPort still configured"
fi
expect_eq "ssl.clientAuth" "need"
expect_eq "ssl.hostnameVerification" "true"
expect_eq "sslQuorum" "true"
expect_eq "ssl.quorum.hostnameVerification" "true"
if [ "$(value_of 4lw.commands.whitelist)" = "*" ]; then
fail "4lw wildcard enabled"
else
pass "4lw wildcard disabled"
fi
if openssl x509 -in "${CERT}" -noout -checkend 2592000 >/dev/null 2>&1; then
pass "certificate valid for more than 30 days"
else
fail "certificate expires within 30 days or cannot be read"
fi
if [ "${failed}" -eq 0 ]; then
echo "AUDIT_PASS"
else
echo "AUDIT_FAIL"
exit 1
fi预期输出
PASS secureClientPort configured
PASS clientPort disabled
PASS ssl.clientAuth=need
PASS ssl.hostnameVerification=true
PASS sslQuorum=true
PASS ssl.quorum.hostnameVerification=true
PASS 4lw wildcard disabled
PASS certificate valid for more than 30 days
AUDIT_PASS如果你的迁移策略明确允许双端口共存,应把 clientPort disabled 改成“明文端口仅绑定隔离地址且有关闭日期”,不要为了让脚本变绿而隐藏例外。
补齐脚本无法替代的运行态证据
配置扫描无法证明 ACL 真正阻止了越权,也无法证明每个 Quorum 成员都在使用 TLS。上线前至少再做两类反向测试:用无权限身份访问一个敏感 znode,确认返回 NoAuth;再让每个节点至少建立一次新的 Quorum 连接,确认没有明文回退。
AdminServer 也要单独验证。若不需要管理 HTTP 接口,直接关闭比“开放后再靠外围防火墙保护”更简单;若必须开放,应绑定管理地址并启用 HTTPS,必要时要求客户端证书。4LW 只保留监控真正需要的命令,绝不能为了排障方便长期使用 *。
一份可执行的检查表最终应做到:每个控制项都有负责人、验证命令或操作、可保存的证据以及明确失败标准。只要任一敏感路径越权成功、任一关键链路回落明文,或证书身份无法正确校验,就应阻断上线而不是带风险发布。