用途:为 Lucid REST 操作选择并配置正确的认证模型,适用于初始化或修复 Lucid 集成时的凭据选型与验证。
主要能力:区分三类凭据——API 密钥(仅限当前操作支持且可接受个人归属时)、OAuth 用户令牌(委托用户访问与已同意范围)、OAuth 账户令牌(仅限有文档说明的账户级用途且经管理员授权)。OAuth 应用使用 Authorization Code Flow;REST 凭据通常以 Authorization: Bearer ... 发送,某些操作还可能需要资源专用的 Lucid-Api-Version 头。
使用方式:先重新获取认证方法、具体操作、访问范围与请求头;建立认证决策记录(凭据类别、主体、资源、范围、过期、轮换、吊销);检查项目中硬编码令牌、不安全重定向、已提交的环境文件与混用凭据;定义环境变量名与密钥提供方接口但不写入值;对 OAuth 校验重定向 URI、state 处理、授权码交换、令牌安全存储、刷新与吊销;凭据在对话外配置完成后,执行最小的只读验证,仅记录状态、主体类别、范围与安全请求标识。
限制与边界:不得创建密钥、注册或修改 OAuth 应用、授权账户、扩大范围或轮换/吊销凭据,除非获得相应所有者批准;不得伪造 Lucid-Api-Key 头或记录授权值;范围不足时应申请文档中更窄的范围,不得静默扩大同意;OAuth 重定向或 state 校验失败应停止交换并修复应用配置。建议在非生产环境先测试吊销与轮换。