后端与接口
用 Infisical Secret Syncs…
当需要把 Infisical 项目中的密钥自动推送到 AWS/GCP/Azure、GitHub、Vercel、Cloudflare、Vault 等第三方服务时,按此流程配置 Secret Sync。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 38/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 59/100 ×0.15
适用场景
用 Infisical Secret S特定
解决思路
- 先确认用户想同步到的目标服务,再按四步引导:App Connection(前置的已认证连接)、Source(从哪个 Infisical 环境和文件夹路径同步)、Destination(服务商特定配置,如 region、vault URL、repo 等)、Sync Options(初始同步行为、key schema、auto-sync、删除保护)。
- 根据目标服务读取对应参考文件:通用问题或通用流程读 references/sync-overview.md;AWS Secrets Manager / GCP Secret Manager / Azure Key Vault 读 references/aws-gcp-azure.md;GitHub / Vercel / Cloudflare Workers 读 references/github-vercel-cloudflare.md;HashiCorp Vault 或其他目标读 references/vault-and-others.md。
- 配置同步前先确认 App Connection 已存在且权限正确,因为每个同步都依赖它。
- 使用精确的 API 枚举值:初始同步行为是 overwrite-destination、import-prioritize-source 或 import-prioritize-destination,按 source/destination 命名,绝不按服务商命名;不存在 import-prioritize-infisical 或 import-prioritize-vercel。
- 始终建议配置 key schema(例如 INFISICAL_{{secretKey}}),它必须恰好包含一个 {{secretKey}},{{environment}} 可选;不匹配该 schema 的目标端密钥不会被 Infisical 更新或删除,schema 决定了影响范围。
- 提醒用户 Infisical 是唯一事实来源:目标端存在但 Infisical 中没有的密钥,可能根据初始同步行为被覆盖。
- 如果用户目标端已有密钥并正在迁移到 Infisical,推荐初始同步用 import-prioritize-destination 以免丢失现有值;先确认目标端支持 import——GitHub 和 Cloudflare Workers 不支持。
- 说明 auto-sync 默认开启,Infisical 中的变更会自动传播;也可关闭它改为仅手动同步。
- 注意 mapping 行为(one-to-one / many-to-one)仅适用于 AWS Secrets Manager,其他目标(GCP、Azure 等)不要提供该选项。
- 提醒服务商特性:Azure Key Vault 会把下划线转成连字符;GitHub 不支持导入密钥,其 scope 为 repository / organization / repository-environment,visibility 为 all / private / selected;Vercel 即使在 project scope 也要求 teamId,且不能导入敏感环境变量。
- 共支持 48 个目标,且没有 Jenkins 同步;如果用户询问不在列表中的目标,直接说明不支持,并引导其改用 CLI 或 API,不要临时编造方案。
适用边界 · 注意事项
- 不要用于创建同步所需的 App Connection(应使用 infisical-app-connections)。
- 不要用于把密钥拉取到应用、容器或流水线(应使用 infisical-setup),也不要用于同步到 Kubernetes(应使用 infisical-kubernetes-operator)。
- 不要用于同步证书(PKI Syncs 是独立功能,属于 infisical-pki,有 12 个目标)、轮换凭据(infisical-secret-rotation)、动态临时凭据(infisical-dynamic-secrets)或访问私有目标(infisical-gateway)。