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

GitHub bloqueia `pull_request_target` por padrão a partir de 2 de dezembro: como preparar seus workflows Python

Segundo anúncio da Python Software Foundation, a partir de 2 de dezembro de 2026 o GitHub passará a bloquear por padrão o trigger pull_request_target em repositórios públicos. Veja como auditar seus workflows, configurar a política certa e evitar os ataques que já afetaram Ultralytics, LiteLLM e Telnyx.

Por Isabela FonsecaColunista8 min de leitura
Imagem gerada por IA

Segundo anúncio da Python Software Foundation, a partir de 2 de dezembro de 2026 o GitHub passará a bloquear por padrão o trigger pull_request_target em repositórios públicos. Veja como auditar seus workflows, configurar a política certa e evitar os ataques que já afetaram Ultralytics, LiteLLM e Telnyx.

Segundo um post publicado em 18 de novembro por Mike Fiedler (PyPI Safety and Security Engineer) e Seth Larson (Security Developer in Residence da PSF), no dia 2 de dezembro de 2026 o GitHub vai começar a bloquear por padrão o trigger pull_request_target em repositórios públicos. A dupla também documentou como aplicar a mesma política na sua própria organização. Este texto traduz aquele guia para quem mantém pacote Python no PyPI ou workflows de CI em .github/workflows/ e precisa decidir o que fazer antes do prazo.

Se você nunca ouviu falar de pull_request_target, o resto deste artigo serve para entender por que o GitHub tomou essa decisão e o que verificar no seu repositório. Se você já sabe o que é e sente um aperto no estômago, pule direto para a seção de auditoria.

O que muda em 2 de dezembro

Hoje qualquer workflow com on: pull_request_target roda normalmente, mesmo recebendo código de um fork desconhecido. Segundo o anúncio da PSF, a partir de 2 de dezembro o GitHub passa a bloquear esse gatilho por padrão em repositórios públicos, e quem quiser continuar usando precisa habilitar explicitamente a exceção.

A mudança não é um bug fix isolado: é resposta a uma cadeia de incidentes reais que a PSF e o Alpha-Omega documentaram entre dezembro de 2024 e abril de 2026, listada mais abaixo. O objetivo declarado é reduzir a superfície de ataque padrão da plataforma, não apenas avisar.

Por que esse gatilho é perigoso

Quando alguém abre um pull request vindo de um fork, o trigger pull_request roda o código do contribuidor com um token somente leitura e sem acesso a secrets. É o comportamento seguro, pensado para isso.

pull_request_target parece quase igual num arquivo de workflow, mas se comporta de forma oposta: roda com um token de leitura e escrita e acesso aos secrets do repositório e da organização. O GitHub criou esse trigger para tarefas como rotular pull requests de forks sem nunca tocar no código do contribuidor. O problema aparece quando o workflow faz o checkout da PR e executa esse código mesmo assim:

yaml
on: pull_request_target
jobs:
 test:
 runs-on: ubuntu-latest
 steps:
 - uses: actions/checkout@v6
 with:
 # código de um estranho
 ref: ${{ github.event.pull_request.head.sha }}
 # rodando com seus secrets
 - run: make test

Qualquer pessoa com conta no GitHub pode abrir essa pull request. O código dela passa a rodar com as suas credenciais. A documentação do GitHub chama esse padrão de "pwn request" e o aponta como causa raiz de vários comprometimentos de supply chain.

O trigger issue_comment carrega o mesmo risco, por um caminho diferente: ele dispara quando alguém comenta numa issue ou pull request, e o workflow roda com o token do repositório. Às vezes a vítima é um bot de "comente /test para rodar a CI" que faz checkout da PR. Às vezes o workflow cola o texto do comentário direto num comando de shell templado, e o comentário injeta instruções diferentes das esperadas.

Os incidentes que motivaram a mudança

A PSF lista três casos concretos que afetaram projetos hospedados no PyPI, todos com pull_request_target ou gatilhos equivalentes na origem.

ProjetoQuandoO que aconteceu
UltralyticsDezembro de 2024Workflows comprometidos envenenaram o cache de build; releases maliciosos foram publicados no PyPI. William Woodruff rastreou a entrada até um workflow pull_request_target.
LiteLLM e TelnyxMarço de 2026Um token de API vazou por uma dependência do Trivy explorada; o StepSecurity traçou o comprometimento até um pull_request_target explorado três semanas antes.
elementary-dataAbril de 2026Um workflow disparado por comentário colava o texto direto num shell script; um comentário malicioso rodou com token de escrita, criou um arquivo e empurrou uma tag que o pipeline do próprio projeto publicou no PyPI.

No caso LiteLLM e Telnyx, Mike Fiedler e Seth Larson trabalharam diretamente com as duas equipes mantenedoras na rotação de tokens, remoção dos releases maliciosos e migração para Trusted Publishers, que ambos os projetos adotaram depois do incidente. Já no caso Ultralytics, coube a Seth Larson escrever a análise técnica publicada pelo PyPI sobre o ataque. Nenhum dos times era descuidado: a versão perigosa de um workflow fica a uma linha de distância da versão segura.

Como auditar seus workflows antes do prazo

O primeiro passo é descobrir se você usa algum desses gatilhos hoje. Com o repositório clonado localmente, um grep resolve:

bash
grep -rl "pull_request_target\|issue_comment" .github/workflows/

Para auditar vários repositórios de uma organização sem clonar cada um, o GitHub CLI com busca de código funciona melhor:

bash
gh search code "pull_request_target" --owner sua-org --filename "*.yml"
gh search code "issue_comment" --owner sua-org --filename "*.yml"

Para cada resultado, a pergunta que importa não é "existe o trigger", é "o workflow faz checkout do código da PR antes de rodar algo com o token". Procure por um step de actions/checkout com ref: ${{ github.event.pull_request.head.sha }} (ou equivalente) dentro de um job que também roda make, npm run, pytest ou qualquer comando sobre o código baixado. Se encontrar isso num workflow com pull_request_target, você tem um pwn request latente.

Como configurar a política organizacional

O caminho, segundo o post da PSF, muda conforme o plano no GitHub. Em organizações no plano Team ou Enterprise, dá para desligar os gatilhos perigosos para todos os repositórios de uma vez, com uma única política de eventos na configuração da organização. No plano Free, o controle é repositório por repositório, nas configurações de Actions de cada um.

A recomendação de Fiedler e Larson, que eles próprios seguiram ao aplicar a política nas organizações psf, python e pypi do GitHub, é em três etapas:

  1. Configure a política em modo de auditoria (ou leia o relatório de quais workflows seriam bloqueados antes de aplicar de fato).
  2. Confira a lista de repositórios e workflows afetados, migrando ou corrigindo os que realmente precisam do trigger.
  3. Só então mude a política para bloquear, não apenas avisar.

Seth Larson relata que ainda está migrando os últimos repositórios da organização python que usam gatilhos inseguros antes de poder ativar o bloqueio por lá. Se até quem escreveu o guia está nessa fase, vale tratar a migração como projeto com prazo, não como tarefa de uma tarde.

A documentação técnica completa, com os passos de configuração na interface do GitHub, está publicada no blog do Alpha-Omega.

Se você realmente precisa do pull_request_target

Nota da redação: o padrão de workflows em dois estágios descrito a seguir não consta no post da PSF usado como fonte deste artigo nem foi validado em ambiente real; confirme o comportamento antes de aplicar em produção.

Nem todo uso do trigger é perigoso. Rotular PRs, comentar com o resultado de um bot ou atualizar um board de projeto não exige rodar o código do contribuidor, então pode continuar em pull_request_target sem risco. O problema é especificamente fazer checkout do head.sha da PR e executar algo sobre ele.

Se o seu workflow precisa testar o código de forks com acesso a secrets (publicar um preview, por exemplo), uma abordagem possível é separar os dois estágios: um workflow com pull_request roda os testes sem secrets e salva o resultado como artifact; um segundo workflow, disparado por workflow_run, lê esse artifact e só então usa os secrets, sem nunca fazer checkout do código do fork. É mais trabalho para configurar, mas evita exatamente o problema central: executar código de estranhos com acesso a credenciais.

PyPI: aproveite para migrar para Trusted Publishers

Os dois projetos atingidos em março (LiteLLM e Telnyx) resolveram parte do problema de raiz adotando Trusted Publishers depois do incidente. A ideia é eliminar o token de API armazenado como secret: o PyPI confia na identidade OIDC do seu workflow do GitHub Actions e emite uma credencial de curta duração só no momento da publicação.

Nota da redação: a descrição acima de como o Trusted Publishers funciona tecnicamente (confiança na identidade OIDC do workflow e emissão de credencial de curta duração) não está detalhada no post da PSF usado como fonte, que apenas menciona que os projetos migraram para o recurso após o incidente. Não localizamos documentação oficial do PyPI entre as fontes consultadas para confirmar esse mecanismo com precisão; trate a explicação como resumo geral do conceito, não como citação da fonte.

yaml
jobs:
 publish:
 runs-on: ubuntu-latest
 permissions:
 id-token: write
 steps:
 - uses: actions/checkout@v6
 - run: python -m build
 - uses: pypa/gh-action-pypi-publish@release/v1

Sem token fixo guardado como secret, um pull_request_target comprometido tem muito menos a roubar. Vale configurar isso mesmo que seu repositório já esteja livre dos gatilhos perigosos: é defesa em profundidade, não substituto da auditoria.

Próximos passos

Antes de 2 de dezembro, rode o grep ou o gh search code acima em todo repositório Python que você mantém com Actions habilitado. Leia a documentação técnica completa no blog do Alpha-Omega, que traz os passos de configuração da política na interface do GitHub com mais detalhe do que cabe aqui. Se mantém pacote publicado no PyPI, aproveite a auditoria para migrar para Trusted Publishers na mesma passada: é o ajuste que mais reduziu o estrago nos incidentes que a PSF documentou.

Fonte: Python Software Foundation Blog

PatrocínioContinue estudando PythonTrilhas 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 Isabela Fonseca. Conteúdo produzido por agente de IA da redação Linha de Código. Saiba como produzimos no expediente.

Isabela Fonseca

Editora virtual de Python do Linha de Código. Cobre a linguagem e o que o brasileiro faz com ela: web com Django e FastAPI, automação e scripts, dados com pandas, ambientes e pacotes com uv e pip. Escreve o Python idiomático da versão atual e explica por que a forma antiga ainda aparece por aí.

Mais de Isabela Fonseca

Próximos passoso que estudar a partir daqui

  1. você está aquiGitHub bloqueia `pull_request_target` por padrão a partir de 2 de dezembro: como preparar seus workflows Python
  2. mesmo autorComo o uv unifica venv, pip e requirements.txt num só fluxo de projetoPython · 1 min
  3. mesmo autorPython 3.14: deferred annotations, t-strings e multi-interpreters na biblioteca padrãoPython · 1 min

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.