GitHub Actionsi töö on hea koht saladuste varastamiseks. Selles on juurutusvõtmed, registrite tokenid ja pilve mandaadid ning see käitab koodi, mille keegi teine kirjutas minut tagasi: kolmanda osapoole actionid, paketid ja nende installiskriptid. GitHubi saladuste käsitlus kaitseb õnnetuste eest. See ei ole loodud peatama koodi, mis juba töö sees jookseb.
See postitus käsitleb, kuidas saladused GitHub Actionsis toimivad, viit viisi, kuidas need praktikas lekivad, ja kontrolle, mis igaühe neist sulgevad.
Kuidas GitHub Actionsi saladused toimivad
Saladused asuvad kolmel tasemel: organisatsioon, repositoorium ja keskkond. Kui sama nimi on olemas mitmel tasemel, võidab kõige spetsiifilisem: keskkond repositooriumi üle, repositoorium organisatsiooni üle.
Mõned piirangud ja reeglid, mida tasub teada:
- Suurus ja arv. Kuni 1000 organisatsiooni saladust, 100 repositooriumi saladust ja 100 keskkonna saladust, igaüks kõige rohkem 48 KB. Töövoog näeb kõiki repositooriumi ja keskkonna saladusi, kuid organisatsiooni saladustest ainult esimest 100 tähestikulises järjekorras.
- Forkid ei saa midagi. Peale
GITHUB_TOKEN-i ei edastata saladusi töövoogudele, mille käivitab forkist tulev pull request. - Dependabotit koheldakse nagu forki. Dependaboti käivitatud töövood saavad ainult lugemisõigusega tokeni ja ainult Dependaboti saladused, mitte Actionsi saladusi.
- Korduvkasutatavatele töövoogudele tuleb saladused edasi anda.
secrets: inheritannab need kõik kaudselt edasi sama organisatsiooni või ettevõtte (enterprise) piires. Keskkonna saladusi ei saa edastadaworkflow_call-i kaudu. - Keskkonnad piiravad juurdepääsu. Kohustuslike ülevaatajatega ei saa töö keskkonna saladusi lugeda enne, kui keegi selle heaks kiidab. Juurutusharude reeglid piiravad, millised harud üldse saavad keskkonda kasutada.
Mida maskeerimine teeb ja mida mitte
GitHub eemaldab saladuste väärtused logidest, kuid eemaldamine sõltub täpse vaste leidmisest. GitHubi enda dokumentatsioon loetleb, kus see ebaõnnestub:
- saladus struktureeritud andmete sees, näiteks JSON-is või YAML-is
- saladusest tuletatud väärtus, näiteks teise tokeni vastu vahetatud token, kui te seda ei registreeri käsuga
::add-mask:: - teisendatud saladus, näiteks base64-kodeeritud
Maskeerimine kaitseb saladuse ekslikult väljaprintimise eest. See ei tee midagi koodi vastu, mis saladuse enne kodeerib.
Kuidas saladused töövoogudest lekivad
1. Ohustatud action prindib need välja
Märtsis 2025 ohustas ründaja actionit tj-actions/changed-files (CVE-2025-30066), mida kasutas üle 23 000 repositooriumi. Ta tõstis actioni olemasolevad versioonisildid pahatahtlikule commit'ile, nii et iga töövoog, mis viitas sildile, näiteks @v45, käivitas ründaja koodi. Turvalised olid ainult täieliku commit'i SHA-ga kinnitatud töövood.
Kasulik koormus luges saladused runneri mälust ja printis need töö logisse, kaks korda base64-kodeerituna, et maskeerimine neid ei tabaks. Avalikes repositooriumides saab neid logisid lugeda igaüks. Rünnak sai alguse teisest actionist, reviewdog/action-setup (CVE-2025-30154), ja enne seda isiklikust juurdepääsutokenist, mis varastati pull_request_target töövoo kaudu.
2. pull_request_target töövoog käitab ebausaldusväärset koodi
pull_request_target jookseb baasrepositooriumi kontekstis, selle saladustega ja kirjutamisõigusega tokeniga, ka siis, kui pull request tuleb forkist. See on turvaline ainult seni, kuni töövoog ei käivita kunagi pull requesti koodi. Kui töövoog võtab välja pull requesti head'i ja ehitab selle, saab igaüks, kes saab pull requesti avada, lugeda kõiki töövoo saladusi. GitHub Security Lab nimetab neid „pwn request'ideks“.
GitHub on seda järk-järgult piiranud. Alates detsembrist 2025 kasutab pull_request_target alati vaikeharu töövoofaili. Alates juulist 2026 keeldub actions/checkout forkide koodi välja võtmast pull_request_target töövoogudes, mis kasutavad teadaolevalt ohtlikke mustreid, ning töövoogude käivitamise kaitsed, mis on üldiselt saadaval alates septembrist 2026, keelavad alates 2. detsembrist 2026 pull_request_target-i vaikimisi avalikes repositooriumides, millel pole sündmuste poliitikat.
3. Ebausaldusväärne sisend süstitakse skripti
Töövoo avaldised laiendatakse enne shelli käivitumist. Selline samm:
- run: echo "Title: ${{ github.event.issue.title }}"
käivitab kõik, mida issue pealkiri sisaldab. Ründaja avab issue, mille pealkiri on shellikäsk, ja töö käivitab selle, töö saladused käeulatuses. Andke ebausaldusväärsed väärtused hoopis keskkonnamuutuja kaudu, nii et shell käsitleb neid andmetena:
- env:
TITLE: ${{ github.event.issue.title }}
run: echo "Title: $TITLE"
4. Vahemälud ja artefaktid kannavad need välja
- Artefaktid. 2024. aastal näitas Unit 42 ArtiPACKED uuring, et
actions/checkoutkirjutab vaikimisiGITHUB_TOKEN-i faili.git/config, nii et tööala üleslaadimine artefaktina lekitab tokeni igaühele, kes saab selle alla laadida.upload-artifacton alates septembrist 2024 peitfailid vaikimisi välja jätnud jaactions/checkoutv6 hoiab mandaati väljaspool checkout'i kataloogi, kuid vanemad kinnitatud versioonid ja kohandatud üleslaadimissammud lekitavad endiselt. - Vahemälud. Ründaja, kes saab käivitada koodi repositooriumi mis tahes töövoos, saab täita selle vahemälu, tõrjuda välja tegelikud kirjed ja istutada sama võtme alla mürgitatud kirje. Hilisem privilegeeritud töövoog taastab selle. Mais 2026 võimaldas see ahel, mis algas
pull_request_target-ist ja lõppes runneri mälust loetud OIDC-tokeniga, ründajal avaldada 42 TanStacki paketist 84 pahatahtlikku versiooni.
5. Sõltuvus saadab need serverisse
Installiskriptid jooksevad sama juurdepääsuga kui ülejäänud töö. Uss Shai-Hulud, mida nähti npm-is esimest korda septembris 2025, jooksis npm install-i ajal, kogus keskkonnast npm-i tokeneid, GitHubi tokeneid ja pilvevõtmeid ning postitas need avalikesse GitHubi repositooriumidesse. Selle novembri 2025 laine jooksis preinstalli ajal ja registreeris nakatunud masina isehallatava runnerina, et ründaja saaks hiljem tagasi tulla.
See tee ei vaja teie töövoos ühtegi viga. Piisab ühest ohustatud versioonist ükskõik kus sõltuvuspuus ja saladused lahkuvad võrgu kaudu.
Kuidas neid kaitsta
Asendage salvestatud pilvevõtmed OIDC-ga. Selle asemel, et hoida AWS-i, Azure'i või Google Cloudi võtit saladusena, laske tööl küsida GitHubi OIDC-väljastajalt lühiajaline token ja vahetada see pilveteenuse pakkuja juures. Usalduspoliitika otsustab, milline repositoorium, haru või keskkond võib rolli võtta, ja mandaat aegub koos tööga. Töö vajab permissions: id-token: write. OIDC-tokeneid saab jooksvast tööst ikkagi varastada, nagu TanStack näitas, kuid varastatud token on palju vähem väärt kui võti, mis ei aegu kunagi.
Kinnitage actionid täieliku commit'i SHA-ga või kasutage töövoo lukufaili. Silte saab liigutada, SHA-d mitte. Alates oktoobrist 2026 pakub GitHub ka töövoo lukufaile, mis salvestavad iga töövoos kasutatava actioni commit'i, ja soovitab neid seal, kus saate need kasutusele võtta. Alates augustist 2025 saab lubatud actionite poliitika nõuda SHA-ga kinnitamist ja blokeerida kogu organisatsioonis konkreetseid actioneid. Dependabot ja Renovate saavad kinnitatud SHA-sid ajakohasena hoida.
Andke GITHUB_TOKEN-ile vähim vajalik. Seadke vaikimisi ainult lugemisõigus ja andke kirjutusõigused töö kaupa. Uutel organisatsioonidel ja repositooriumidel on alates veebruarist 2023 vaikimisi ainult lugemisõigus, kuid vanemad säilitasid lubava vaikesätte, kui keegi seda ei muutnud. Vaadake GITHUB_TOKENi õigused: vähimad õigused igale töövoole.
Piirake saladused sammuga, mis neid vajab. Saladus sammu env:-is on ainult selle sammu keskkonnas. Töö tasemel seatud saladus on nähtav igale sammule, sealhulgas igale kolmanda osapoole actionile.
Pange tootmise saladused keskkondade taha. Kohustuslikud ülevaatajad ja juurutusharude reeglid tähendavad, et funktsiooniharu töövoog või pull requestiga käivitatud töövoog ei saa neid lugeda.
Käsitlege pull_request_targetit ja ebausaldusväärset sisendit koodi käivitamisena. Vältige pull_request_target-i, kui te seda ei vaja, ärge kunagi ehitage selles pull requesti koodi ja andke sündmuse andmed edasi keskkonnamuutujate kaudu. CodeQL suudab kontrollida töövooge süstimise ja pwn request'i mustrite suhtes; GitHub Actionsi jaoks on see üldiselt saadaval alates aprillist 2025.
Lülitage sisse saladuste skannimine ja push-kaitse. Need tabavad repositooriumisse commit'itud saladused, mis on teistsugune leke kui ülaltoodud, kuid sama levinud.
Piirake, kuhu töö saab ühenduda. Enamik töid vajab lühikest sihtkohtade loendit: paketiregistrid, konteineriregistrid ja mõned API-d. Kui töö pääseb ainult nendeni, pole pahatahtliku koodi loetud saladusel kuhugi minna. Vaadake, kuidas väljuva liikluse (egress) poliitika peatab andmete väljaviimise GitHub Actionsist.
Vahetage pärast iga kokkupuudet. Kui töövoog käivitas ohustatud actioni või paketi, eeldage, et iga saladus, mida see sai lugeda, on võetud. Tühistage ja väljastage need kõik uuesti, mitte ainult need, mida arvate olevat kasutatud.
Kuhu CRACI sobib
CRACI käitab teie GitHub Actionsi töid oma runneritel: muudate runs-on väärtuseks craci ning töövood, saladused ja käivituste ajalugu jäävad GitHubi. Kaks asja, mida see teeb, on suunatud ülaltoodud lekete vastu.
- Väljuva liikluse poliitika, mis sulgub tõrke korral. Määrate, milliste paketiallikate, registrite ja hostideni töö võib jõuda. Poliitika valideeritakse enne töö algust ja jõustatakse runneris, nii et ühendus kuhugi mujale blokeeritakse, ja saate hoiatuse, kui poliitikat rikutakse.
- Kirje sellest, mida töö tegi. CRACI salvestab iga paketi, mille iga töö tegelikult alla laadis, sealhulgas vahemälust taastatud paketid, ja töö võrguühenduste jälje. Kui teatatakse järgmisest ohustatud paketist, näete, millised buildid selle kaasa tõid ja kuhu nad ühendusid, selle asemel et lukufailide põhjal oletada.
Iga töö jookseb oma virtuaalmasinas, nii et miski, mille üks töö maha jätab, pole järgmise jaoks olemas. CRACI ei skanni teie koodist saladusi; selleks kasutage edasi GitHubi saladuste skannimist.
Broneerige demo, et näha ühe oma buildi kirjet.
