服务注册与分布式协调 / 系统课时
权限与传输安全接入
权限与传输安全接入
本课解决客户端可以越权访问节点、敏感数据可能被明文传输的问题。你将为业务路径配置独立身份和 ACL,并使用 TLS 保护客户端到服务器的连接,形成可验证的最小权限接入方案。
学习目标
- 理解认证、ACL 与 TLS 的职责边界
- 掌握为业务路径设置最小权限的方法
- 能够验证未认证访问和 TLS 连接结果
ACL 控制哪些操作
ZooKeeper ACL 由认证方案、身份和权限组成。常用权限包括创建子节点 c、删除子节点 d、读取 r、写入 w 和管理 ACL a。生产环境应让应用只访问自己的路径,并为运维操作使用单独身份。
ACL 绑定在具体 ZNode 上,不会像文件系统目录权限那样自动继承给所有后代。因此,创建子节点时也要显式使用正确 ACL,不能只保护父路径。
主示例:限制业务路径访问
下面以 digest 认证保护测试路径 /pay。请先把 <PASSWORD> 替换为测试密码,并避免在终端历史、脚本仓库或日志中保存生产凭据。
bin/zkCli.sh -server 127.0.0.1:2181 <<'EOF'
addauth digest appUser:<PASSWORD>
create /pay "v1"
setAcl /pay auth:appUser:<PASSWORD>:cdrwa
getAcl /pay
quit
EOF预期输出
Authentication successful
Created /pay
'digest,'appUser:<HASH>
: cdrwa<HASH> 是服务端保存的摘要,实际内容会不同,命令行还可能输出节点版本等附加信息。重新打开一个未执行 addauth 的客户端读取该节点,可验证 ACL 是否生效。
printf 'get /pay\nquit\n' | \
bin/zkCli.sh -server 127.0.0.1:2181预期输出
KeeperErrorCode = NoAuth for /payTLS 保护传输链路
ACL 决定已连接客户端能做什么,TLS 负责加密链路并校验证书。下面是启用安全客户端端口和双向 TLS 的服务器配置示例;证书路径与密码需要按实际环境替换。
serverCnxnFactory=org.apache.zookeeper.server.NettyServerCnxnFactory
secureClientPort=2281
ssl.keyStore.location=<PATH>/server.p12
ssl.keyStore.password=<PASSWORD>
ssl.keyStore.type=PKCS12
ssl.trustStore.location=<PATH>/server-truststore.p12
ssl.trustStore.password=<PASSWORD>
ssl.trustStore.type=PKCS12
ssl.clientAuth=need该配置生效后,服务器在 2281 接受 TLS 客户端。迁移阶段可以暂时同时保留明文 clientPort 和 secureClientPort;完成切换后应关闭不再需要的明文端口。
客户端连接时需要启用 Netty 安全套接字,并提供自己的密钥库和信任库。
CLIENT_JVMFLAGS="\
-Dzookeeper.clientCnxnSocket=org.apache.zookeeper.ClientCnxnSocketNetty \
-Dzookeeper.client.secure=true \
-Dzookeeper.ssl.keyStore.location=<PATH>/client.p12 \
-Dzookeeper.ssl.keyStore.password=<PASSWORD> \
-Dzookeeper.ssl.keyStore.type=PKCS12 \
-Dzookeeper.ssl.trustStore.location=<PATH>/client-truststore.p12 \
-Dzookeeper.ssl.trustStore.password=<PASSWORD> \
-Dzookeeper.ssl.trustStore.type=PKCS12" \
bin/zkCli.sh -server zk1.example.com:2281预期输出
Welcome to ZooKeeper!
WatchedEvent state:SyncConnected不同版本的连接日志格式可能不同,验收重点是客户端进入 SyncConnected,服务器日志没有证书校验失败,并且使用错误信任库时连接会被拒绝。
最小权限与运维边界
认证信息、密钥库密码和私钥应由密钥管理系统或受控配置注入,不要硬编码在应用包中。证书应包含客户端实际连接的主机名,并在到期前完成轮换演练。
不要把 ACL 和 TLS 当成相互替代的能力:只有 TLS 而没有 ACL,合法客户端仍可能越权;只有 ACL 而没有 TLS,认证信息和业务数据仍可能暴露在传输链路上。修改已有路径 ACL 前还要保留可恢复的管理身份,避免把运维账号一并锁在路径之外。
本课总结
- 认证确认客户端身份,ACL 控制节点操作,TLS 加密并校验传输双方。
- ACL 不自动继承,创建业务子节点时必须继续应用正确权限。
- 安全接入应使用独立身份、受控密钥和可验证的证书轮换流程。
下一课预告
下一课将建立 ZooKeeper 监控基线,并通过可回滚的节点故障演练验证告警、选主和客户端恢复能力。