服务注册与分布式协调 / 系统课时
配置目录读取与管理权限
配置目录读取与管理权限
目录权限要解决的不是“谁能登录 Nacos”,而是“谁只能读 MCP 目录、谁能修改服务、谁能管理权限”。本篇用命名空间与最小权限把 Agent 运行账号、发布流水线和平台管理员拆开,并用无权限账号做一次拒绝访问验收。
学习目标
- 区分 MCP 目录读取、服务管理与权限管理三类能力。
- 为 Agent、发布流水线和平台管理员划分最小权限边界。
- 用独立客户端验证无读取权限时目录访问确实失败。
用命名空间拆开读写边界
同一身份既能读取目录又能修改 MCP 服务,会把运行时故障扩大成配置事故。Nacos 当前 v3 Console API 中,MCP 列表查询要求对应命名空间的读取权限,更新 MCP 服务要求对应命名空间的写入权限,因此应把“发现服务”和“治理服务”拆成不同职责。([Nacos 官网][1])
| 身份 | 目录读取 | MCP 服务管理 | 用户、角色与权限管理 |
|---|---|---|---|
| Agent 运行账号 | 仅目标运行命名空间 | 不允许 | 不允许 |
| 发布流水线 | 发布目标命名空间 | 允许创建、更新或下线 | 不允许 |
| 平台管理员 | 按治理范围读取 | 按治理范围写入 | 允许 |
命名空间同时承担环境边界。比如把测试目录放在 mcp-test,生产目录放在 mcp-prod,不要仅靠服务名约定区分环境。Agent 的生产凭据只给 mcp-prod 读取能力,流水线也只获得它实际发布目标的写权限。
开启鉴权并使用独立账号
下面是默认 Nacos 鉴权的关键配置片段。集群部署时,各节点的服务身份与 token 签名密钥必须保持一致;生产值应从密钥管理系统注入,而不是提交到仓库。([Nacos 官网][2])
nacos.core.auth.system.type=nacos
nacos.core.auth.enabled=true
nacos.core.auth.admin.enabled=true
nacos.core.auth.console.enabled=true
nacos.core.auth.server.identity.key=${NACOS_IDENTITY_KEY}
nacos.core.auth.server.identity.value=${NACOS_IDENTITY_VALUE}
nacos.core.auth.plugin.nacos.token.secret.key=${NACOS_TOKEN_SECRET}这是 application.properties 的片段示例。生效后,分别创建 Agent、流水线和管理员身份,再通过所选鉴权实现绑定角色与资源权限。默认 Nacos 鉴权使用用户、角色、权限的 RBAC 模型,读操作使用 r,写操作使用 w;不要直接给 Agent 或流水线分配全局管理员角色。([Nacos 官网][3])
验证无权限客户端被拒绝
先准备一个能完成身份认证、但没有 mcp-prod 读取权限的 token。下面脚本直接调用 MCP 目录列表接口,并把“非 2xx”转换成稳定的验收结果。将 <PORT> 和 <TOKEN> 替换成实际值;如果前面还有网关,也要按实际部署补上路径前缀。
#!/usr/bin/env bash
set -euo pipefail
NACOS_CONSOLE="http://127.0.0.1:<PORT>"
TOKEN="<TOKEN>"
NAMESPACE_ID="mcp-prod"
URL="${NACOS_CONSOLE}/v3/console/ai/mcp/list?pageNo=1&pageSize=20&namespaceId=${NAMESPACE_ID}&search=blur"
# 使用“能认证但无 mcp-prod 读取权限”的 token。
status="$(curl -sS -o /tmp/mcp-list-response.json -w '%{http_code}' \
-H "Authorization: Bearer ${TOKEN}" \
"${URL}")"
# 把任意非 2xx 拒绝结果收敛成稳定的验收输出。
if [[ "${status}" =~ ^2 ]]; then
echo "FAIL: unauthorized client can read MCP catalog"
cat /tmp/mcp-list-response.json
exit 1
fi
echo "PASS: MCP catalog read denied"预期输出
PASS: MCP catalog read denied这里不把具体 HTTP 状态码写死,因为不同鉴权插件或网关可能用不同拒绝码;验收条件只有一个:无读取权限的身份不能得到成功响应。完成拒绝测试后,再用 Agent 正式账号执行同一请求,应能读到目标命名空间,而写接口仍然被拒绝。
把权限变更纳入发布控制
发布流水线的凭据应独立于 Agent 运行凭据,并限制到必要命名空间。平台管理员负责账号、角色和权限生命周期,不把管理员 token 放入应用配置或 CI 日志。权限缓存开启时,变更可能不会在所有请求上瞬时可见,验证时应等缓存刷新后再判定失败。([Nacos 官网][2])
最终边界应当很简单:Agent 只读,流水线按发布范围写,管理员治理权限本身。这样即使某个运行时账号泄露,也不会自动获得修改目录或扩散权限的能力。