服务注册与分布式协调 / 系统课时

建立变更前安全检查基线

建立变更前安全检查基线

安全加固最危险的不是配置写错,而是改完以后无法判断哪些行为发生了变化。本节在任何认证、ACL 或 TLS 修改之前记录端口、关键配置、ACL 与文件指纹,形成可重复采集的基线,让后续每一步都能对比影响并保留回滚依据。

学习目标

  • 采集 ZooKeeper 当前监听端口、认证配置、TLS 配置和关键 ACL 状态。
  • 保存配置副本与校验值,同时避免把密码等敏感字段直接写进检查记录。
  • 建立变更前后使用同一顺序验证的安全检查表。

明确要记录的安全状态

基线不追求把整台服务器所有信息都归档,而是保留能回答“加固前是什么状态”的证据。对 ZooKeeper 安全改造而言,至少需要覆盖以下五类信息。

检查项 要回答的问题 主要证据
监听端口 哪些客户端和 Quorum 端口正在监听 ss 输出
ACL 关键 znode 当前允许哪些身份执行哪些权限 getAcl 结果
认证 是否配置认证 Provider、强制认证或 Quorum 认证 zoo.cfg 安全项
TLS 是否存在安全客户端端口、sslQuorum 与相关 TLS 配置 配置项与监听状态
配置版本 变更前究竟使用哪份配置 配置副本与 SHA-256

ACL 不应只检查根节点。根节点 ACL 很宽松并不能证明业务 znode 同样宽松,反之亦然。应提前列出真正需要保护的路径,例如配置目录、服务注册目录或管理节点,并分别保存它们的 getAcl 结果。

一次性采集服务器基线

下面脚本默认 ZooKeeper 安装在 /opt/zookeeper,连接本机 2181。如果环境不同,可在执行前通过 ZK_HOME 和 ZK_SERVER 环境变量覆盖。脚本会创建带时间戳的独立目录,并对可能包含密码、Secret 或 superDigest 的配置行做脱敏。

bash
set -euo pipefail

ZK_HOME="${ZK_HOME:-/opt/zookeeper}"
ZK_SERVER="${ZK_SERVER:-127.0.0.1:2181}"
STAMP="$(date +%Y%m%d-%H%M%S)"
OUT="zk-security-baseline-${STAMP}"

mkdir -p "${OUT}"
chmod 700 "${OUT}"

cp "${ZK_HOME}/conf/zoo.cfg" "${OUT}/zoo.cfg.before"
sha256sum "${OUT}/zoo.cfg.before" | tee "${OUT}/zoo.cfg.sha256"

ss -lntp | tee "${OUT}/listeners.txt"

grep -E '^(clientPort|secureClientPort|serverCnxnFactory|sslQuorum|ssl\.|ssl\.quorum\.|authProvider\.|requireClientAuthScheme|quorum\.auth\.)' \
  "${ZK_HOME}/conf/zoo.cfg" \
  | sed -E 's/^([^=]*(password|passwd|secret|superDigest)[^=]*)=.*/\1=<REDACTED>/I' \
  | tee "${OUT}/security-config.txt" || true

printf 'getAcl /\nquit\n' \
  | "${ZK_HOME}/bin/zkCli.sh" -server "${ZK_SERVER}" \
  > "${OUT}/root-acl.txt"

printf 'baseline=%s\n' "${OUT}"

预期结果:实际监听内容与配置值因环境而异,但命令成功后应看到配置哈希、当前 socket 与安全相关配置,并得到一个新的基线目录。

text
<HASH>  zk-security-baseline-<TIME>/zoo.cfg.before
<LISTENING_SOCKETS>
<SECURITY_CONFIG_LINES>
baseline=zk-security-baseline-<TIME>

<TIME>、<HASH> 与监听地址都是动态值。还应确认目录中实际存在 zoo.cfg.before、zoo.cfg.sha256、listeners.txt、security-config.txt 和 root-acl.txt。如果 zkCli.sh 无法连接,应先解决当前客户端连接问题,而不是在缺少 ACL 基线时继续修改安全配置。

补齐关键 znode 的 ACL 记录

根节点只是起点。对每个关键 znode,都应使用 ZooKeeper CLI 的 getAcl 获取当前 ACL,并把结果保存到基线目录。记录时至少关注 Scheme、ID 和权限集合;cdrwa 分别对应 create、delete、read、write、admin 权限,后续收紧 ACL 时需要能够逐项比较。

如果计划修改 ACL,应在动手前保留一个已经验证可用的管理身份,并记录原 ACL。配置文件副本可以直接帮助回滚服务器参数,但 ACL 修改写入 ZooKeeper 数据树后不会因为恢复 zoo.cfg 自动回退,必须使用仍有 admin 权限的身份重新执行相应的 setAcl。

把基线变成变更检查表

每次安全调整只改变一个主要变量,然后使用相同顺序重新采集证据。这样发生连接失败时,可以快速判断问题来自端口、认证、ACL 还是 TLS,而不是同时猜测多个方向。

项目 变更前必须记录 变更后通过条件 回滚依据
客户端端口 明文与安全端口监听情况 目标端口按设计监听 原 zoo.cfg
认证 Provider 与强制认证设置 预期身份能认证,未授权身份被拒绝 原配置与管理身份
ACL 关键路径原 ACL 授权操作成功,越权操作失败 原 ACL 文本
客户端 TLS secureClientPort 与 SSL 配置 TLS 端口可完成预期握手 原配置与证书材料
Quorum TLS sslQuorum 和相关配置 集群成员可正常建立 Quorum 连接 原配置与节点证书

sslQuorum=true 只能证明配置意图,不能单独证明节点间已经成功使用 TLS;同样,看到安全端口监听也不代表证书名称和信任链一定正确。真正启用这些能力后,还需要分别执行握手和集群健康验证。本节的基线负责保存“改变之前”的状态,后续验证负责证明“改变之后”确实按预期工作。

按固定顺序决定是否继续下一步

安全加固过程中建议始终按同一顺序检查:先确认进程和端口仍正常,再确认服务端配置已加载,然后验证管理身份仍可连接,接着验证 ACL,最后检查 TLS 或 Quorum 行为。只要其中一项异常,就先停止继续叠加修改并对照最近一次基线。

一份可用的安全基线最终应能回答三个问题:原配置是什么、原访问权限是什么、修改后究竟改变了什么。 做到这一点,认证、ACL 与 TLS 加固就不再是一次难以追踪的整体切换,而能被拆成可验证、可比较、可回退的连续变更。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

建立变更前安全检查基线

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通