Resposta rápida
Se um service token do Cloudflare Access foi detectado como vazado, a Cloudflare o desativa automaticamente. Para recuperar a integração, rotacione o Client Secret sem período de carência, atualize todos os serviços com o novo segredo e só então reative o token. O Client ID permanece igual, mas a rotação não reativa o token por conta própria.
Não tente apenas habilitar a credencial nem confie em apagar o arquivo ou o commit: um token reportado não pode ser reativado antes da rotação e o segredo antigo pode ter sido copiado. Pela API, omita previous_client_secret_expires_at na rotação; uma data futura retorna 400, e reativar antes de rotacionar retorna 409.
O que mudou em 11 de novembro de 2026
A Cloudflare passou a receber do GitHub relatórios de Client Secrets de service tokens do Access encontrados em repositórios públicos. Depois de validar o reporte, o Access desativa o token afetado e envia um e-mail aos administradores da conta. O objetivo é interromper o uso da credencial exposta antes que alguém apenas a habilite novamente.
Segredos criados desde 26 de agosto de 2026 usam o prefixo cfast_, 40 caracteres alfanuméricos e um checksum hexadecimal de oito caracteres. O formato permite detecção com maior confiança, mas os segredos antigos de 64 caracteres hexadecimais continuam válidos. Uma correspondência de expressão regular isolada não confirma que a credencial existe, está ativa ou passou pela verificação do checksum.
Recupere o token na ordem correta
A sequência evita dois erros comuns: tentar reativar o token ainda comprometido e religá-lo antes que todos os consumidores conheçam o novo segredo. Como não existe período de carência para um segredo reportado, a automação fica indisponível entre a rotação e a atualização do último consumidor. Planeje a troca como resposta a incidente, não como rotação gradual.
- Abra o relatório ou o e-mail, identifique o token e registre onde ele foi encontrado sem copiar o segredo.
- Rotacione o Client Secret; para um token reportado, o valor anterior é descartado imediatamente.
- Armazene o novo segredo no cofre ou no secret manager usado por cada ambiente.
- Atualize e reinicie todos os serviços que enviam CF-Access-Client-Secret.
- Reative o token somente depois da atualização dos consumidores.
- Teste uma chamada válida, revise os logs e remova a exposição original do repositório ou artefato.
Como rotacionar pelo painel ou pela API
No Cloudflare One, acesse Access controls, Service credentials e Service Tokens. No token desabilitado, escolha Rotate secret. Quando o vazamento foi reportado, o painel informa que o segredo atual será revogado imediatamente; copie o novo Client Secret para o gerenciador de credenciais porque o painel não o exibirá novamente.
Pela API, envie POST para /accounts/{account_id}/access/service_tokens/{service_token_id}/rotate com um token de API que tenha Access: Service Tokens Write. Para a recuperação de vazamento, não envie previous_client_secret_expires_at. Depois de atualizar os consumidores, use a atualização do service token com enabled igual a true.
- Confirme o ID da conta e o ID do service token sem registrar o Client Secret.
- Faça a rotação sem enviar o campo previous_client_secret_expires_at e capture o novo segredo apenas no canal seguro.
- Atualize secrets do CI, cofres, variáveis protegidas e serviços em execução.
- Reative o token e confirme o resultado com uma requisição de baixo risco.
Por que apagar o segredo do GitHub não basta
O GitHub envia alertas de parceiros diretamente ao provedor quando encontra um segredo compatível em repositórios públicos ou pacotes npm públicos. A Cloudflare pode agir antes que o responsável veja um alerta no repositório. Em conteúdo privado, a disponibilidade e o tipo do alerta dependem do plano e da configuração do secret scanning.
Remover o arquivo, reescrever o histórico ou excluir um log reduz a exposição futura, mas não invalida cópias que já saíram do repositório. A rotação é obrigatória mesmo quando o commit foi revertido rapidamente. Depois da contenção, procure o mesmo valor em branches, tags, pull requests, issues, wikis, gists, artefatos de CI e sistemas de log aos quais a equipe tem acesso autorizado.
Diferencie vazamento de erro 302, 401 ou 403
Um token desativado após reporte deixa de autenticar e pode causar 401 ou 403 quando o modo estrito está ligado. No modo estrito, apenas políticas Service Auth autorizam service tokens, o Access ignora cookies CF_Authorization e os headers CF-Access-Client-Id e CF-Access-Client-Secret precisam acompanhar todas as requisições. Organizações criadas desde 5 de outubro de 2026 usam esse modo por padrão e não podem desligá-lo.
Um 302 costuma indicar redirecionamento para login no comportamento não estrito. Já um 401 ou 403 também pode vir da aplicação de origem, de um gateway ou de uma política incorreta. Correlacione o horário, o hostname, a decisão da política e os logs; não conclua vazamento apenas pelo status HTTP.
- Token marcado como vazado ou enabled=false: rotacione, atualize e reative.
- 401 ou 403 sem reporte: valide o segredo, a expiração e a política Service Auth.
- 302: confirme se a resposta aponta para o login do Access e se o modo estrito está desativado.
- Falha ampla em vários serviços: consulte o Cloudflare Status antes de mudar políticas em massa.
Valide a recuperação sem vazar o novo segredo
Faça o teste a partir do mesmo ambiente que executa a integração, lendo Client ID e Client Secret do cofre. Mostre apenas o código HTTP, o hostname e um identificador seguro da execução. Não use curl -v, set -x, printenv, dumps de headers ou tickets com capturas que contenham o valor novo.
Nos logs de autenticação do Access, procure o token, a aplicação, o horário e a decisão da política. A API do service token pode expor leak_reported_at, leak_reporter e leak_report_url enquanto o reporte está associado; a rotação limpa esses campos. Preserve o histórico necessário nos logs administrativos antes de depender desses metadados para a investigação.
Como reduzir a chance de outro vazamento
Mantenha o Client Secret fora do repositório, do arquivo .env versionado, de exemplos, logs e comandos armazenados no histórico. Use um segredo por ambiente e por finalidade quando possível, aplique a política Service Auth apenas às aplicações necessárias e defina responsáveis por alertas e rotação.
Ferramentas próprias podem procurar o formato atual com a expressão cfast_[A-Za-z0-9]{40}[a-f0-9]{8}. Essa regra não cobre os segredos legados de 64 caracteres hexadecimais e não valida o checksum nem o estado da credencial; use-a como sinal de revisão, não como prova definitiva.
- Guarde o segredo em um cofre e injete-o somente no processo que precisa autenticar.
- Bloqueie logs de headers e revise flags de debug antes de ativá-las em produção.
- Separe tokens de desenvolvimento, homologação e produção para limitar o impacto.
- Configure destinatários para alertas de service token vazado e de expiração.
- Revise periodicamente tokens sem uso e remova credenciais que não têm proprietário.
Limitações e próxima ação útil
Este guia foi verificado em 12 de novembro de 2026. A recuperação descrita vale para service tokens do Cloudflare Access reportados como vazados; ela não substitui a rotação de API tokens, chaves de origem, certificados, credenciais OAuth ou segredos de outros provedores. O GitHub e a Cloudflare podem ampliar padrões, locais examinados e comportamento de alertas, por isso confirme a documentação atual antes de automatizar a resposta.
A próxima ação é abrir a lista de Service Tokens, confirmar quem recebe os alertas e mapear todos os consumidores de cada Client ID. Se houver um token desabilitado por vazamento, execute hoje a sequência rotacionar, atualizar, reativar e investigar; não prolongue a indisponibilidade tentando restaurar o segredo antigo.
Faça o próximo teste
Fontes consultadas
Os links abaixo servem para conferir conceitos, orientações oficiais e o critério editorial usado neste conteúdo.
- Rotate leaked Access service tokens before re-enabling themCloudflare Changelog
- Strict service token authenticationCloudflare Changelog
- Service tokensCloudflare Docs
- Update a service tokenCloudflare API
- Access authentication logsCloudflare Docs
- Secret scanning for partnersGitHub Docs
- Supported secret scanning patternsGitHub Docs
- Cloudflare StatusCloudflare
