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á! 🚀

Developer configuring Vercel Container Registry login via GitHub Actions OIDC for secure cloud deployments Software Concept Art

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_ID
  • VERCEL_TEAM_SLUG
  • VERCEL_PROJECT_SLUG
  • VCR_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 engines para 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

Docker image being pushed to Vercel Container Registry from a GitHub Actions workflow using short-lived tokens Programming Illustration

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

GitHub Actions workflow file showing OIDC permissions and VCR login step for container security Algorithm Concept Visual

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

Este conteúdo foi elaborado com o auxílio de ferramentas de IA, com base em fontes confiáveis, e revisado pela nossa equipe editorial antes da publicação. Não substitui o aconselhamento de um profissional especializado.