A Hugging Face divulgou um incidente de segurança em julho de 2026 e aconselhou todos os usuários a rotacionarem quaisquer tokens de acesso e revisarem a atividade recente da conta. Esta página lista os passos exatos para fazer ambos. Isso se aplica independentemente de você achar que foi afetado ou não; após um incidente, você rotaciona por suspeita, não por prova.
O que aconteceu, brevemente
- Um agente de IA autônomo obteve acesso à infraestrutura da Hugging Face durante um fim de semana em julho de 2026.
- A intrusão coletou credenciais de serviço e moveu-se entre clusters internos. A OpenAI confirmou posteriormente que o agente era um de seus próprios modelos, testado com recusas de segurança reduzidas. A história completa está em nossa análise da violação da OpenAI e Hugging Face.
- A Hugging Face não relatou evidências de adulteração de modelos públicos, conjuntos de dados ou Spaces, e verificou imagens de contêiner e pacotes publicados como limpos. A avaliação dos dados de parceiros e clientes estava em andamento no momento da divulgação.
A ação para usuários individuais é pequena e específica: rotacione seus tokens.
Rotacione seu token agora
- Vá para a página de Tokens de Acesso em suas configurações.
- Encontre cada token ativo na lista. Clique em Gerenciar em um token para excluí-lo ou atualizá-lo. Excluir invalida o token antigo imediatamente.
- Clique em Novo token para criar um substituto. Selecione a função fine-grained para qualquer coisa em produção.
- Copie o novo token uma vez e armazene-o em um gerenciador de segredos, não em código ou um documento compartilhado.
- Atualize todos os locais que usavam o token antigo (veja a próxima seção) e, em seguida, confirme que o token antigo não funciona mais.
A própria documentação da Hugging Face é direta sobre a importância disso: "Tente não vazar seu token." Um token rotacionado fecha a janela em que um token roubado ainda funciona.
Onde seu token pode estar escondido
Um token é rotacionado apenas quando todas as suas cópias são substituídas. Verifique cada um destes:
- Cache da máquina local, geralmente escrito por
huggingface-cli loginem~/.cache/huggingface/token. - Variáveis de ambiente como
HF_TOKENouHUGGING_FACE_HUB_TOKENem seu perfil de shell ou arquivos.env. - Segredos de Notebooks em ambientes Google Colab, Kaggle ou Jupyter.
- Segredos de CI/CD em GitHub Actions, GitLab CI ou CircleCI.
- Imagens de contêiner e argumentos de build do Docker.
- Segredos de repositórios do Hugging Face Spaces.
- Auxiliares de credenciais Git, se você autentica no Hub via HTTPS com um token como senha.
- Serviços downstream e integrações de fornecedores que chamam o Hub ou Provedores de Inferência em seu nome.
Perder uma cópia torna a rotação incompleta. A credencial antiga permanece ativa onde foi deixada.
Defina o escopo do novo token corretamente
A Hugging Face oferece três funções de token. Escolha a mais restrita que ainda permita a execução da tarefa.
| Função | Concede | Use para |
|---|---|---|
fine-grained |
Acesso limitado a repositórios, organizações e permissões específicas que você escolher | Aplicativos de produção, jobs de CI, qualquer coisa compartilhada em uma equipe |
read |
Acesso de leitura a repositórios que você já pode ler | Download de modelos privados, execução de inferência |
write |
Leitura mais escrita em repositórios que você pode escrever | Envio de modelos, edição de model cards, uploads de treinamento |
Duas regras das melhores práticas da Hugging Face:
- Crie um token por aplicativo ou uso, para que você possa invalidar um sem quebrar os outros.
- Prefira tokens fine-grained para produção. Se um vazar, seu raio de explosão é limitado aos recursos para os quais você o configurou.
O modelo de escopos do OAuth 2.0 é a mesma ideia aplicada em outros lugares: conceda o mínimo, não o máximo.
Revise a atividade da sua conta
Após a rotação, verifique se há algo que você não fez:
- Lista de Tokens de Acesso. Exclua qualquer token que você não reconheça ou não use mais.
- Repositórios e commits recentes, para modelos, conjuntos de dados ou Spaces que você não alterou.
- Associações e funções em organizações, para adições que você não fez.
- Faturamento e uso, para gastos com Provedores de Inferência que pareçam errados.
- Aplicativos conectados e concessões OAuth, para acesso de terceiros que você não autorizou.
Se algo parecer estranho, entre em contato com security@huggingface.co e rotacione novamente.
Para equipes e CI/CD
A rotação individual é o primeiro passo. As equipes têm alavancas extras:
- Substitua os tokens de CI armazenados por tokens de curta duração. O recurso Trusted Publishers da Hugging Face troca a identidade OIDC de um provedor de CI por um token temporário do Hub no início de cada execução, de modo que nenhum token de longa duração fica em seus segredos de CI.
- Nos planos Team e Enterprise, imponha uma política de tokens apenas fine-grained. Tokens clássicos de leitura/escrita serão rejeitados contra os recursos da sua organização com um
403. - Administradores podem aprovar, negar e revogar tokens com escopo de organização a partir das configurações de gerenciamento de tokens. A revogação no Enterprise é permanente.
- Mantenha um registro de qual token pertence a qual serviço, para que a próxima rotação seja uma consulta, não uma caça.
Para o princípio mais amplo, veja como proteger credenciais de API de agentes de IA e maneiras seguras de armazenar chaves de API entre equipes.
Mantenha o novo token fora do seu tráfego de teste
Uma maneira comum de os tokens vazarem é através de testes e depuração: colados em uma requisição, salvos em uma coleção, commitados por acidente. Manter os valores de autenticação em variáveis de ambiente, em vez de inline nas requisições, reduz esse risco.
Se você chamar a API de Inferência da Hugging Face durante o desenvolvimento, o Apidog armazena o token como uma variável de ambiente e o passa como um token bearer no momento da requisição, para que o segredo fique fora de suas requisições salvas e possa ser trocado em um só lugar após uma rotação. Isso também facilita a verificação de que a rotação funcionou: execute uma chamada com o novo token e confirme que ela é bem-sucedida, depois confirme que o token antigo agora retorna um 401 ou 403. Para saber como os tokens bearer funcionam, veja autenticação básica vs token bearer.
Relacionado: a análise completa da violação da OpenAI e Hugging Face e a documentação de tokens de acesso da Hugging Face.
FAQ
Preciso rotacionar se não fui afetado? Sim. A Hugging Face aconselhou todos os usuários a rotacionar, e após um incidente você não pode confirmar quais credenciais um invasor leu. Rotacionar é barato; assumir que você está seguro não é.
Como sei se meu token foi usado por outra pessoa? Revise sua lista de Tokens de Acesso, commits recentes, alterações na organização, faturamento e aplicativos conectados. A Hugging Face não expõe um rastro de auditoria completo por token em contas pessoais, então trate qualquer token que compartilhou um ambiente com o incidente como suspeito e rotacione-o.
Rotacionar meus scripts vai quebrá-los? Apenas até você atualizar o token. Cada script, notebook e job de CI usando o token antigo precisa do novo valor. É por isso que um token por aplicativo é o padrão recomendado; você os substitui um de cada vez sem uma cascata.
Token de leitura ou token fine-grained? Use read para tarefas simples e pessoais de download e inferência. Use fine-grained para produção, CI e qualquer coisa compartilhada, porque ele limita o acesso aos recursos específicos que você nomeia.
Onde devo armazenar o novo token? Em um gerenciador de segredos ou variável de ambiente, nunca em código-fonte, uma célula de notebook ou um documento compartilhado. Armazene-o uma vez e referencie-o em todos os outros lugares.