Iga GitHub Actionsi töö saab tokeni. GitHub loob iga töö alguses uue GITHUB_TOKEN-i, mis on piiratud repositooriumiga, kus töövoog asub, ja iga töö samm saab seda kasutada. Mida see teha saab, sõltub sätetest, mida paljud meeskonnad pole kunagi vaadanud, ja vanemates repositooriumides on vastus endiselt „kirjutada peaaegu kõikjale“.
See on oluline, kui midagi töös muutub pahatahtlikuks. Augusti 2025 Nx-i „s1ngularity“ rünnakus oli repositooriumi tokenil endiselt lugemis- ja kirjutusõigus. Süstimine pull_request_target töövoos kasutas seda avaldamistöövoo käivitamiseks, mis lekitas npm-i tokeni, millega avaldati Nx-i pahatahtlikud versioonid. Ainult lugemisõigusega token oleks selle sammu peatanud.
See postitus käsitleb, kuidas tokeni õigused määratakse, mida iga tavaline ülesanne vajab ja kuidas leida oma töövoogude jaoks miinimum.
Mis on GITHUB_TOKEN
GITHUB_TOKEN on GitHub Actionsi rakenduse paigalduse juurdepääsutoken. Mõned omadused on kerge kahe silma vahele jätta:
- See on olemas, kasutate seda või mitte. Töövood viitavad sellele kui
secrets.GITHUB_TOKEN, kuid iga action saab seda lugeda kontekstigithub.tokenkaudu, ilma et seda talle edasi antaks. - See kirjutatakse vaikimisi kettale.
actions/checkoutsäilitab tokeni hilisemate git-käskude jaoks, kui te ei seapersist-credentials: false. Enne v6 läks see faili.git/config; v6 viis selle eraldi faili kataloogis$RUNNER_TEMP. 2024. aastal leidis Unit 42 ArtiPACKED uuring tokeneid, mis lekkisid artefaktide kaudu, mis sisaldasid faili.git/config. - See aegub koos tööga. GitHubi hallatud runneritel tähendab see kõige rohkem 6 tundi, töö ajapiirangut. Isehallatavatel runneritel saab seda värskendada kuni 24 tundi.
Kuna token on alati olemas, saate kontrollida ainult seda, kui palju see teha saab.
Vaikesäte: lubav või piiratud
Igal ettevõttel (enterprise), organisatsioonil ja repositooriumil on tokeni jaoks vaikesäte:
- Lubav (permissive): lugemis- ja kirjutusõigus igale õigusele.
- Piiratud (restricted): ainult lugemisõigus
contentsjapackagesjaoks, mitte midagi muud.
Alates 2. veebruarist 2023 on uute ettevõtete, organisatsioonide ja repositooriumide vaikesäte piiratud. Muudatus ei puudutanud olemasolevaid, seega säilitab iga enne seda loodud repositoorium või organisatsioon lubava vaikesätte, kui keegi seda ei muutnud. Kui kõrgem tase valib piiratud sätte, ei saa sellest madalamad tasemed valida lubavat.
Kontrollige seda jaotises Settings → Actions → General → Workflow permissions, esmalt organisatsiooni tasemel. Samas jaotises on säte Allow GitHub Actions to create and approve pull requests, mis peaks jääma välja lülitatuks, kui töövoog seda ei vaja.
permissions-võti
Töövoo võti permissions kohandab tokenit vaikesättest lähtudes. See toimib kahel tasemel:
permissions:
contents: read
jobs:
release:
permissions:
contents: write
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@<full-commit-sha>
Reeglid:
- Töö tase kirjutab üle töövoo taseme. Seadke töövoo vaikesätteks ainult lugemisõigus ja tõstke õigusi ainult töödes, mis neid vajavad.
- Kõik, mida te ei loetle, muutub väärtuseks
none. Niipea kui määrate ühe õiguse, eemaldatakse kõik teised.permissions: {}eemaldab need kõik. - Väärtused on
read,writevõinone.writesisaldabread-i.read-alljawrite-allmääravad kõik korraga; vältigewrite-all-i.
Saadaolevad õigused septembri 2026 seisuga:
| Õigus | Mida see kontrollib |
|---|---|
actions | Töövoogude käivitused, artefaktid ja vahemälud |
artifact-metadata | Artefaktide metaandmete kirjed (asendas 2026. aastal nende API-de jaoks contents-i) |
attestations | Artefaktide kinnitused (attestations) |
checks | Check run'id ja check suite'id |
code-quality | Koodikvaliteedi tulemused, näiteks katvusaruanded |
contents | Repositooriumi sisu, commit'id, harud, sildid ja väljalasked |
deployments | Juurutused |
discussions | Arutelud |
id-token | OIDC-tokeni küsimine (ainult write või none) |
issues | Issue'd ja kommentaarid |
packages | GitHub Packages, sealhulgas konteineriregister |
pages | GitHub Pagesi buildid |
pull-requests | Pull requestid, sildid ja ülevaatused |
security-events | Koodiskannimise hoiatused ja SARIF-i üleslaadimised |
statuses | Commit'ide olekud |
vulnerability-alerts | Dependaboti hoiatused (ainult read või none) |
Kui tööl puudub vajalik õigus, ebaõnnestub API-kutse veaga 403 Resource not accessible by integration. See viga on märk lisada see üks õigus, mida samm vajab, mitte lülituda write-all-ile.
Mida tavalised ülesanded vajavad
| Ülesanne | Õigused |
|---|---|
| Koodi väljavõtmine | contents: read |
| Väljalaske loomine või sildi push'imine | contents: write |
| Issue või pull requesti kommenteerimine | issues: write (pull requesti kommentaarid käivad issues-API kaudu) |
| Pull requestile siltide või ülevaatuste lisamine | pull-requests: write |
| Pilveteenuse pakkujale OIDC-ga autentimine | id-token: write |
| Artefaktide kinnituste loomine | id-token: write, attestations: write, contents: read, lisaks konteineritõmmiste jaoks packages: write |
| Tõmmise push'imine GitHub Container Registrysse | packages: write |
| SARIF-i üleslaadimine koodiskannimisse | security-events: write |
| GitHub Pagesi juurutamine töövoost | pages: write, id-token: write |
Enamik testi- ja buildi töid ei vaja midagi peale contents: read.
Forkid, pull_request_target ja Dependabot
- Forkidest tulevad pull requestid saavad sündmusel
pull_requestainult lugemisõigusega tokeni, ükskõik mida töövoog küsib, kui administraator ei lülita sisse sätet „Send write tokens to workflows from pull requests“. Jätke see välja lülitatuks. pull_request_targetsaab lugemis- ja kirjutusõigusega tokeni ka avalikest forkidest tulevate pull requestide puhul. Seepärast on see paljude tuntuimate tokenivarguste taga: Nx-i rünnak ja Ultralyticsi rünnak detsembris 2024 algasid mõlemadpull_request_targettöövoost. GitHub piirab seda järk-järgult: alates juulist 2026 keeldubactions/checkoutvaikimisi forkide koodi nendes töövoogudes välja võtmast ja alates 2. detsembrist 2026 on avalikes repositooriumides, millel pole oma poliitikat,pull_request_targetvaikimisi keelatud.- Dependaboti pull requeste koheldakse nagu forke: ainult lugemisõigusega token ja ei mingeid Actionsi saladusi. Kui kaalute teisi uuendustööriistu, vaadake Dependaboti alternatiivid.
Kuidas leida minimaalsed õigused
Te ei pea seda välja selgitama iga actioni lähtekoodi lugedes:
- GitHub Security Labi actions-permissions jälgib, kuidas töövoog oma tokenit kasutab, ja soovitab minimaalseid õigusi. See on avalikus beetas.
- OpenSSF Scorecardi Token-Permissions kontroll märgib töövood, mis ei määra ülemisel tasemel ainult lugemisõigusi. See hindab kontrolli kõrge riskiga kontrolliks.
- zizmor, töövoogude staatiline analüsaator, märgib liigsed või vaikimisi õigused ja checkout'id, mis säilitavad mandaate.
- StepSecurity Secure-Repo ja Harden-Runner soovitavad töö taseme õigusi actionite teadmusbaasi ja töö tehtavate API-kutsete põhjal.
Praktiline juurutus: seadke organisatsiooni vaikesätteks piiratud, lisage iga töövoo algusesse permissions: contents: read ja käivitage töövood. Need, mis ebaõnnestuvad veaga Resource not accessible by integration, ütlevad täpselt, milline töö millist lisaõigust vajab.
Kuhu CRACI sobib
Vähimad õigused piiravad, mida varastatud token teha saab. Need ei takista selle varastamist ja töö teised saladused, näiteks npm-i tokenid ja pilve mandaadid, on sama avatud.
CRACI käitab teie GitHub Actionsi töid oma runneritel. Muudate runs-on väärtuseks craci; GITHUB_TOKEN, võti permissions ja teie repositooriumi sätted toimivad nagu varem, sest tokeni väljastab endiselt GitHub. CRACI lisab runnerisse väljuva liikluse (egress) poliitika, mis otsustab, milliste hostideni töö võib jõuda, valideeritakse enne töö algust ja sulgub tõrke korral, ning kirje igast paketist, mille töö alla laadis, koos tema võrguühenduste jäljega. Kui pahatahtlik kood töös siiski tokeni kätte saab, piirab poliitika, kuhu see seda saata saab, ja kirje näitab, mis juhtus.
Töö ülejäänud saladuste kohta vaadake GitHub Actionsi saladused: kuidas need lekivad ja kuidas neid kaitsta. Broneerige demo, et näha ühe oma buildi kirjet.
