用途:为开发者提供 Contentstack 认证方式与令牌类型的选型建议,覆盖前端、后端、自动化脚本、CI/CD、迁移、第三方应用和交互式会话等场景,同时给出安全、速率限制与 SSO 方面的指导。
主要能力:根据使用场景推荐合适的令牌类型;说明哪些凭据可安全用于客户端、哪些只能用于服务端;提供凭据处理与安全最佳实践;在涉及吞吐量或 429 错误时说明速率限制与退避策略;在 SSO 组织中提示 authtoken 的使用限制。
令牌决策规则:前端读取已发布内容使用 delivery token;实时预览草稿内容使用 preview token;后端自动化、CI/CD 与迁移脚本使用 management token;交互式用户会话仅在合适时使用 authtoken;第三方应用优先使用带作用域的 OAuth。management token 为栈级别且每栈数量有限,authtoken 与用户绑定并有各自限制。SSO 组织可能限制 authtoken 使用,自动化场景建议改用 management token 或 OAuth。
安全规则:绝不在客户端代码中暴露 management token 或 authtoken;凭据使用环境变量,如 CONTENTSTACK_API_KEY、CONTENTSTACK_DELIVERY_TOKEN、CONTENTSTACK_MANAGEMENT_TOKEN;禁止硬编码密钥;建议轮换与最小权限。遇到 429 建议使用带抖动的指数退避,并在重试前检查速率限制响应头。
使用方式:该技能为只读咨询型,不创建、修改、撤销、轮换或删除令牌,也不请求、展示或存储真实密钥,示例中仅使用占位符。
适用场景:开发者询问认证方式、令牌类型、API key、速率限制、SSO 集成或凭据安全时。
限制:仅提供建议,不执行任何凭据变更操作;具体令牌数量上限、速率限制数值等细节资料未提供。