SuperAPI AI 工具集

access-protected-vercel-deployment

部署与运维

查看项目

更新于 10-16 07:21

技能介绍

用途:在保持 Vercel 部署保护开启的前提下,访问和测试受 Vercel Authentication、SSO 或 Deployment Protection 保护的预览与生产部署。核心原则是复用调用者已有的 Vercel 认证,不关闭 Deployment Protection,也不以索要长期绕过密钥作为首选方案。

主要能力与用法:HTTP 请求用 vercel curl(vc curl)替代原始 curl,它接受原生 curl 选项并借助 Vercel 认证访问受保护的预览与生产部署,例如 vc curl https://my-app.vercel.app/api/health;仅路径形式 vc curl /api/health 指向已链接项目的生产部署,需要精确指定部署时传完整 URL。认证失败先检查身份与项目:vc whoami,查看 .vercel/project.json 确认链接的项目与团队;仅在目录未链接或链接错误时运行 vc link,仅在 CLI 报告无认证用户时运行 vc login。浏览器自动化需把开发用 OIDC 令牌作为请求头加入:x-vercel-trusted-oidc-idp-token: <VERCEL_OIDC_TOKEN>,使用支持来源限定请求头的浏览器工具,在首次导航前注入;Playwright 等其他驱动可在浏览器上下文的 extra HTTP headers 中设置同名头。若本地 CLI 不通过 vc env run 提供令牌,可用 vc env pull .env.local --yes 刷新凭据,通过项目既有 dotenv 机制加载。

信任来源规则:已链接项目的本地开发令牌默认可访问同项目预览部署,但不自动访问受保护的生产部署;访问受保护生产需项目自身的 Trusted Sources 条目允许 development → production。目标为受保护生产、调用者属于其他项目或团队、目标项目自定义了自访问规则,或响应为 TRUSTED_SOURCES_ENVIRONMENT_MISMATCH 时,需在目标项目 Settings → Deployment Protection → Trusted Sources 中配置相应的 from → to 环境对。这属于访问控制变更,应先说明确切规则并获授权,不要扩大无关环境对。

诊断:出现 Vercel 登录、SSO 或 Deployment Protection 页面说明请求未使用可接受的认证路径;TRUSTED_SOURCES_ENVIRONMENT_MISMATCH 表示令牌有效但调用者环境不被允许;绕过保护后的应用自身 401/403 属应用认证,需单独排查;标记为 production 的部署仍可能受保护。避免关闭 Deployment Protection、反复发送未认证 curl、在可认证时启动交互式 SSO、以及在日志或提交文件中暴露 VERCEL_OIDC_TOKEN。相关技能:vercel-cli、verification。