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

构建认证授权加密检查表

构建认证授权加密检查表

本节把 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 天。

bash
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

预期输出

text
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 只保留监控真正需要的命令,绝不能为了排障方便长期使用 *。

一份可执行的检查表最终应做到:每个控制项都有负责人、验证命令或操作、可保存的证据以及明确失败标准。只要任一敏感路径越权成功、任一关键链路回落明文,或证书身份无法正确校验,就应阻断上线而不是带风险发布。

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

目录与阅读设置

阅读设置

17

记录一个想法

构建认证授权加密检查表

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

登录哪都通