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

Digest 认证实践

Digest 认证实践

本课完成一套可复现的 Digest 认证流程:生成身份摘要、在 CLI 中认证、创建受保护节点,并用新会话验证未认证访问失败。最终你会得到一个仅指定应用身份可读写的节点。

学习目标

  • 生成 ZooKeeper Digest ACL 所需的身份摘要
  • 使用 addauth 和显式 ACL 创建受保护节点
  • 验证认证成功、未认证和权限不足三种结果

生成 Digest 身份

Digest ACL 的身份格式为 用户名:BASE64(SHA1(用户名:口令))。下面使用 OpenSSL 生成摘要,<PASSWORD> 应替换为实际口令,命令历史中不要保留生产凭据。

bash
printf '%s' 'order-app:<PASSWORD>' | openssl dgst -binary -sha1 | openssl base64

预期输出:

text
<BASE64_SHA1>

最终 ACL 身份写成 order-app:<BASE64_SHA1>。摘要不是加密后的口令,仍应按敏感凭据处理,避免出现在日志、工单和代码仓库中。

创建受保护节点

连接 ZooKeeper CLI 后先提交原始用户名和口令完成认证,再创建节点。ACL 中使用摘要身份,并只授予 READ 与 WRITE。

text
addauth digest order-app:<PASSWORD>
create /apps/order "enabled" digest:order-app:<BASE64_SHA1>:rw
getAcl /apps/order
get /apps/order

预期结果:

text
digest:order-app:<BASE64_SHA1>
: rw
enabled

若 /apps 尚不存在,应由管理员提前创建并授予调用方必要的 CREATE 权限。当前节点只有 rw,因此该身份不能在其下面创建子节点,也不能修改 ACL。

验证未认证访问

退出 CLI,重新建立一个没有执行 addauth 的会话,然后读取节点。

text
get /apps/order

预期输出:

text
Authentication is not valid : /apps/order

再次执行认证后读取:

text
addauth digest order-app:<PASSWORD>
get /apps/order

预期输出:

text
enabled

会话重连与应用接入

addauth 只对当前 ZooKeeper 会话生效。应用连接重建后,客户端库必须再次提交认证信息;不能假设旧会话的身份会自动带到新连接。连接池或封装组件应把认证步骤放在创建客户端的统一入口。

生产应用还应区分“认证失败”和“无权限”。前者通常表示凭据错误、认证未执行或会话已重建;后者表示身份有效但 ACL 不允许当前操作。监控中应分别统计,避免把权限配置错误误判为网络故障。

管理员恢复路径

如果业务身份只有 READ 与 WRITE,ACL 修复必须由预留的管理身份执行。上线前应验证管理身份能够读取和修改关键路径 ACL,并把恢复步骤保存在受控运维文档中,而不是临时依赖开放根权限。

验证权限边界

已认证身份尝试修改 ACL,因为当前未授予 ADMIN 权限,请求应被拒绝。

text
setAcl /apps/order digest:order-app:<BASE64_SHA1>:rwa

预期输出:

text
Insufficient permission : /apps/order

这说明“认证成功”不等于“拥有全部权限”。生产实践应把管理 ACL 的身份与业务读写身份分离,避免应用凭据可以自行扩大权限。

Tips:轮换 Digest 口令时,先新增新身份 ACL,确认新凭据可访问,再移除旧身份。直接覆盖旧 ACL 可能造成应用同时失联。

本课总结

  • Digest ACL 使用用户名与口令摘要表达身份,客户端认证时仍提交原始凭据
  • 创建节点时应显式传入最小权限 ACL,避免依赖默认开放权限
  • 认证和授权必须分别验证,成功登录不代表可修改 ACL

下一课预告

下一课将进入企业级认证方案,梳理 SASL、JAAS、Kerberos 主体、Keytab 与 ZooKeeper 服务之间的完整认证链路。

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

目录与阅读设置

阅读设置

17

记录一个想法

Digest 认证实践

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

登录哪都通