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

用 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> 替换为实际值。

bash
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"

预期输出(连接日志可能随版本不同):

text
reader=HqhYXE+KvxxWmRFlw1bCVgKovzc=
writer=TChGYwiNbw0Oy6ebOlrKGhy5l5c=
Created /digest-demo

如果目标节点已经存在并且 ACL 已收紧,就不能靠普通会话直接重写 ACL;需要先用具有 a 权限的身份认证,再执行 setAcl。

验证读账户只能读取

读账户先加入正确的 Digest 凭据,然后读取并尝试修改数据:

bash
{
  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>"

预期输出中的关键业务结果:

text
v1
KeeperErrorCode = NoAuth for /digest-demo

第一次读取成功说明 r 生效;随后修改被拒绝说明没有因为“已认证”就自动获得写权限。认证只确定会话身份,最终是否允许操作仍由 ACL 权限位决定。

验证写账户与错误身份

写账户具有 rw,因此可以修改后再读取新值:

bash
{
  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>"

预期输出中的关键结果是最终读取到新值:

text
v2

再开一个新会话,分别加入错误密码和一个未出现在 ACL 中的账户。Digest provider 会把它们视为不同身份,但都没有匹配 /digest-demo 的 ACL:

bash
{
  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>"

预期输出:

text
KeeperErrorCode = NoAuth for /digest-demo
KeeperErrorCode = NoAuth for /digest-demo

当权限设计从“某个网段都能访问”提升为“具体业务身份只能做必要操作”时,Digest ACL 能提供清晰的读写边界;再与 TLS 和网络来源限制组合,才形成更完整的访问控制链。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 Digest ACL 隔离业务读写

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

登录哪都通