Por que usar OIDC para registries de containers?
Guardar credenciais de registry em segredos do GitHub é uma prática comum, mas arriscada. Se um token vazar, atacantes ganham acesso persistente ao seu registry. A nova action vercel/vcr-action/login resolve isso usando OIDC do GitHub para trocar um token de workflow de curta duração por um token de acesso da Vercel. O token é automaticamente revogado ao final do job.
Neste tutorial, vamos configurar a autenticação OIDC e fazer push de uma imagem Docker para o Vercel Container Registry (VCR) a partir do GitHub Actions. Vamos lá! 🚀

Passo a passo da implementação
1. Crie uma política OIDC na Vercel
Nas configurações do seu time na Vercel, crie uma política OIDC que corresponda ao seu repositório e workflow do GitHub. Conceda acesso read-write ao VCR.
2. Armazene as variáveis necessárias
Adicione as seguintes variáveis de repositório no GitHub (não são secrets, pois não são sensíveis):
VERCEL_TEAM_IDVERCEL_TEAM_SLUGVERCEL_PROJECT_SLUGVCR_REPOSITORY
3. Configure o workflow
name: Push to VCR
on:
push:
branches: [main]
permissions:
contents: read
id-token: write # Necessário para OIDC
jobs:
push:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: docker/setup-buildx-action@v3
- name: Log in to VCR
uses: vercel/vcr-action/login@v1
with:
team: ${{ vars.VERCEL_TEAM_ID }}
- name: Build and push
uses: docker/build-push-action@v6
with:
context: .
platforms: linux/amd64
provenance: false
tags: vcr.vercel.com/${{ vars.VERCEL_TEAM_SLUG }}/${{ vars.VERCEL_PROJECT_SLUG }}/${{ vars.VCR_REPOSITORY }}:latest
outputs: type=image,push=true,oci-mediatypes=true,compression=zstd,compression-level=3,force-compression=true
Dica: A action autentica o Docker por padrão. Passe
enginespara usar Podman ou Buildah.
4. Use a imagem no Vercel Sandbox
Após o push, você pode referenciar a imagem como uma imagem customizada do Vercel Sandbox dentro do mesmo projeto:
vcr.vercel.com/<team-slug>/<project-slug>/<repo>:latest

Limitações e cuidados
- Escopo da política OIDC: A política deve corresponder exatamente ao repositório e workflow; configuração errada causa falhas de autenticação.
- Tempo de vida do token: O token da Vercel é de curta duração e revogado após o job, então não pode ser reutilizado para debug manual.
- Suporte a plataformas: O exemplo usa
linux/amd64; outras arquiteturas podem exigir configuração adicional. - Sem fallback para secrets: Este método substitui credenciais estáticas; garanta que seu workflow não dependa delas em outros lugares.
Próximos passos
- Explore a documentação do VCR da Vercel para recursos avançados como scanning de imagens e políticas de retenção.
- Aprenda sobre hardening do OIDC no GitHub para reforçar a segurança dos seus workflows.
- Confira nosso guia sobre Gemini 3 Flash no Gemini CLI para mais insights de ferramentas de desenvolvimento.
![]()
Conclusão
Adotando autenticação baseada em OIDC para o Vercel Container Registry, você elimina credenciais de longa duração e reduz sua superfície de ataque. A action vercel/vcr-action/login facilita a integração em workflows existentes do GitHub Actions. Experimente e torne seu pipeline de imagens de container mais seguro!
Leitura recomendada: React Conf 2025 Key Takeaways para tendências de frontend que podem impactar sua estratégia de deploy.
Fonte: Vercel Changelog