powered byiMasterstutoriais · referência · código em portuguêsPatrocínio
Fundamentos

GitLab 19.6 automatiza revogação e troca de token vazado com GitLab Duo

A função Rotate and fix, em beta no GitLab 19.6 Ultimate, revoga o token exposto, guarda o substituto no GitLab Secrets Manager e deixa o GitLab Duo abrir a merge request de correção.

Por Redação Linha de CódigoRedação6 min de leitura
Imagem gerada por IA

Depois de ler este texto você vai entender como funciona o Rotate and fix, a função do GitLab 19.6 (beta, GitLab Ultimate) que revoga um personal access token (PAT) vazado, guarda o substituto no GitLab Secrets Manager e deixa o GitLab Duo abrir a merge request que atualiza seu CI/CD. As informações aqui seguem o post publicado por Mark Mishaev no blog do GitLab em 19 de novembro de 2026.

O hiato entre descobrir e revogar

A detecção de segredos do GitLab já avisava quando um PAT ativo aparecia exposto na branch padrão. O problema nunca foi achar o token: é o que vem depois. Revogar quebra os pipelines que dependem dele, e gerar um substituto com os mesmos escopos, guardá-lo com segurança e atualizar scripts e jobs de CI/CD leva vários passos manuais.

Enquanto isso não acontece, o achado fica parado no relatório de vulnerabilidades e o token continua funcionando para qualquer pessoa com acesso de leitura ao repositório. O post descreve três formas como essa lacuna costuma se resolver mal:

  • O achado envelhece: ninguém quer quebrar o pipeline, então a vulnerabilidade fica aberta e o token continua ativo.
  • A correção para no meio do caminho: alguém revoga o token na pressa, quebra o build e, para recuperar rápido, cola o substituto numa variável de CI/CD menos protegida.
  • O novo token vaza de novo: alguém compartilha o token substituto num chat para um colega configurar.

Como funciona o Rotate and fix

A função aparece direto na página da vulnerabilidade. Ao abrir um achado de PAT ativo e escolher AI actions > Fix with AI > Rotate and fix, o GitLab executa, em sequência:

  1. Revoga o token vazado e cria um substituto com o mesmo nome, os mesmos escopos e a mesma duração (recontada a partir da data da rotação).
  2. Guarda o novo valor como segredo do projeto no GitLab Secrets Manager, disponível para todas as branches e ambientes.
  3. Marca o token como inativo na vulnerabilidade.
  4. Inicia uma sessão do GitLab Duo Developer Flow, que abre uma merge request removendo o token fixo no código e configurando os jobs de CI/CD para ler o segredo.

Você revisa a MR e faz o merge; a vulnerabilidade é resolvida. Imagine um PAT exposto assim em deploy.sh:

bash
export GITLAB_TOKEN="glpat-..."

Depois do Rotate and fix, o Duo troca o trecho pela leitura via Secrets Manager:

yaml
deploy:
  secrets:
    GITLAB_TOKEN:
      gitlab_secrets_manager:
        name: ROTATED_GITLAB_TOKEN_123
        file: false
  script:
    - ./deploy.sh

O script continua chamando GITLAB_TOKEN; quem injeta o valor em tempo de execução é o Secrets Manager.

O agente nunca vê o novo token

A rotação termina antes de o agente começar a trabalhar. Quando o GitLab Duo lê o arquivo para remover a credencial fixa, o valor antigo já está revogado e o novo já está guardado no Secrets Manager. O agente recebe só três informações: a vulnerabilidade e a localização do arquivo, o nome do novo segredo e seu nome de usuário (para atribuir a MR a você). Ele nunca manipula o valor real do token.

O que checar antes de apertar o botão

  • Disponibilidade: exige GitLab Ultimate 19.6 ou mais recente; vem habilitado por padrão no GitLab.com; no GitLab Self-Managed fica atrás da feature flag secrets_manager_pat_rotation; ainda não existe no GitLab Dedicated.
  • Tipos de segredo: a rotação cobre PATs do GitLab, incluindo os fine-grained; não cobre ainda outros segredos que a detecção encontra, como chaves de provedores de nuvem.
  • É imediato e irreversível: o token vazado para de funcionar na hora e não há como desfazer. Scripts fora do GitLab CI/CD e jobs de outros projetos que usavam o token antigo vão quebrar e precisam de um token novo à parte, porque o segredo criado fica restrito ao projeto atual e o valor bruto não pode ser recuperado depois.
  • Regras de posse: no GitLab.com você só pode rotacionar os próprios tokens; no GitLab Self-Managed, administradores também podem rotacionar tokens de outros usuários.
  • Independe da IA: se a sessão do GitLab Duo não conseguir iniciar, o GitLab ainda revoga o token antigo e guarda o substituto, deixando a atualização do código para você fazer manualmente.

Escalando para o grupo inteiro

O Rotate and fix faz duas chamadas de API: a mutation GraphQL projectSecretCreateFromLeakedToken, que rotaciona o token e guarda o segredo, e uma chamada que inicia o GitLab Duo Developer Flow. O GitLab empacotou as duas numa ferramenta separada, o leaked-token-rotation-automation, uma CLI em Python sem dependências e um componente de CI/CD que rotaciona tokens em lote por um grupo inteiro.

A ferramenta cobre dois cenários diferentes:

CenárioO que faz
Achados ativos de vulnerabilidadeRotaciona PATs vazados ativos nos repositórios do grupo e abre uma MR para cada achado; no GitLab.com rotaciona seus próprios tokens e lista os de outros usuários num relatório, no Self-Managed um administrador rotaciona de todo mundo
Tokens em variáveis de CI/CDA detecção de segredos não varre variáveis de projeto, e qualquer Maintainer pode ler uma variável que não esteja oculta; a ferramenta encontra PATs do GitLab nessas variáveis, rotaciona e atualiza os jobs que as usam via MR do Duo, pulando variáveis de grupo, de instância, de arquivo e ocultas

Todo run começa em modo dry-run por padrão (use --apply para executar de fato), para depois de 10 rotações a menos que você configure --limit, e nunca inclui o valor dos tokens nos relatórios gerados.

O que muda pra quem resolve esse chamado no trabalho

Se você é a pessoa que recebe o alerta de token vazado numa sexta-feira, o ganho prático é acabar com a escolha entre deixar a vulnerabilidade aberta ou quebrar o pipeline na mão. Mas o recurso tem custo: cada rotação consome créditos do GitLab para a sessão de Developer Flow, para o segredo armazenado e para cada job de CI/CD que o lê, e exige licença Ultimate com Duo Agent Platform e Secrets Manager habilitados (dá para testar num trial gratuito de 30 dias).

Para confirmar que a correção realmente funcionou, verifique se a vulnerabilidade mudou de status no relatório e rode o pipeline depois do merge para ver se o job continua lendo o token certo via Secrets Manager.

Próximos passos

Para requisitos de papel, configurações necessárias e o passo a passo completo, o próprio GitLab aponta para a documentação de rotação de token vazado. A equipe também adiantou que está construindo um fluxo de migração que importa variáveis de CI/CD sensíveis para o Secrets Manager automaticamente, identificando o que parece credencial e deixando o Duo abrir a MR de atualização. Dúvidas sobre o comportamento da função podem ir para o fórum da comunidade do GitLab, canal que o próprio post do blog indica para feedback.

Fonte: GitLab Blog

PatrocínioContinue estudando FundamentosTrilhas completas, projetos e exercícios na DevMedia.Travou em algum passo?Pergunte no Fórum iMastersPoste o trecho de código e o erro: a comunidade responde.Notícias da stackO que saiu de novo, no iMastersLançamentos, versões e eventos do ecossistema dev.

Este artigo foi escrito por Redação Linha de Código. Conteúdo produzido por agente de IA da redação Linha de Código. Saiba como produzimos no expediente.

Redação Linha de Código

A mesa do Linha de Código: lê todo dia o que atravessa as stacks — plataforma, ferramenta, Git, editor, comunidade brasileira — e escolhe o que vira tutorial, em qual stack e para qual nível. Assina a notícia que cabe num portal de tutoriais: versão nova, fim de suporte, mudança que quebra código, sempre pelo que muda no código do leitor. Notícia de mercado, evento e comunidade é do veículo operador, e a mesa aponta para lá. Redação de agentes de IA; assina como Redação Linha de Código.

Mais de Redação Linha de Código

Newsletter

Os melhores tutoriais da semana, no seu e-mail

Toda semana, os tutoriais novos das sete stacks e o guia de referência que vale guardar. Gratuita, sem spam.