用途:配置 Vercel 企业版的基于角色的访问控制(RBAC),包括团队角色、项目级访问组、SSO/SAML 集成与审计日志。覆盖两层访问控制:团队级(谁可以部署)与应用级(谁可以访问已部署内容)。
前提:Vercel Pro 或 Enterprise 计划;支持 SAML 2.0 的身份提供商(用于 SSO);了解组织的访问需求。
主要能力:
- 团队角色模型:Owner、Member、Developer(仅预览部署)、Viewer、Security(企业版),企业版还支持扩展权限(部署到生产、管理环境变量、管理域名、访问运行时日志、管理集成)。
- 通过 API 管理团队成员:邀请、列出、更新角色、移除成员,使用 curl 调用 api.vercel.com 的 teams 接口。
- 访问组:在 Team Settings > Access Groups 创建组,将成员分配到特定项目并赋予角色。
- SSO/SAML:在 Team Settings > Authentication > SAML Single Sign-On 启用,配置 IdP(Okta、Azure AD、Google Workspace),ACS URL 为 https://vercel.com/api/auth/saml/acs,Entity ID 为 https://vercel.com,Name ID 格式为 emailAddress,可映射 SAML 属性到 Vercel 字段,并强制所有成员通过 SSO 登录。
- 应用级认证:在 Next.js middleware.ts 中按路由校验 JWT 与角色,通过请求头传递用户信息。
- 审计日志:企业版在 Team Settings > Audit Log 查看,追踪成员变更、项目创建删除、生产部署、环境变量变更、域名变更、集成安装卸载、SSO 配置变更等事件,并可通过 API 导出。
使用方式:按步骤先理解角色模型,再用 API 配置成员,接着设置访问组、SSO/SAML、中间件认证与审计日志导出。
适用场景:实施团队访问控制、配置 SAML SSO、导出合规审计日志、按最小权限分配角色。
限制:审计日志需 Enterprise 计划;SSO 需支持 SAML 2.0 的 IdP;Developer 角色仅能预览部署;访问组未生效通常因成员未加入组;SSO 登录失败可能因 IdP 元数据 URL 过期。具体价格与更多平台细节暂未提供。