Segurança de CI/CD
Segurança do GitHub Actions: uma checklist para reforçar os seus workflows
Um workflow de GitHub Actions executa código de muitos autores com o token do seu repositório, os seus segredos e um caminho até à produção. A maioria dos controlos que o mantêm seguro está integrada no GitHub, mas, por predefinição, estão desligados, são permissivos ou fáceis de configurar mal. Esta checklist aborda cada um: o que configurar, porque é importante e o incidente que mostra o que acontece sem ele.
Atualizado a
A checklist num relance
| Item | O que impede |
|---|---|
GITHUB_TOKEN com privilégio mínimo |
Um passo sequestrado que faz push de código, publica releases ou aciona outros workflows |
| Fixar ou bloquear as actions de terceiros | Uma tag movida que executa o código de um atacante no seu job |
Tratar pull_request_target e workflow_run como privilegiados |
Pwn requests: código de forks executado com os seus segredos |
Manter os dados de eventos fora dos scripts run |
Injeção de scripts através de títulos, nomes de branches e comentários |
| OIDC em vez de chaves de cloud guardadas | Credenciais de longa duração que continuam a funcionar anos depois de serem expostas |
| Environments com revisores obrigatórios | Qualquer branch ou workflow a ler segredos de produção |
Code owners em .github/workflows |
Alterações não revistas ao que o pipeline executa |
| Política de actions permitidas | Actions desconhecidas ou não fixadas em qualquer ponto da organização |
| Sem runners self-hosted em repositórios públicos | Desconhecidos a executar código nas suas máquinas |
| Higiene de caches e artefactos | Caches envenenadas e tokens expostos através de uploads |
| Controlo de egress nos runners | Segredos roubados enviados para o servidor de um atacante |
| Um registo de cada execução | Não saber que builds executaram uma action ou um pacote comprometido |
Código dos workflows
1. Dê ao GITHUB_TOKEN o privilégio mínimo
Cada job recebe um GITHUB_TOKEN, e qualquer passo do job o pode usar. Os repositórios e organizações criados
antes de fevereiro de 2023 podem ainda ter, por predefinição, leitura e escrita em todas as permissões. Defina a predefinição como só de leitura em
Settings → Actions → General → Workflow permissions e conceda depois acesso de escrita por job:
permissions:
contents: read
jobs:
release:
runs-on: ubuntu-latest
permissions:
contents: write
steps:
- uses: actions/checkout@<full-commit-sha>
Tudo o que não indicar passa a none. Para cada permissão e o que as tarefas comuns precisam, consulte
Permissões do GITHUB_TOKEN: privilégio mínimo para cada workflow.
2. Fixe as actions de terceiros a um commit, ou bloqueie-as
Uma tag como @v4 é um ponteiro que o dono da action, ou qualquer pessoa que lhe roube o acesso, pode mover. Dois
incidentes mostram o que isso significa:
- tj-actions/changed-files, março de 2025. Um atacante alterou tags de versão existentes para apontarem para um commit malicioso (CVE-2025-30066). A action era usada por mais de 23 000 repositórios, e a carga maliciosa imprimia segredos da memória do runner nos logs do workflow, que qualquer pessoa pode ler num repositório público.
- aquasecurity/trivy-action, março de 2026. O aviso de segurança da Aqua Security (CVE-2026-33634) indica que 76 das 77 tags de versão da action foram alvo de force push para commits maliciosos. O código injetado era executado antes da análise real, lia segredos da memória do runner e enviava-os, cifrados, para a infraestrutura do atacante.
Os workflows que referenciavam um SHA de commit completo continuaram a executar o código que tinham antes. Mantenha a versão como comentário:
steps:
# Mutable: whoever controls the tag decides what runs
- uses: tj-actions/changed-files@v45
# Immutable: a full commit SHA, with the version as a comment
- uses: tj-actions/changed-files@<full-commit-sha> # v46.0.1
Confirme que o SHA vem do próprio repositório da action, e não de um fork. O GitHub oferece agora algo mais robusto:
lockfiles
de dependências de workflows, com disponibilidade geral desde 28 de outubro de 2026. A extensão de CLI gh actions-lock
escreve .github/workflows/actions.lock, que regista o commit exato de cada action que os seus workflows usam,
incluindo as actions que essas actions chamam, e o GitHub verifica no momento da execução que cada repositório de origem continua a ser aquele que
bloqueou. As chamadas a workflows reutilizáveis não estão abrangidas, pelo que deve fixá-las por SHA. Os administradores podem exigir um lockfile por
política. Nem a fixação nem um lockfile tornam uma action segura: reveja o que bloqueia.
As actions fixadas não se atualizam sozinhas. Deixe o Dependabot propor atualizações, com um período de espera para que uma nova versão tenha alguns dias para ser detetada antes de lhe chegar:
# .github/dependabot.yml
version: 2
updates:
- package-ecosystem: "github-actions"
directory: "/"
schedule:
interval: "weekly"
cooldown:
default-days: 7
3. Trate pull_request_target e workflow_run como privilegiados
Um workflow pull_request vindo de um fork recebe um token só de leitura e nenhum segredo. Um
workflow pull_request_target é executado no contexto do repositório base, com os respetivos segredos e um token que
pode escrever, mesmo quando o pull request vem de um fork. Isso só é seguro enquanto o workflow nunca executar código do
pull request. Se fizer checkout da head do pull request e o compilar, cada script de instalação e cada teste desse pull request
é executado com os seus segredos. O GitHub Security Lab chama a isto
pwn
requests.
- Use
pull_requestpara tudo o que compila ou testa código contribuído. -
Se tiver de se seguir um passo privilegiado, como comentar o pull request, divida-o: um workflow
pull_requestsem privilégios carrega os resultados como artefacto, e um workflowworkflow_runatua sobre eles. Trate esses artefactos como dados não fidedignos, nunca como código a executar. -
Nos repositórios públicos sem política de eventos, o GitHub
bloqueia
pull_request_targetpor predefinição a partir de 2 de dezembro de 2026. Se o voltar a permitir, permita apenas os workflows que precisam dele.
O comprometimento do TanStack, em maio de 2026, começou assim: um workflow pull_request_target executou código de um fork, que
envenenou a cache que um workflow de release restaurou mais tarde, e um token OIDC lido da memória do runner foi usado para publicar
84 versões maliciosas de 42
pacotes.
4. Mantenha os dados de eventos fora dos scripts run
As expressões são expandidas antes de a shell ser executada, pelo que o título de um pull request, o nome de um branch, o corpo de uma issue ou uma mensagem de commit
dentro de run passa a fazer parte do script. Qualquer pessoa que possa abrir um pull request ou uma issue pode então executar
comandos no seu job. Passe o valor através de uma variável de ambiente, para que a shell o trate como dados:
# Vulnerable: the title is pasted into the script before the shell runs
- run: echo "Checking ${{ github.event.pull_request.title }}"
# Safe: the shell reads the title as data
- env:
PR_TITLE: ${{ github.event.pull_request.title }}
run: echo "Checking $PR_TITLE"
O mesmo se aplica a actions/github-script e aos valores escritos em GITHUB_ENV. Os agentes de IA nos
workflows trazem uma nova forma do mesmo problema: o texto de uma issue pode dirigir o agente em vez da shell. Consulte
prompt injection.
Segredos e implementações
5. Use OIDC em vez de chaves de cloud de longa duração
Uma chave de acesso à cloud guardada como segredo funciona até alguém a rodar, o que, depois de uma fuga, é muitas vezes tarde demais. Com o OpenID Connect, o job pede ao GitHub um token de curta duração e troca-o com a AWS, o Azure ou a Google Cloud, cuja política de confiança decide que repositório, branch ou environment pode assumir a função:
jobs:
deploy:
runs-on: ubuntu-latest
environment: production
permissions:
contents: read
id-token: write
steps:
- uses: aws-actions/configure-aws-credentials@<full-commit-sha>
with:
role-to-assume: arn:aws:iam::123456789012:role/deploy
aws-region: us-east-1
Um token de curta duração pode ainda ser roubado de um job em execução, como o TanStack mostrou, mas vale muito menos do que uma chave que nunca expira. Passe os segredos que mantiver ao passo que precisa deles, e não a todo o job, para que outras actions do job não os possam ler. Como os segredos são expostos e os restantes controlos estão em Segredos do GitHub Actions: como são expostos e como os proteger.
6. Coloque a produção atrás de environments com revisores obrigatórios
Um environment tem os seus próprios segredos, e um job que o indique não os pode ler até um revisor obrigatório aprovar a execução. As regras de branches de implementação limitam os branches que o podem sequer usar. Um workflow num branch de funcionalidade, ou um acionado por um pull request, deixa assim de ter caminho até às credenciais de produção.
Governação
7. Exija a revisão de code owners para os ficheiros de workflow
Um ficheiro de workflow decide o que é executado com os seus segredos, pelo que uma alteração a ele merece a mesma revisão que uma alteração ao
acesso à produção. Adicione a pasta ao CODEOWNERS e exija a revisão de code owners num ruleset de branches:
/.github/workflows/ @example-org/platform-security
/.github/actions/ @example-org/platform-security
8. Restrinja as actions que podem ser executadas
Ao nível da enterprise, da organização ou do repositório, a política de actions permitidas pode limitar as actions às do GitHub,
de criadores verificados ou de uma lista que mantém. Desde
agosto
de 2025, pode também exigir a fixação por SHA, pelo que um workflow que use uma action não fixada falha, e bloquear uma action ou versão
específica com uma entrada !, o que ajuda no dia em que uma action que usa é reportada como comprometida.
Runners, caches e artefactos
9. Mantenha os runners self-hosted longe dos repositórios públicos
A referência de utilização segura do GitHub diz que os runners self-hosted quase nunca devem ser usados em repositórios públicos, porque qualquer pessoa pode abrir um pull request e executar código neles. Nos repositórios privados, use runners que começam do zero em cada job: um runner de longa duração guarda tudo o que um job deixa para o seguinte, incluindo uma backdoor. O worm npm Shai-Hulud registou máquinas infetadas como runners self-hosted precisamente por essa razão. Consulte runners geridos vs self-hosted.
10. Proteja as caches contra envenenamento
As caches têm âmbito por branch, e as caches guardadas no branch predefinido podem ser restauradas por todos os outros branches. Código que é executado em qualquer workflow do branch predefinido pode, por isso, escrever entradas de cache que um workflow de release restaura mais tarde, sem precisar de um token de escrita. Mantenha o código não fidedigno fora dos workflows do branch predefinido, evite restaurar caches nos jobs de release e de publicação e, em vez disso, reconstrua aí a partir de um lockfile. Consulte como funciona a cache do GitHub Actions.
11. Trate os artefactos como não fidedignos
actions/checkout mantém o token em disco para comandos git posteriores, a menos que o desative. Carregar o
workspace como artefacto já expôs esse token no passado. Defina persist-credentials: false nos checkouts
que não fazem push, carregue apenas os caminhos de que precisa e nunca execute um artefacto de um pull request num workflow
privilegiado:
- uses: actions/checkout@<full-commit-sha>
with:
persist-credentials: false
Rede e registos
12. Controle a que destinos os jobs se podem ligar
Os runners alojados no GitHub não restringem o tráfego de saída, pelo que o código de um job pode enviar o que lê para qualquer lado. A maioria dos jobs precisa de uma lista curta de destinos: registos de pacotes, registos de contentores, hosts de código-fonte e algumas APIs. Permita esses e bloqueie o resto, e um segredo roubado não tem para onde ir, mesmo num ataque que ninguém viu antes. Uma política de egress não impede segredos impressos nos logs, como no caso tj-actions, e é por isso que deve estar ao lado da fixação, e não em vez dela. Consulte como uma política de egress trava a exfiltração a partir do GitHub Actions.
13. Registe que actions e pacotes cada execução usou
Quando for anunciada a próxima action ou o próximo pacote comprometido, a primeira pergunta é que execuções suas o usaram. Um ficheiro de workflow diz o que uma execução devia usar. Uma tag, um intervalo de versões ou um acerto na cache podem mudar a resposta, e o registo que a decide é o que é feito enquanto o job corre: o commit de cada action, cada pacote obtido ou restaurado de uma cache e as ligações que o job estabeleceu. Consulte SBOM no GitHub Actions.
Ferramentas gratuitas que auditam os seus workflows
A maioria dos itens de workflow acima pode ser verificada automaticamente. Estas ferramentas leem os ficheiros de workflow; não observam um job enquanto é executado.
| Ferramenta | O que verifica |
|---|---|
| zizmor | Análise estática para configurações de GitHub Actions, Dependabot e pre-commit: injeção de templates, triggers perigosos, permissões excessivas, actions não fixadas, commits impostores, envenenamento de cache e credenciais deixadas pelo checkout |
| actionlint |
Um linter para a sintaxe e as expressões dos workflows que também assinala valores não fidedignos usados em scripts inline e executa o
shellcheck nos passos run
|
| OpenSSF Scorecard | Verificações de repositórios, incluindo Dangerous-Workflow (checkouts não fidedignos e injeção de scripts), Token-Permissions e Pinned-Dependencies |
| poutine | O scanner open source da BoostSecurity para pipelines de build, que abrange GitHub Actions, GitLab, Azure DevOps e Tekton e consegue analisar todos os repositórios de uma organização |
| CodeQL | A análise de código do GitHub, que analisa workflows quanto a padrões de injeção e de pwn requests desde 2025 |
Execute uma delas nos pull requests que alteram .github/. Para saber como se articulam com os controlos do runner e as ferramentas
de postura, consulte ferramentas de segurança de CI/CD comparadas e
segurança de CI/CD. Para uma checklist que abrange todo o pipeline e não apenas as definições do GitHub
Actions, consulte a checklist de segurança de pipelines de CI/CD.
Como o CRACI ajuda
O CRACI substitui o runner, não o GitHub Actions: altera runs-on para craci, e os
workflows, segredos, permissões do token e histórico de execuções continuam no GitHub. Cobre os últimos itens desta lista, os que
acontecem enquanto um job é executado:
- Controlo de egress. Uma política de egress decide a que fontes de pacotes, registos e hosts um job pode chegar. É validada antes de o job começar, aplicada no runner e falha em modo fechado, e uma ligação bloqueada gera um alerta.
-
Um registo de cada execução. A SBOM do job lista as GitHub Actions que executou como componentes
pkg:githubfixados ao commit usado, e cada pacote que obteve, incluindo pacotes restaurados de uma cache, com um traço das suas ligações de rede. Quando as tags de uma action são movidas, pode ver que commit cada execução efetivamente executou. - Policy gates. Um build que traga um pacote com uma vulnerabilidade conhecida, incluindo uma CVE específica, pode ser travado.
- Isolamento. Cada job é executado na sua própria máquina virtual, pelo que nada passa para o seguinte.
O CRACI não audita os seus ficheiros de workflow nem analisa código-fonte ou segredos, por isso mantenha um linter de workflows como o zizmor, o secret scanning do GitHub e a sua ferramenta SAST para isso. Executa jobs de GitHub Actions em Linux, e outros sistemas de CI estão no roadmap.
Segurança do GitHub Actions: perguntas frequentes
Como proteger o GitHub Actions?
Defina o GITHUB_TOKEN como só de leitura e conceda escrita por job, fixe ou bloqueie as actions de terceiros, evite executar código de pull requests em workflows pull_request_target, passe os dados de eventos aos scripts através de variáveis de ambiente, use OIDC em vez de chaves de cloud guardadas, coloque os segredos de produção atrás de environments, exija a revisão dos ficheiros de workflow e controle a que destinos os jobs se podem ligar.
Devo fixar as GitHub Actions a um SHA de commit?
Sim, no caso das actions de terceiros. Uma tag pode ser movida para outro código, como aconteceu com tj-actions/changed-files em 2025 e com trivy-action em 2026, ao passo que um SHA de commit completo não pode. Os lockfiles de workflows do GitHub vão mais longe e bloqueiam também as actions que as suas actions chamam.
O pull_request_target é perigoso?
Só é seguro se o workflow nunca executar código do pull request. É executado com os segredos do repositório base e um token de escrita, mesmo para forks, pelo que compilar nele código de um fork entrega ambos a quem abriu o pull request. O GitHub bloqueia-o por predefinição nos repositórios públicos sem política de eventos a partir de 2 de dezembro de 2026.
O que é um pwn request?
O nome que o GitHub Security Lab dá a um workflow privilegiado, normalmente acionado por pull_request_target, que faz checkout e executa código não fidedigno de um pull request, dando ao autor acesso aos segredos e ao token do workflow.
Os lockfiles de workflows são melhores do que a fixação por SHA?
São mais robustos. Um lockfile regista o commit de cada action que um workflow usa, incluindo as transitivas, e o GitHub verifica a identidade do repositório de origem no momento da execução. As chamadas a workflows reutilizáveis não estão abrangidas, pelo que deve fixá-las por SHA.
Que ferramentas gratuitas verificam problemas de segurança nos workflows de GitHub Actions?
O zizmor, o actionlint, o OpenSSF Scorecard e o poutine são gratuitos, e o CodeQL pode analisar workflows como parte da análise de código do GitHub. Leem os ficheiros de workflow; não controlam o que um job faz enquanto é executado.
Veja o que um dos seus workflows executou de facto
Execute um job de GitHub Actions no CRACI e obtenha o commit de cada action, cada pacote obtido e uma política de egress que falha em modo fechado.
Marcar demo