Durante anos, o SHA pinning no GitHub Actions foi considerado uma das principais defesas contra ataques à cadeia de suprimentos de software. A técnica consiste em fixar uma ação em um identificador criptográfico de commit, impedindo que alterações posteriores em tags ou branches modifiquem silenciosamente o código executado pelos pipelines de integração contínua. Entretanto, ataques registrados em 2026 demonstraram que essa proteção tem limitações importantes: mesmo um commit imutável pode ser utilizado para executar código malicioso quando sua origem não é devidamente verificada.
O problema ganhou destaque após incidentes envolvendo projetos populares, como o Trivy, ferramenta de código aberto utilizada para identificar vulnerabilidades em imagens de containers, e outras ações do ecossistema GitHub. Os ataques evidenciaram uma diferença fundamental entre garantir que determinado código não mudou e comprovar que ele realmente veio de um repositório legítimo. Essa distinção coloca em discussão três aspectos da segurança: autoria, associação ao projeto original e integridade das dependências executadas durante o pipeline.
A questão também se torna mais relevante com a expansão do desenvolvimento automatizado e dos agentes de inteligência artificial, que conseguem produzir e enviar alterações em grande velocidade. Quando a revisão humana não acompanha esse ritmo, mecanismos de validação aparentemente confiáveis podem deixar passar componentes comprometidos. Nesse cenário, os novos arquivos de bloqueio de dependências do GitHub representam um avanço, mas não eliminam todos os riscos.
Como funciona o contorno ao SHA pinning no GitHub Actions
Para entender a limitação, é necessário observar como o GitHub organiza os repositórios e seus respectivos forks.
Quando um desenvolvedor cria um fork, a plataforma estabelece uma relação entre o repositório original e sua cópia. Embora sejam repositórios diferentes, eles compartilham parte do histórico de commits. Isso permite que um mesmo objeto Git seja reconhecido dentro da rede de repositórios relacionada ao projeto original.
O comportamento é legítimo e faz parte do funcionamento colaborativo da plataforma. O problema aparece quando essa característica é explorada para introduzir um commit malicioso em um contexto no qual a validação considera apenas a existência e o formato do identificador SHA.
Imagine uma organização que utiliza uma política obrigatória de fixação de commits. Um desenvolvedor configura seu workflow para executar uma ação por meio de uma referência semelhante a actions/checkout@<escape>SHA_DE_40_CARACTERES</escape>.
A política pode confirmar que a referência possui os 40 caracteres hexadecimais esperados, mas isso não significa necessariamente que o commit pertence à árvore oficial do projeto indicado no arquivo YAML. Dependendo da forma como a referência é resolvida, um commit introduzido por um fork pode ser aceito sem que sua proveniência seja devidamente comprovada.
Assim, o atacante não precisa necessariamente modificar um commit legítimo ou movimentar uma tag existente. Pode explorar a relação entre repositórios para fazer com que um código de origem questionável seja apresentado como uma dependência aparentemente válida.
Essa diferença é importante porque o SHA pinning tradicional protege contra a movimentação de referências, mas não constitui, isoladamente, uma declaração confiável sobre a identidade de quem produziu o código.

Os ataques ao Trivy e ao actions-cool/issues-helper em 2026
O incidente envolvendo o Trivy, em março de 2026, mostrou como uma ferramenta amplamente utilizada pode se transformar em um vetor de comprometimento da infraestrutura de desenvolvimento.
Em 19 de março, integrantes da campanha identificada como TeamPCP utilizaram credenciais comprometidas para adulterar componentes do ecossistema. O ataque atingiu o scanner Trivy, a ação aquasecurity/trivy-action e a ação aquasecurity/setup-trivy.
Os invasores modificaram 76 das 77 tags de versão do trivy-action e todas as sete tags do setup-trivy, direcionando referências existentes para commits maliciosos. Também foi publicada uma versão comprometida do scanner, identificada como Trivy 0.69.4.
O código malicioso foi projetado para roubar credenciais disponíveis no ambiente de execução. Isso é particularmente perigoso porque ferramentas de segurança frequentemente recebem permissões para acessar repositórios, tokens, configurações de nuvem e outros recursos necessários para realizar suas tarefas.
O ataque demonstrou que comprometer uma ferramenta de segurança pode oferecer aos invasores acesso privilegiado a ambientes que, teoricamente, deveriam estar protegidos.
Outro episódio citado nas discussões sobre a segurança das dependências do GitHub Actions envolve o actions-cool/issues-helper, em maio de 2026. O caso reforçou a preocupação com o uso de ações de terceiros para acessar credenciais e informações disponíveis nos runners.
A principal lição desses incidentes é que uma dependência aparentemente confiável pode se transformar em um ponto de entrada para o roubo de segredos. Por isso, não basta verificar se o identificador do commit está fixado: também é necessário investigar sua origem, a identidade dos responsáveis e o comportamento do código executado.
Imutabilidade não é proveniência
A distinção entre esses dois conceitos é central para compreender as limitações do pinning.
Imutabilidade significa que determinado conteúdo não será alterado depois de identificado por seu hash. Se uma equipe revisa um commit e fixa seu SHA completo, alterações posteriores no código não modificam automaticamente aquela referência.
Já a proveniência diz respeito à origem do componente: quem o produziu, em qual repositório foi desenvolvido, como foi publicado e se existe uma cadeia confiável entre o código revisado e aquele efetivamente executado.
A especialista Erika Heidi, da Chainguard, destaca justamente essa diferença nas discussões sobre segurança da cadeia de suprimentos. Congelar um commit não comprova que seu autor é legítimo nem que o repositório de origem corresponde ao projeto esperado.
Em termos simples, um hash pode garantir que você está executando exatamente o mesmo código de ontem, mas não garante que esse código era confiável ontem.
Essa diferença também explica por que a segurança moderna de CI/CD precisa combinar fixação de versões, validação de identidade, verificação de proveniência e controle das dependências transitivas.
As três falhas de segurança que o SHA pinning no GitHub Actions não resolve
O problema não está no funcionamento matemático do SHA, mas naquilo que as políticas de segurança verificam antes de permitir a execução de uma dependência. Existem três limitações estruturais que merecem atenção.
1. Autoria: o hash não identifica quem escreveu o código
Um commit SHA identifica um objeto Git, mas não funciona como uma certificação independente da identidade de seu autor.
O Git permite que informações de autoria e de confirmação sejam registradas nos metadados do commit. Esses dados, por si só, não comprovam que determinada pessoa realmente produziu ou autorizou aquela alteração.
Além disso, a existência de um commit em um fork não significa que ele tenha sido aprovado pelos mantenedores do projeto original.
Isso cria uma situação perigosa: uma política pode exigir referências imutáveis de 40 caracteres e, ainda assim, aceitar um identificador associado a um commit que não deveria ser considerado parte da dependência oficial.
A solução exige mais do que conferir o formato do hash. É necessário verificar a procedência do commit, sua relação com o repositório original e, quando disponível, suas assinaturas e atestações de publicação.
2. Associação ao projeto: o SHA não comprova a origem esperada
Outra limitação está nas políticas organizacionais que exigem o uso de hashes completos.
Esse tipo de controle é importante para impedir referências curtas, tags móveis e branches como @main. Entretanto, uma verificação baseada exclusivamente no formato do identificador não confirma se o commit está efetivamente presente no histórico oficial do projeto.
Em outras palavras, um SHA válido não é necessariamente um SHA confiável.
A rede de forks do GitHub torna essa distinção especialmente importante. Como repositórios relacionados podem compartilhar objetos Git, a simples possibilidade de localizar determinado commit na plataforma não comprova que ele foi publicado ou aprovado pelo mantenedor legítimo.
O risco aumenta quando equipes automatizam a atualização de dependências sem verificar a origem dos novos identificadores. Uma atualização pode passar pelos controles de formato e introduzir código que nunca integrou a árvore oficial do projeto.
3. Execução em tempo real: o commit não congela todas as dependências
A terceira limitação envolve as GitHub Actions baseadas em Docker.
Quando uma ação utiliza um Dockerfile, o código do arquivo pode estar fixado em um commit SHA, mas isso não significa que todos os componentes utilizados durante a construção da imagem também estejam congelados.
Uma instrução como FROM node:latest, por exemplo, pode buscar uma imagem diferente em execuções posteriores. O mesmo problema aparece quando o processo de construção instala pacotes externos sem versões rigorosamente fixadas.
Dependências baixadas durante a execução também podem mudar, mesmo que o código principal da ação permaneça idêntico.
Isso significa que o SHA pinning protege apenas uma parte da cadeia de execução. Para obter reprodutibilidade real, é necessário controlar também as imagens-base, os pacotes, os artefatos e as ferramentas utilizadas durante a construção.
O desenvolvimento orientado por agentes de IA amplia essa preocupação. Agentes podem gerar workflows, atualizar dependências e criar alterações em sequência, aumentando a quantidade de mudanças que precisam ser revisadas. Sem controles adicionais, a velocidade da automação pode superar a capacidade de auditoria das equipes.
Os arquivos de bloqueio do GitHub e o futuro da segurança em CI/CD
Diante dessas limitações, o GitHub avançou em 2026 com os workflow dependency lockfiles, conhecidos como arquivos de bloqueio de dependências de workflow.
O recurso chegou à disponibilidade geral em 28 de outubro de 2026, trazendo uma abordagem mais abrangente para controlar as ações utilizadas nos pipelines.
A principal diferença em relação ao pinning tradicional é que o bloqueio não registra somente o identificador do commit. Ele também mantém informações sobre a identidade do repositório de origem.
O arquivo .github/workflows/actions.lock registra as dependências utilizadas pelo workflow, incluindo suas dependências transitivas. Cada entrada contém informações como:
- Referência original: tag ou branch utilizada para identificar a ação.
- Commit: hash completo correspondente ao código que deverá ser executado.
- Identificador do proprietário: número de identificação da conta proprietária do repositório.
- Identificador do repositório: número que permite verificar a identidade do projeto de origem.
Essa estrutura representa um avanço importante porque dificulta a substituição de uma dependência por um commit criado exclusivamente em um fork impostor.
Durante a execução, o GitHub verifica se a dependência corresponde à identidade do repositório registrada no arquivo de bloqueio. Além disso, exige que o commit esteja disponível em um branch do repositório original.
Na prática, isso acrescenta uma camada de verificação de proveniência que não existia no modelo tradicional de fixação isolada de SHA.
O que os workflow lockfiles resolvem e o que permanece vulnerável
O recurso também facilita a manutenção dos pipelines. A ferramenta de linha de comando GitHub CLI, por meio da extensão gh-actions-lock, permite gerar o arquivo de bloqueio e acompanhar as dependências utilizadas.
Outro benefício é a integração com o Dependabot. Quando uma atualização de ação é proposta, o arquivo de bloqueio correspondente pode ser regenerado no mesmo pull request, mantendo as referências sincronizadas.
Administradores de organizações, repositórios e ambientes corporativos também podem exigir a presença do arquivo por meio de políticas específicas. Isso reduz a dependência de procedimentos manuais e ajuda a padronizar a proteção entre diferentes projetos.
Entretanto, existem limitações importantes.
Primeiro, o bloqueio não certifica que uma dependência é segura. Ele verifica a identidade do repositório e a correspondência dos commits, mas um projeto legítimo pode ser comprometido. Se a equipe bloquear uma versão maliciosa de uma ação oficial, o mecanismo continuará garantindo que exatamente aquela versão seja executada.
Segundo, o recurso não controla todos os elementos da construção. Imagens Docker, pacotes externos e outros componentes obtidos durante a execução ainda precisam de mecanismos próprios de fixação e verificação.
Terceiro, a proteção depende da participação dos mantenedores. Recursos relacionados a releases imutáveis precisam ser habilitados pelos responsáveis pelos projetos. Portanto, nem toda dependência de terceiros oferece automaticamente o mesmo nível de garantia.
Quarto, existe uma limitação de compatibilidade. Na disponibilização geral anunciada em outubro de 2026, os workflow lockfiles não estavam disponíveis no GitHub Enterprise Server.
Também é importante observar que os arquivos de bloqueio não substituem automaticamente todos os controles de segurança. Chamadas para workflows reutilizáveis, por exemplo, precisam de atenção própria e continuam exigindo referências adequadamente fixadas.
O avanço é significativo, mas não representa uma solução definitiva para os ataques à cadeia de suprimentos. O próprio GitHub reconhece que bloquear dependências não significa determinar se elas são confiáveis.
Conclusão e boas práticas para proteger seus pipelines
Os ataques registrados entre 2025 e 2026 mostram que a segurança das dependências utilizadas em pipelines precisa evoluir além da simples fixação de versões.
O caso do tj-actions/changed-files, em março de 2025, demonstrou o perigo das tags móveis. Mais de 23 mil repositórios utilizavam a ação, e os invasores conseguiram redirecionar referências de versões para código malicioso. Nesse episódio, o SHA pinning funcionou: quem utilizava um commit legítimo previamente fixado não foi afetado pela movimentação das tags.
Já os incidentes envolvendo Trivy e actions-cool/issues-helper reforçaram que o comprometimento de ferramentas populares pode transformar ambientes de integração contínua em pontos de coleta de credenciais.
É importante distinguir esses ataques da exploração por commits de forks: a movimentação de tags não é a mesma técnica que introduzir um SHA aparentemente válido cuja origem não corresponde ao repositório oficial. São problemas diferentes, mas demonstram por que a segurança precisa considerar toda a cadeia de confiança.
Para desenvolvedores e equipes de DevOps, algumas medidas são fundamentais:
- Adote workflow lockfiles: utilize os arquivos de bloqueio do GitHub para registrar as dependências diretas e transitivas dos workflows.
- Verifique a proveniência dos commits: confirme que os hashes utilizados pertencem ao repositório oficial e não a forks de terceiros.
- Audite ações de terceiros: examine o código-fonte, o histórico de alterações, as permissões solicitadas e o comportamento das dependências.
- Proteja as imagens Docker: fixe imagens-base por digest e controle as versões dos pacotes instalados durante a construção.
- Restrinja permissões: configure o
GITHUB_TOKENcom o menor conjunto de permissões necessário e evite disponibilizar credenciais desnecessariamente. - Utilize dependências verificadas: mantenha um catálogo interno de GitHub Actions aprovadas, com responsáveis identificados e processos de revisão.
- Monitore os pipelines: acompanhe alterações inesperadas, conexões externas e comportamentos anormais dos runners.
O SHA pinning continua sendo uma camada importante de proteção, mas não deve ser tratado como garantia absoluta de segurança. A imutabilidade do código precisa estar acompanhada da verificação de sua origem, da identidade de quem o publicou e da integridade dos componentes utilizados durante a execução.
Com a popularização dos agentes de IA e a crescente automação do desenvolvimento, essa responsabilidade se torna ainda maior. Um pipeline comprometido pode oferecer acesso a tokens, credenciais de nuvem, repositórios privados e infraestrutura corporativa.
