用途:在接入 QuickNode 时,帮助区分并配置正确的凭据边界。端点令牌(endpoint token)仅授权链上 RPC 流量;API 密钥(API key)授权 QuickNode 产品与控制面客户端,如 Admin API、Streams、统一 SDK 和 qn CLI。
主要能力:清点凭据使用方(查找端点 URL、x-token、x-api-key、QN_SDK__API_KEY、QUICKNODE_* 引用);按用途选择凭据类型(HTTP/WSS 链 RPC 用端点令牌,服务端优先 x-token 头;Admin API、SDK、Streams、Webhooks、KV Store、SQL Explorer 用仪表盘 API 密钥);按开发、预发、生产及独立应用隔离环境;安全配置客户端(只写密钥引用与变量名,不写值;SDK 用 QN_SDK__API_KEY);验证边界(只读 JSON-RPC 探测,确认链标识与移除凭据后的预期拒绝);记录轮换(类型、范围、使用方、存储引用、创建/复核日期、先撤销回滚,采用重叠轮换:创建、部署、验证、再撤销旧令牌)。
使用方式:用 Read 与 Grep 做发现,用 Write 与 Edit 添加密钥引用,用 Bash(qn:) 仅在获批的交互式操作会话中执行 qn auth login 与 qn auth whoami,用 Bash(curl:) 做脱敏只读探测。
适用场景:生产 RPC 服务通过密钥管理器获取专用端点令牌;部署审计方通过 SDK 使用独立 x-api-key 身份且无法提交链上交易。
限制与注意:切勿将实时端点 URL 放入源码、日志、shell 历史或支持证据;令牌出现在 URL 日志中应立即撤销、清理日志并替换;端点返回未授权时检查令牌放置,Admin API 返回 401 时检查 API 密钥与账户范围而非 RPC 令牌;轮换破坏单个使用方时可在重叠窗口恢复旧密钥引用。前置条件包括客户端、链、网络、环境与所需产品,获批的密钥管理器与指定轮换负责人,以及仅能创建所需凭据的账户角色。具体命令与配置细节以官方资料为准,暂未提供更多。