A ação de terceiro que rodava o código que quisesse
Capivara·

A ação de terceiro que rodava o código que quisesse

4 min de leitura← Voltar para timeline

O furo que passa em toda revisão de código

O workflow de segurança do Capivara rodava três scanners em runner self-hosted. Cada scanner era uma action de terceiro, referenciada pelo jeito normal:

steps:
  - uses: actions/checkout@v4
  - uses: gitleaks/gitleaks-action@v2

Isso lê bem e passa em qualquer revisão. Também significa que o dono daquele repositório pode apontar a tag v4 para outro commit quando quiser — e o próximo build do Capivara executa o código novo, dentro do runner, com o GITHUB_TOKEN da organização disponível no ambiente.

As ferramentas que uso neste projeto ficam na loja de skills — a primeira é grátis.

Nada foi comprometido. O problema é de desenho: quando o código de terceiro roda com permissões suas, “a versão” precisa ser um identificador que ninguém consegue mover.

Tag é ponteiro, SHA é conteúdo

Uma tag do Git é uma referência mutável. O v4 existe hoje e pode existir apontando para outro commit amanhã, sem aviso e sem mudança visível no seu repositório.

Um SHA de commit não. Ele deriva do conteúdo da árvore: se o código mudar, o hash muda. Referenciar o hash é a única forma de dizer “esta linha de código exata” e ser verdade.

# antes: ponteiro móvel
- uses: actions/checkout@v4
- uses: gitleaks/gitleaks-action@v2

# depois: conteúdo imutável, com a versão legível como comentário
- uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
- uses: gitleaks/gitleaks-action@ff98106e4c7b2bc287b24eaf42907196329070c7 # v2.3.9

O comentário não é decoração: sem ele, daqui a seis meses ninguém sabe se aquele hash é a v4.2.2 ou um commit qualquer. Com ele, a revisão continua legível e a execução continua reprodutível.

O mesmo raciocínio no health-check

O commit não mexeu só nos workflows. O capivara-health-check.py — o script que vigia o ecossistema e grita quando algo cai — também mudou.

O script consultava um endpoint local para saber se os serviços estavam no ar. A questão é que ele agora precisa distinguir dois mundos que respondem no mesmo endereço: o serviço de verdade e um proxy de loopback que pode estar atendendo no lugar dele. Sem essa distinção, um proxy local respondendo 200 fazia o vigia declarar saúde perfeita enquanto o backend real estava morto.

A allowlist de loopback existe para o script saber quando está falando com o host local legítimo e quando está falando com outra coisa que se apresentou no mesmo IP.

Por que isso rende mais que um scanner novo

A tentação, ao endurecer a supply chain, é acrescentar mais uma ferramenta de análise. O ganho real deste commit é menor e mais durável: eliminar a categoria de ataque em vez de detectá-la.

Depois do pin:

  • trocar o código de uma action exige um commit novo no seu repositório, que aparece no diff e passa por revisão;
  • o build de hoje e o de daqui a um ano executam bytes idênticos;
  • e o comentário com a versão mantém a manutenção possível — atualizar é trocar hash e comentário juntos, de propósito.

O que fica de método

Todo uses: sem SHA é uma linha de código que alguém de fora pode reescrever no seu CI. Vale tratar como dependência de produção, não como configuração.

O teste prático é simples: abra o workflow, procure @v e conte. Cada ocorrência é uma decisão de confiança que você delegou a um ponteiro que não controla.

Leia também

Mesmo projeto, mesma trilha — as histórias se conectam.

Próximo passo

Se isto te serviu, tem mais: escrevo sobre o mesmo assunto nos outros projetos, e a loja tem as ferramentas que eu uso aqui.

Sem spam, descadastro de um clique. Também estou aqui: Loja de skills · Portfólio