SHA pinning não comprova a origem

Fixar uma ação do GitHub Actions por seu identificador SHA impede que uma tag ou branch móvel altere silenciosamente o código selecionado. Mas o hash, sozinho, não confirma quem produziu o código nem se ele pertence ao repositório legítimo do projeto. Ataques à cadeia de suprimentos registrados em 2026 expuseram essa diferença.

Repositórios relacionados no GitHub podem compartilhar objetos Git. Por isso, verificar apenas se uma referência tem 40 caracteres hexadecimais não prova que o commit veio da árvore oficial do projeto. Um código associado a um fork pode passar pela checagem de formato sem ter sido aprovado pelos mantenedores esperados.

Incidentes expuseram riscos em pipelines

Em março de 2026, a campanha TeamPCP usou credenciais comprometidas para adulterar componentes ligados ao Trivy, scanner de vulnerabilidades usado em imagens de contêineres. O ataque atingiu também as ações aquasecurity/trivy-action e aquasecurity/setup-trivy, usadas em workflows do GitHub Actions.

Os invasores alteraram 76 das 77 tags do trivy-action e as sete tags do setup-trivy, além de publicar a versão comprometida Trivy 0.69.4. O código malicioso buscava roubar credenciais disponíveis no ambiente de execução. Em maio de 2026, um incidente com actions-cool/issues-helper também reforçou a preocupação com ações de terceiros e acesso a segredos nos runners.

Integridade e proveniência são controles diferentes

Um hash identifica o conteúdo de um commit e ajuda a garantir que a referência fixada não mude. Proveniência responde a outras perguntas: de onde veio o conteúdo, quem o publicou e se está vinculado ao projeto esperado. Metadados de autoria registrados no Git, por si sós, não comprovam a identidade de quem criou ou autorizou uma alteração.

O pinning também não congela necessariamente os componentes usados durante a construção de uma ação baseada em Docker. Um Dockerfile fixado pode buscar uma imagem-base mutável, como FROM node:latest, ou instalar pacotes externos sem versões determinadas. Assim, partes da cadeia de execução continuam sujeitas a mudanças.

Arquivos de bloqueio acrescentam verificações

Em 28 de outubro de 2026, o GitHub tornou os workflow dependency lockfiles disponíveis de forma geral. O arquivo .github/workflows/actions.lock registra as dependências do workflow, inclusive as transitivas, com a referência original, o hash completo do commit e identificadores do proprietário e do repositório de origem.

Durante a execução, o GitHub verifica a identidade do repositório e exige que o commit esteja disponível em um branch do projeto original. O arquivo pode ser gerado com a extensão gh-actions-lock do GitHub CLI e integrado ao Dependabot. O recurso reforça a verificação de proveniência, mas equipes ainda precisam auditar dependências, imagens de contêineres e permissões dos pipelines.

Confira mais em: https://guiadeti.com.br/noticias/sha-pinning-github-actions-origem-dependencias/