用途:为 Infisical Sync Hand 提供专家级知识,覆盖 Infisical API 调用、本地 vault 读写、同步状态记录、错误处理与安全规范,用于在自托管 Infisical 实例与智能体本地加密存储之间同步密钥。
主要能力:
- 认证:使用 Machine Identity 的 Universal Auth,POST /api/v1/auth/universal-auth/login,请求体含 clientId 与 clientSecret,成功返回 accessToken、expiresIn(通常 7200 秒)。
- 密钥操作:GET /api/v4/secrets 列出密钥(参数 projectId、environment 必需,secretPath、includeImports、recursive 可选);POST /api/v4/secrets/{secretName} 创建(已存在返回 409);PATCH 更新(缺失返回 404),需用先创建后更新的模式;DELETE 删除。
- 项目列表:GET /api/v1/workspace。
- Vault 操作:vault_set、vault_get、vault_list、vault_delete,支持拉取后批量写入与清理孤立密钥。
- 同步状态:保存于 infisical_sync_state.json,用 sha256(key:value) 追踪变更而不存储明文。
- 错误码处理:400、401、403、404、429(等待 60 秒重试一次)、500/503(等待 30 秒重试一次),始终先校验 HTTP 状态再信任响应体。
- 安全清单:每轮同步前校验环境变量,令牌每轮重新获取,避免密钥值出现在命令回显或日志中。
使用方式:所有请求指向 $INFISICAL_URL;用 curl 调用接口并解析 JSON;密钥名须匹配 [A-Z0-9_],含特殊字符需 URL 编码;推送前对混合大小写键统一转大写。
适用场景与限制:适用于受控的自托管 Infisical 环境中的密钥同步;不提供官方托管服务说明,暂未提供价格、平台支持范围与性能数据。