Vercel Passport 정식 출시
Vercel Passport가 일반 공개되어 배포 보호, 사용자 식별, 백엔드 검증, 우회 기능을 지원합니다.
교안에 영향
기존 안내 글에서 Passport 지원 범위, getIdentity()와 verifyIdentity() 사용법, 자동화 우회 방식, custom environments 지원 여부가 맞지 않을 수 있습니다.
요약
- Vercel Passport가 일반 공개되어 자체 identity provider로 배포를 보호할 수 있게 됐습니다. - @vercel/passport의 getIdentity()로 방문자 신원을 읽고, verifyIdentity()로 다른 백엔드에서 토큰을 검증할 수 있습니다. - 그룹 클레임, Activity Log와 Audit Logs 기록, 자동화 트래픽 우회, Trusted Sources 우회가 추가됐습니다. - custom environments 지원이 추가되어 staging, qa 같은 환경에서도 Passport sign-in을 사용할 수 있습니다.
바뀐 것
새 기능
- Vercel Passport가 일반 공개되었습니다.
- Okta, Microsoft Entra ID 또는 any OIDC provider를 통해 방문자 인증을 거쳐 보호된 deployment를 볼 수 있습니다.
- @vercel/passport의 getIdentity() helper가 Vercel request context에서 인증된 방문자를 읽어옵니다.
- subject 필드와 externalSubject 필드로 방문자 식별 정보를 사용할 수 있습니다.
- 로컬 개발에서 getIdentity()가 configurable development identity를 반환합니다.
- groups scope와 허용된 claim을 통해 identity provider의 그룹 정보를 토큰에 담을 수 있습니다.
- @vercel/passport 1.0.0 이상에서 verifyIdentity()로 토큰 서명과 Passport claims를 검증할 수 있습니다.
- JWT와 published JWKS로 JavaScript 외 서비스에서도 Passport 토큰을 검증할 수 있습니다.
- 성공한 Passport 인증이 Activity Log와 Audit Logs의 passport-access-granted event로 기록됩니다.
- Protection Bypass for Automation이 Passport에도 적용되어 webhook, cron jobs, CI runs가 계속 우회할 수 있습니다.
- Trusted Sources로 shared secret 없이 Passport를 우회할 수 있습니다.
- custom environments를 지원하여 staging, qa 같은 환경에도 Passport sign-in을 적용할 수 있습니다.
개선
- x-vercel-oidc-passport-token 헤더는 클라이언트 값이 제거되고 검증된 토큰이 주입됩니다.
기타
- Enterprise plan에서 사용할 수 있고, identity provider setup, token claims, local development, forwarding identity between backends, bypassing Passport for automation 가이드가 추가되었습니다.