Nacos
配置 Nacos 账号、Nacos 版本、访问范围与自动 Token 刷新。
在连接器的 访问内容 → 添加访问 中，从 服务预设 选择 Nacos，填写 Nacos 版本、Nacos 服务地址 和账号。平台用用户名与密码登录，在 Token 过期前自动续期，Token 不会交给 ZAI；ZAI 直接调用允许的业务 API。
获取与填写凭证
在 Nacos 中创建业务账号，并通过 Nacos 的角色与权限授予所需的配置或服务访问权。填写该账号的用户名和密码。保存后两项都不再显示；需要更新时使用 替换凭证，重新填写整组用户名和密码。
这种方式适用于 Nacos 默认的用户名密码鉴权。服务使用外部 OIDC 或自定义认证插件时，应按其实际认证方式配置。
Nacos 版本
在 Nacos 版本 中选择 Nacos 2.x 或 Nacos 3.x，这个选择影响登录接口和推荐访问路径：
| 版本 | 登录路径（服务路径为 /nacos 时） |
|---|---|
| Nacos 2.x | /nacos/v1/auth/login |
| Nacos 3.x | /nacos/v3/auth/user/login |
业务 OpenAPI 的 v1、v2、v3 路径仍以所使用的 Nacos 接口文档为准。升级 Nacos 后可以编辑版本，保存后平台会重新获取 Token。
例如 2.x 的配置接口使用 group，3.x 对应的配置接口使用 groupName，并可显式指定 namespaceId。版本选择不会自动转换这些业务参数，请按所调用的接口文档填写。
服务地址
Nacos 服务地址 填写完整的 HTTP API 地址，包含协议、实际端口和服务路径，例如 https://<nacos-host>/nacos。反向代理修改了服务路径时，填写修改后的路径；不要填写 Nacos 控制台的独立端口或登录接口本身。
登录和业务请求必须使用同一个协议、主机及端口。自定义目标只能收窄该服务的访问范围，不能借用这份账号访问另一个服务。
访问范围
推荐配置允许对应版本的配置与服务 API。自定义配置可以进一步限制路径和 HTTP 方法。namespace、group、dataId 及读写权限由 Nacos 账号的 RBAC 决定，使用指令不能替代权限设置。
ZAI 调用业务接口时，平台自动附上 Token；ZAI 自己携带的认证请求头、查询参数或表单字段会被平台替换，配置正文不受影响。认证、用户与权限管理接口不会附上这份 Token。
网络
所属连接器指定了网络隧道时，登录、刷新和业务请求都经由这条隧道；隧道离线、授权被撤销或无法建立连接时，请求失败。切换隧道后，平台会重新获取 Token。连接器没有指定隧道时，使用沙箱配置的内网路由。
HTTP 地址必须经由网络隧道访问，可以是连接器指定的隧道，也可以是沙箱配置中匹配的内网路由。HTTPS 地址没有匹配到任何隧道或内网路由时，由平台直接访问，只能是公网可达的地址，私网 IP 会被拒绝。使用 HTTPS 地址时，平台会校验 Nacos 的证书。网络隧道不会把从隧道到 Nacos 这一段的 HTTP 连接变成 HTTPS。
Token 与失败处理
替换凭证、修改服务地址或版本后，平台会重新登录；撤销凭证后，平台不再用这份账号登录。
认证失败或 Token 已过期时，业务请求失败。平台不会自动重试业务请求，以免重复执行配置发布或服务变更。遇到权限错误，检查 Nacos 账号权限及请求参数。
支持范围与验证
支持经平台转发的 HTTP OpenAPI，包括 URL 编码表单和 JSON 请求。Nacos SDK 的 gRPC 连接、Nacos 控制台的浏览器登录、multipart 文件导入和压缩表单不在支持范围内。
保存后，请 ZAI 先读取一项账号有权访问的配置，再验证所需的业务操作。登录接口不需要加入访问地址，也不需要向 ZAI 提供用户名、密码或 Token。其余排查见验证与排错。
官方说明：Nacos 2.x 鉴权 与 Nacos 3.x 鉴权。