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

排查 NoAuth 与 AuthFailed

排查 NoAuth 与 AuthFailed

NoAuth 和 AuthFailed 看起来都像“权限问题”,但排查入口完全不同:前者通常发生在 ACL 授权检查,后者发生在认证链本身。本节用错误码、ACL、主体映射和最小复现场景把两类故障拆开,避免盲目改权限。

学习目标

  • 根据错误类型判断问题在认证阶段还是 ACL 授权阶段。
  • 按操作对象、ACL scheme/id 与会话身份定位 NoAuth。
  • 从 scheme、JAAS、凭据和主体映射链路定位 AuthFailed 并验证修复。

先用错误类型决定方向

NoAuth 表示请求已经到达权限检查,但当前会话拥有的身份没有匹配到满足所需权限的 ACL。它不等于“客户端一定没有登录”:客户端可能已成功认证,只是认证成了错误主体,或者 ACL 使用了另一种 scheme。

AuthFailed 则表示认证提供者没有接受客户端认证信息。SASL 场景常见于 JAAS 上下文名不一致、keytab 不可读、Kerberos principal 或 realm 错误、服务端 principal 推导错误等。若服务端开启了强制认证,新版 ZooKeeper 还可能返回 SESSIONCLOSEDREQUIRESASLAUTH,表示会话因缺少所要求的认证 scheme 或认证失败而被服务端关闭。

NoAuth 与 AuthFailed 排障决策树

从 ACL 与操作对象开始定位

先记录三个事实:失败的操作、失败路径、准确错误码。ZooKeeper 的 ACL 不继承到子节点,因此只看父路径往往会误判;同时 CREATE 与 DELETE 权限检查的是父节点,而 READ、WRITE、ADMIN 针对目标节点。

随后用具备读取 ACL 权限的管理身份执行 getAcl <PATH>,逐项比较 ACL 的 scheme、id 和权限位。尤其要注意 sasl:user@REALM、digest:user:<HASH>、x509:<X500 Principal> 不能互换。即使用户名看起来相同,只要 scheme 或最终映射出的 id 不同,就不会命中同一条 ACL。

用最小 digest 场景复现 NoAuth

下面的脚本在测试集群创建一个临时诊断节点,先用 digest 身份收紧 ACL,再用一个全新的未认证会话读取它。digest 不依赖服务端密码库,因此“输错密码”通常会得到另一个 digest 身份,最终更常表现为 NoAuth,而不是 AuthFailed。

bash
set -e
ZK_SERVER="${ZK_SERVER:-127.0.0.1:2181}"
NODE="/diag-$RANDOM"

{
  echo "create $NODE demo"
  echo "addauth digest diag:secret"
  echo "setAcl $NODE auth:diag:secret:cdrwa"
  echo "getAcl $NODE"
  echo "quit"
} | "$ZK_HOME/bin/zkCli.sh" -server "$ZK_SERVER"

{
  echo "get $NODE"
  echo "quit"
} | "$ZK_HOME/bin/zkCli.sh" -server "$ZK_SERVER"

预期结果中,第一段会看到该节点 ACL 已转成 digest 身份;第二个新会话读取时会被拒绝。日志前缀和哈希值会因版本与环境不同:

text
'digest,'diag:<HASH>
: cdrwa
Insufficient permission : /diag-<ID>

<HASH> 是 ZooKeeper 保存到 ACL 的摘要,<ID> 对应脚本生成的随机节点后缀。若第二个会话反而能读取,说明 ACL 没有按预期收紧,应先检查前一段 setAcl 是否成功。

AuthFailed 查认证链而不是 ACL

遇到 AuthFailed 时,先暂停修改 ACL。ACL 只有在认证产生有效身份后才有意义,此时继续放宽权限会掩盖根因。

SASL/Kerberos 客户端重点核对 JAAS 上下文名是否与 zookeeper.sasl.clientconfig 一致,以及 keytab、principal、realm 和服务端 principal。下面是用于核对字段关系的片段示例:

text
Client {
  com.sun.security.auth.module.Krb5LoginModule required
  useKeyTab=true
  keyTab="<PATH>/app.keytab"
  principal="app/<HOST>@EXAMPLE.COM"
  storeKey=true
  useTicketCache=false;
};

该配置本身不产生控制台输出。验证时应确认 <PATH> 文件对运行用户可读、<HOST> 与实际 principal 匹配,并检查客户端是否使用名为 Client 的 JAAS context。若服务端要求 sasl,还要确认客户端没有设置 zookeeper.sasl.client=false。

用同一请求验证修复

修复后不要只看“连接成功”。认证成功只证明建立了身份,最终还要用原来失败的同一路径和同一操作复测;否则可能从 AuthFailed 变成 NoAuth,问题只是从认证层移动到了授权层。

排查顺序保持固定:先确认错误码,再确认操作对应的 ACL 节点,再比对 scheme/id,最后才修改凭据、JAAS 或 ACL。这样能把“认证失败”和“认证成功但无权访问”两类问题彻底分开,也能避免为了消除一个错误而把 ACL 临时放宽成新的安全缺口。

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

目录与阅读设置

阅读设置

17

记录一个想法

排查 NoAuth 与 AuthFailed

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

登录哪都通