用途:以最小安全路径验证 Canva Connect 集成是否可用。一次成功的身份或资料读取只能确认连通性与授权形态,不代表已获得设计创建、导出、素材等权限。
前提:已配置 Canva 集成与精确的重定向 URI;已批准的最小身份/资料权限范围的测试用户;后端密钥存储与脱敏证据存放位置。
步骤:一、确认后端边界,用 Read 与 Grep 检查令牌交换与存储留在服务端、目标基础 URL 精确、客户端代码中无凭据。二、选择读取,使用已授权显式范围支持的最小 users/me 或 profile 请求,不添加设计写入范围。三、发送一次请求,使用既有已审查的 HTTP 适配器与有界超时,不打印 Authorization 头、响应体、邮箱、资料或令牌元数据。四、校验响应形态,检查状态码、内容类型、必需响应封装,以及仅用于关联的最小不透明身份字段。五、分类失败,区分传输、无效令牌、缺少显式范围、同意被撤销、响应格式错误与提供方错误。六、记录成功,用 Write 或 Edit 保存集成/配置版本、端点模式、状态类别、模式结果、延迟分桶与脱敏检查。
认证:Canva Connect 调用使用后端通过 OAuth 2.0 Authorization Code 加 SHA-256 PKCE 获取的 Bearer 访问令牌。请求显式最小权限范围,客户端密钥与令牌不得出现在浏览器可见状态,刷新需串行化并以原子方式存储替换后的单次使用刷新令牌。
工具纪律:用 Read 与 Grep 做发现与取证;仅用 Write 或 Edit 保存本工作流批准的产物、代码、配置、测试或回执,不做未经批准的 Canva 侧变更。
输出:带范围的决策或实现产物、脱敏的操作与验证回执、失败/回滚/后续责任记录。
错误处理:令牌对客户端可见则停止并移至后端;读取返回禁止则比对精确范围与同意,不盲目扩大范围;响应含意外字段则按固定模式拒绝或忽略;若验证需要写入,则改用受支持的非变更请求重新设计。
限制:本技能仅覆盖只读连通性证明,不涉及设计创建、导出、素材等写入能力;具体端点、字段与配置细节以官方 Quickstart 与 Users APIs 为准。