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.
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:
- 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).
- Guarda o novo valor como segredo do projeto no GitLab Secrets Manager, disponível para todas as branches e ambientes.
- Marca o token como inativo na vulnerabilidade.
- 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:
export GITLAB_TOKEN="glpat-..."Depois do Rotate and fix, o Duo troca o trecho pela leitura via Secrets Manager:
deploy:
secrets:
GITLAB_TOKEN:
gitlab_secrets_manager:
name: ROTATED_GITLAB_TOKEN_123
file: false
script:
- ./deploy.shO 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ário | O que faz |
|---|---|
| Achados ativos de vulnerabilidade | Rotaciona 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/CD | A 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
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.
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.