138% di CVE segnalate in più al giorno nel 2026 rispetto all'anno scorso.Novità: Fixboxes sempre attive. Dipendenze vulnerabili, corrette e verificate.

Sicurezza CI/CD

Sicurezza di GitHub Actions: una checklist per rafforzare i Suoi workflow

Un workflow GitHub Actions esegue codice di molti autori con il token del Suo repository, i Suoi secret e un percorso verso la produzione. La maggior parte dei controlli che lo proteggono è integrata in GitHub, ma per impostazione predefinita sono disattivati, troppo permissivi o facili da configurare male. Questa checklist li esamina uno per uno: che cosa impostare, perché conta e l'incidente che mostra che cosa succede senza.

Aggiornato il

La checklist in sintesi

Voce Che cosa impedisce
GITHUB_TOKEN con privilegi minimi Uno step dirottato che esegue push di codice, pubblica release o avvia altri workflow
Fissare o bloccare le action di terze parti Un tag spostato che esegue il codice di un attaccante nel Suo job
Trattare pull_request_target e workflow_run come privilegiati Pwn request: codice di un fork eseguito con i Suoi secret
Tenere i dati degli eventi fuori dagli script run Script injection tramite titoli, nomi di branch e commenti
OIDC invece di chiavi cloud memorizzate Credenziali di lunga durata che funzionano per anni dopo una fuga
Environment con revisori obbligatori Qualsiasi branch o workflow che legge i secret di produzione
Code owner su .github/workflows Modifiche non revisionate a ciò che la pipeline esegue
Policy sulle action consentite Action sconosciute o non fissate in qualsiasi punto dell'organizzazione
Nessun runner self-hosted sui repository pubblici Estranei che eseguono codice sulle Sue macchine
Igiene di cache e artifact Cache avvelenate e token che trapelano attraverso gli upload
Controllo dell'egress sui runner Secret rubati inviati al server di un attaccante
Una registrazione di ogni esecuzione Non sapere quali build hanno eseguito un'action o un pacchetto compromesso

Codice dei workflow

1. Dia a GITHUB_TOKEN i privilegi minimi

Ogni job riceve un GITHUB_TOKEN e qualsiasi step del job può usarlo. I repository e le organizzazioni creati prima di febbraio 2023 possono avere ancora come impostazione predefinita lettura e scrittura su ogni permesso. Imposti il valore predefinito in sola lettura in Settings → Actions → General → Workflow permissions, poi conceda l'accesso in scrittura job per job:

permissions:
  contents: read

jobs:
  release:
    runs-on: ubuntu-latest
    permissions:
      contents: write
    steps:
      - uses: actions/checkout@<full-commit-sha>

Tutto ciò che non elenca diventa none. Per ogni permesso e per ciò che serve alle attività più comuni, consulti permessi di GITHUB_TOKEN: privilegi minimi per ogni workflow.

2. Fissi le action di terze parti a un commit, o le blocchi

Un tag come @v4 è un puntatore che il proprietario dell'action, o chiunque ne rubi l'accesso, può spostare. Due incidenti mostrano che cosa significa:

  • tj-actions/changed-files, marzo 2025. Un attaccante ha modificato tag di versione esistenti facendoli puntare a un commit malevolo (CVE-2025-30066). L'action era usata da oltre 23.000 repository, e il payload stampava i secret presenti nella memoria del runner nei log del workflow, che su un repository pubblico chiunque può leggere.
  • aquasecurity/trivy-action, marzo 2026. L'advisory di Aqua Security (CVE-2026-33634) riporta che 76 dei 77 tag di versione dell'action sono stati spostati con un force push su commit malevoli. Il codice iniettato veniva eseguito prima della scansione reale, leggeva i secret dalla memoria del runner e li inviava, cifrati, all'infrastruttura dell'attaccante.

I workflow che facevano riferimento a un SHA completo del commit hanno continuato a eseguire il codice di prima. Mantenga la versione come commento:

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

Verifichi che lo SHA provenga dal repository dell'action stessa, non da un fork. GitHub offre ora qualcosa di più solido: i lockfile delle dipendenze dei workflow, disponibili per tutti dal 28 ottobre 2026. L'estensione CLI gh actions-lock scrive .github/workflows/actions.lock, che registra il commit esatto di ogni action usata dai Suoi workflow, comprese le action richiamate da quelle action, e GitHub verifica in fase di esecuzione che ogni repository di origine sia ancora quello che Lei ha bloccato. Le chiamate ai workflow riutilizzabili non sono coperte, quindi le fissi con lo SHA. Gli amministratori possono rendere obbligatorio un lockfile tramite policy. Né il pinning né un lockfile rendono sicura un'action: verifichi ciò che blocca.

Le action fissate non si aggiornano da sole. Lasci che Dependabot proponga gli aggiornamenti, con un periodo di attesa che dia a una nuova release qualche giorno per essere intercettata prima che arrivi a Lei:

# .github/dependabot.yml
version: 2
updates:
  - package-ecosystem: "github-actions"
    directory: "/"
    schedule:
      interval: "weekly"
    cooldown:
      default-days: 7

3. Tratti pull_request_target e workflow_run come privilegiati

Un workflow pull_request proveniente da un fork riceve un token in sola lettura e nessun secret. Un workflow pull_request_target viene eseguito nel contesto del repository base, con i suoi secret e un token che può scrivere, anche quando la pull request arriva da un fork. È sicuro solo finché il workflow non esegue mai codice della pull request. Se esegue il checkout della head della pull request e la compila, ogni script di installazione e ogni test di quella pull request viene eseguito con i Suoi secret. GitHub Security Lab le chiama pwn request.

  • Usi pull_request per tutto ciò che compila o testa codice proposto da contributori.
  • Se deve seguire uno step privilegiato, come un commento sulla pull request, lo separi: un workflow pull_request non privilegiato carica i risultati come artifact e un workflow workflow_run agisce su di essi. Tratti quegli artifact come input non attendibile, mai come codice da eseguire.
  • Nei repository pubblici senza una policy sugli eventi, GitHub blocca pull_request_target per impostazione predefinita dal 2 dicembre 2026. Se lo consente di nuovo, lo consenta solo ai workflow che ne hanno bisogno.

La compromissione di TanStack a maggio 2026 è iniziata così: un workflow pull_request_target ha eseguito codice di un fork, che ha avvelenato la cache poi ripristinata da un workflow di release, e un token OIDC letto dalla memoria del runner è stato usato per pubblicare 84 versioni malevole di 42 pacchetti.

4. Tenga i dati degli eventi fuori dagli script run

Le espressioni vengono espanse prima che la shell venga eseguita, quindi il titolo di una pull request, il nome di un branch, il corpo di una issue o un messaggio di commit all'interno di run diventano parte dello script. Chiunque possa aprire una pull request o una issue può allora eseguire comandi nel Suo job. Passi il valore tramite una variabile d'ambiente, così la shell lo tratta come dato:

# 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"

Lo stesso vale per actions/github-script e per i valori scritti in GITHUB_ENV. Gli agenti IA nei workflow aggiungono una nuova forma dello stesso problema: il testo di una issue può guidare l'agente invece della shell. Consulti prompt injection.

Secret e deployment

5. Usi OIDC invece di chiavi cloud di lunga durata

Una chiave di accesso cloud memorizzata come secret funziona finché qualcuno non la ruota, il che dopo una fuga è spesso troppo tardi. Con OpenID Connect il job chiede a GitHub un token di breve durata e lo scambia con AWS, Azure o Google Cloud, la cui trust policy decide quale repository, branch o environment può assumere il ruolo:

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

Un token di breve durata può comunque essere rubato da un job in esecuzione, come ha dimostrato TanStack, ma vale molto meno di una chiave che non scade mai. Passi i secret che conserva allo step che ne ha bisogno anziché all'intero job, così le altre action del job non possono leggerli. Come trapelano i secret e gli altri controlli sono descritti in secret di GitHub Actions: come trapelano e come proteggerli.

6. Metta la produzione dietro environment con revisori obbligatori

Un environment ha i propri secret, e un job che lo nomina non può leggerli finché un revisore obbligatorio non approva l'esecuzione. Le regole sui branch di deployment limitano quali branch possono usarlo. Un workflow su un feature branch, o uno avviato da una pull request, non ha quindi alcun accesso alle credenziali di produzione.

Governance

7. Richieda la revisione dei code owner per i file di workflow

Un file di workflow decide che cosa viene eseguito con i Suoi secret, quindi una sua modifica merita la stessa revisione di una modifica agli accessi di produzione. Aggiunga la cartella a CODEOWNERS e richieda la revisione dei code owner in un ruleset del branch:

/.github/workflows/ @example-org/platform-security
/.github/actions/ @example-org/platform-security

8. Limiti le action che possono essere eseguite

A livello di enterprise, organizzazione o repository, la policy sulle action consentite può limitare le action a quelle di GitHub, di creatori verificati o di un elenco che Lei mantiene. Da agosto 2025 può anche richiedere il pinning SHA, così un workflow che usa un'action non fissata fallisce, e bloccare un'action o una versione specifica con una voce !, utile il giorno in cui un'action che usa viene segnalata come compromessa.

Runner, cache e artifact

9. Tenga i runner self-hosted lontani dai repository pubblici

Il riferimento di GitHub sull'uso sicuro afferma che i runner self-hosted non dovrebbero quasi mai essere usati per i repository pubblici, perché chiunque può aprire una pull request ed eseguirvi codice. Sui repository privati, usi runner che ripartono da zero per ogni job: un runner di lunga durata conserva per il job successivo tutto ciò che un job lascia, backdoor compresa. Il worm npm Shai-Hulud registrava le macchine infette come runner self-hosted proprio per questo motivo. Consulti runner gestiti e runner self-hosted.

10. Protegga le cache dall'avvelenamento

Le cache hanno un ambito per branch, e le cache salvate sul branch predefinito possono essere ripristinate da qualsiasi altro branch. Il codice eseguito in qualsiasi workflow sul branch predefinito può quindi scrivere voci di cache che un workflow di release ripristinerà in seguito, senza bisogno di un token in scrittura. Tenga il codice non attendibile fuori dai workflow del branch predefinito, eviti di ripristinare cache nei job di release e di pubblicazione e in quei job ricompili invece a partire da un lockfile. Consulti come funziona la cache di GitHub Actions.

11. Tratti gli artifact come non attendibili

actions/checkout conserva il token su disco per i comandi git successivi, a meno che Lei non lo disattivi. Caricare il workspace come artifact ha già fatto trapelare quel token in passato. Imposti persist-credentials: false sui checkout che non eseguono push, carichi solo i percorsi che Le servono e non esegua mai un artifact proveniente da una pull request in un workflow privilegiato:

- uses: actions/checkout@<full-commit-sha>
  with:
    persist-credentials: false

Rete e registrazioni

12. Controlli dove i job possono connettersi

I runner ospitati da GitHub non limitano il traffico in uscita, quindi il codice di un job può inviare ovunque ciò che legge. La maggior parte dei job ha bisogno di un breve elenco di destinazioni: registry di pacchetti, registry di container, host del codice sorgente e alcune API. Consenta queste e blocchi il resto, e un secret rubato non avrà dove andare, anche in un attacco mai visto prima. Una policy di egress non ferma i secret stampati nei log, come nel caso di tj-actions, ed è per questo che va affiancata al pinning, non usata al suo posto. Consulti come una policy di egress ferma l'esfiltrazione da GitHub Actions.

13. Registri quali action e pacchetti ha usato ogni esecuzione

Quando viene annunciata la prossima action o il prossimo pacchetto compromesso, la prima domanda è quali delle Sue esecuzioni lo hanno usato. Un file di workflow dice che cosa un'esecuzione doveva usare. Un tag, un intervallo di versioni o un cache hit possono rendere la risposta diversa, e la registrazione che la chiarisce è quella effettuata mentre il job era in esecuzione: il commit di ogni action, ogni pacchetto scaricato o ripristinato da una cache e le connessioni effettuate dal job. Consulti SBOM in GitHub Actions.

Strumenti gratuiti che verificano i Suoi workflow

La maggior parte delle voci sui workflow elencate sopra può essere verificata automaticamente. Questi strumenti leggono i file di workflow; non osservano un job mentre è in esecuzione.

Strumento Che cosa verifica
zizmor Analisi statica della configurazione di GitHub Actions, Dependabot e pre-commit: template injection, trigger pericolosi, permessi eccessivi, action non fissate, commit impostori, avvelenamento della cache e credenziali lasciate dal checkout
actionlint Un linter per la sintassi e le espressioni dei workflow che segnala anche i valori non attendibili usati negli script inline ed esegue shellcheck sugli step run
OpenSSF Scorecard Controlli sul repository, tra cui Dangerous-Workflow (checkout non attendibili e script injection), Token-Permissions e Pinned-Dependencies
poutine Lo scanner open source di BoostSecurity per le pipeline di build, che copre GitHub Actions, GitLab, Azure DevOps e Tekton e può scansionare ogni repository di un'organizzazione
CodeQL Il code scanning di GitHub, che dal 2025 analizza i workflow alla ricerca di pattern di injection e pwn request

Ne esegua uno nelle pull request che modificano .github/. Per capire come si combinano con i controlli sui runner e con gli strumenti di posture, consulti strumenti di sicurezza CI/CD a confronto e sicurezza CI/CD. Per una checklist che copre l'intera pipeline anziché le impostazioni di GitHub Actions, consulti la checklist di sicurezza per le pipeline CI/CD.

Come aiuta CRACI

CRACI sostituisce il runner, non GitHub Actions: Lei cambia runs-on in craci, e workflow, secret, permessi del token e cronologia delle esecuzioni restano in GitHub. Copre le ultime voci di questo elenco, quelle che riguardano il momento in cui un job è in esecuzione:

  • Controllo dell'egress. Una policy di egress decide quali sorgenti di pacchetti, registry e host un job può raggiungere. Viene convalidata prima dell'avvio del job, applicata nel runner e in caso di errore blocca il traffico (fail closed), e una connessione bloccata genera un avviso.
  • Una registrazione di ogni esecuzione. La SBOM del job elenca le GitHub Actions eseguite come componenti pkg:github fissati al commit usato, e ogni pacchetto scaricato, compresi i pacchetti ripristinati da una cache, con una traccia delle sue connessioni di rete. Quando i tag di un'action vengono spostati, Lei può vedere quale commit ha effettivamente eseguito ogni esecuzione.
  • Policy gate. Una build che introduce un pacchetto con una vulnerabilità nota, compresa una CVE specifica, può essere fermata.
  • Isolamento. Ogni job viene eseguito nella propria macchina virtuale, quindi nulla passa al job successivo.

CRACI non verifica i Suoi file di workflow, non scansiona il codice sorgente e non cerca secret, quindi per questo mantenga un linter per workflow come zizmor, il secret scanning di GitHub e il Suo strumento SAST. Esegue job GitHub Actions su Linux, e altri sistemi CI sono in roadmap.

Sicurezza di GitHub Actions: domande frequenti

Come si protegge GitHub Actions?

Imposti GITHUB_TOKEN in sola lettura e conceda la scrittura job per job, fissi o blocchi le action di terze parti, eviti di eseguire codice delle pull request nei workflow pull_request_target, passi i dati degli eventi agli script tramite variabili d'ambiente, usi OIDC invece di chiavi cloud memorizzate, metta i secret di produzione dietro gli environment, richieda la revisione dei file di workflow e controlli a che cosa possono connettersi i job.

Devo fissare le GitHub Actions a uno SHA di commit?

Sì, per le action di terze parti. Un tag può essere spostato su altro codice, come è successo con tj-actions/changed-files nel 2025 e con trivy-action nel 2026, mentre uno SHA completo di commit no. I lockfile dei workflow di GitHub vanno oltre e bloccano anche le action richiamate dalle Sue action.

pull_request_target è pericoloso?

È sicuro solo se il workflow non esegue mai codice della pull request. Viene eseguito con i secret del repository base e un token in scrittura anche per i fork, quindi compilarvi codice di un fork consegna entrambi a chi ha aperto la pull request. Dal 2 dicembre 2026 GitHub lo blocca per impostazione predefinita nei repository pubblici senza una policy sugli eventi.

Che cos'è una pwn request?

Il nome dato da GitHub Security Lab a un workflow privilegiato, di solito avviato da pull_request_target, che esegue il checkout ed esegue codice non attendibile di una pull request, dando al suo autore accesso ai secret e al token del workflow.

I lockfile dei workflow sono migliori del pinning SHA?

Sono più solidi. Un lockfile registra il commit di ogni action usata da un workflow, comprese quelle transitive, e GitHub verifica l'identità del repository di origine in fase di esecuzione. Le chiamate ai workflow riutilizzabili non sono coperte, quindi le fissi con lo SHA.

Quali strumenti gratuiti verificano la sicurezza dei workflow GitHub Actions?

zizmor, actionlint, OpenSSF Scorecard e poutine sono gratuiti, e CodeQL può analizzare i workflow nell'ambito del code scanning di GitHub. Leggono i file di workflow; non controllano ciò che un job fa mentre è in esecuzione.

Veda che cosa ha eseguito davvero uno dei Suoi workflow

Esegua un job GitHub Actions su CRACI e ottenga il commit di ogni action, ogni pacchetto scaricato e una policy di egress che blocca in caso di errore.

Prenota una demo