服务注册与分布式协调 / 系统课时
用 Digest ACL 隔离业务读写
用 Digest ACL 隔离业务读写
本课为读账户和写账户分别生成 Digest 身份,把同一个 znode 配成“读者只读、写者可读写”,并用正确凭据、错误密码和未授权账户逐一验证。最终你会掌握 Digest ACL 的身份格式、权限拆分和拒绝行为。
学习目标
- 能生成
username:Base64(SHA1(username:password))形式的 Digest ACL 身份。 - 能为不同业务账户配置
r与rw的差异化权限。 - 能验证合法账户、错误凭据和其他账户的授权结果。
Digest ACL 如何绑定身份
Digest 认证时,客户端通过 addauth digest username:password 向会话加入身份;ACL 中保存的不是明文密码,而是用户名与摘要组成的 ID。只有当前会话计算出的身份与 ACL 条目匹配,ZooKeeper 才继续检查该条目后的权限位。
本课使用两条 ACL:
| 账户 | ACL 权限 | 允许操作 |
|---|---|---|
reader |
r |
读取节点数据 |
writer |
rw |
读取并修改节点数据 |
w 只代表修改目标节点数据;创建或删除子节点还需要父节点上的 c 或 d,管理 ACL 则需要 a。按业务动作逐项授权,比直接使用 cdrwa 更符合最小权限原则。
生成 Digest 身份并创建受控节点
下面脚本用 Python 标准库按 ZooKeeper Digest ACL 的规则计算摘要,然后在创建 /digest-demo 时直接写入两条 ACL,避免先以开放 ACL 暴露节点。<HOST>、<PORT> 替换为实际值。
ZK_SERVER="<HOST>:<PORT>"
READER_DIGEST=$(python3 -c 'import base64,hashlib; print(base64.b64encode(hashlib.sha1(b"reader:reader-pass").digest()).decode())')
WRITER_DIGEST=$(python3 -c 'import base64,hashlib; print(base64.b64encode(hashlib.sha1(b"writer:writer-pass").digest()).decode())')
printf 'reader=%s\nwriter=%s\n' "$READER_DIGEST" "$WRITER_DIGEST"
ACL="digest:reader:${READER_DIGEST}:r,digest:writer:${WRITER_DIGEST}:rw"
printf 'create /digest-demo "v1" %s\nquit\n' "$ACL" | bin/zkCli.sh -server "$ZK_SERVER"预期输出(连接日志可能随版本不同):
reader=HqhYXE+KvxxWmRFlw1bCVgKovzc=
writer=TChGYwiNbw0Oy6ebOlrKGhy5l5c=
Created /digest-demo如果目标节点已经存在并且 ACL 已收紧,就不能靠普通会话直接重写 ACL;需要先用具有 a 权限的身份认证,再执行 setAcl。
验证读账户只能读取
读账户先加入正确的 Digest 凭据,然后读取并尝试修改数据:
{
printf 'addauth digest reader:reader-pass\n'
printf 'get /digest-demo\n'
printf 'set /digest-demo "reader-change"\n'
printf 'quit\n'
} | bin/zkCli.sh -server "<HOST>:<PORT>"预期输出中的关键业务结果:
v1
KeeperErrorCode = NoAuth for /digest-demo第一次读取成功说明 r 生效;随后修改被拒绝说明没有因为“已认证”就自动获得写权限。认证只确定会话身份,最终是否允许操作仍由 ACL 权限位决定。
验证写账户与错误身份
写账户具有 rw,因此可以修改后再读取新值:
{
printf 'addauth digest writer:writer-pass\n'
printf 'set /digest-demo "v2"\n'
printf 'get /digest-demo\n'
printf 'quit\n'
} | bin/zkCli.sh -server "<HOST>:<PORT>"预期输出中的关键结果是最终读取到新值:
v2再开一个新会话,分别加入错误密码和一个未出现在 ACL 中的账户。Digest provider 会把它们视为不同身份,但都没有匹配 /digest-demo 的 ACL:
{
printf 'addauth digest reader:wrong-pass\n'
printf 'get /digest-demo\n'
printf 'addauth digest auditor:auditor-pass\n'
printf 'get /digest-demo\n'
printf 'quit\n'
} | bin/zkCli.sh -server "<HOST>:<PORT>"预期输出:
KeeperErrorCode = NoAuth for /digest-demo
KeeperErrorCode = NoAuth for /digest-demo当权限设计从“某个网段都能访问”提升为“具体业务身份只能做必要操作”时,Digest ACL 能提供清晰的读写边界;再与 TLS 和网络来源限制组合,才形成更完整的访问控制链。