GitHub Actions OIDC: Kuinka suojata käyttöönotoksesi ilman pitkäaikaisia salaisuuksia
Opi, kuinka vahvistat GitHub Actions -käyttöönoton turvallisuutta OIDC:n avulla. Vaihda pitkäaikaiset pilvikirjautumistiedot lyhytaikaisiin tunnisteisiin, rajoita pääsyä IAM-luotamispolitiikoilla ja suojaa CI/CD-putkesi.
GitHub Actions OIDC: Miten voit suojata omaan julkaisujärjestelmääsi ilman pitkäikäisiä salauksia
Julkaiseminen sovellusta GitHub Actionsista tavallisesti vaatii ulkoisen infrastruktuurin pääsyyn. Joukon työn voi ladata tiedostoja Amazon S3:n kautta, julkaista kontteja tai päivittää pilvipalveluresursseja. Perinteisesti tiimit tallettavat pilvikeskustelunavauksensa GitHub Salauksissa. Se toimii, mutta pitkäikäinen tunnus on hyödyllinen hyökkääjälle, jos työsyöttö, riippuvuus tai looginen väsyminen paljastavat sen.
OpenID Connect (OIDC) auttaa vahvistamaan CI/CD-turvallisuutta korvaamalla pitkäikäiset pilvikeskustelunavaukset väliaikaisella pääsyllä, joka myönnetään vain oikeutetulle työsyötön identiteetille. Se pienentää tunninkohtaisen paljastumisen riskiä, rajoittaa laitonta päästä ja mahdollistaa tiukemmin valvotut tuotantojulkaisut.
Tämä oppaan selittää turvallisuushyödyt, näyttää käytännön AWS-mallinnuksen ja tunnistaa edelleen tarvittavat suojaukset. OIDC ei ole taikuuden säästövihko: luottamustaulukko, rooliin oikeudet ja työsyöttön työsuunnitelmat ovat yhtä tärkeät kuin tokeninvaihto.
Miksi julkaisujärjestelmän turvallisuus käyvyttä
CI/CD-pipelineit ovat valtuutettu automatisointi. Ne voivat korvata tuotantokoodia, ladata varoja, lukea julkaisujärjestelmien asetuksia tai muuttaa infrastruktuuria. Valtuutettu automatisointiputki voi olla vaikutusvaikutukseltaan suurempi kuin valtuuttoman työpöydän murha.
Kolme vaaraa ansaitsee erityistä huomiota:
- Tunninkohtainen paljastuminen: staattinen pilvikeskustelunavaus otetaan laitteistosta voi olla voimassa niin kauan kuin kukaan sen perään pyytää.
- Liian pitkät oikeudet: julkaisujärjestelmän tunnukseen, joka sisältää järjestelmänvalvojan oikeudet, vaikuttaa muidenkin järjestelmien kanssa.
- Laittonut julkaisu: epävarmoitu branch-ohjelmoija tai työsyöttö saa tuotantokapasiteettinsa käsiin, jos identiteetitarkistukset ovat liian lahat.
OIDC toteaa osittain tässä ongelmassa sitouttamalla todennuksen tulemaan lyhyellä elinkaarella ja todennettavalle työsyöttön identiteetille. Se ei korvaa vähimmäiskäyttöasetuksen IAM:ää, koodiristinkunnosta tai ympäristönsuojauksia.
Mikä on OIDC GitHub Actionsissa?
OpenID Connect on identiteetitaso, joka perustuu OAuth 2.0:een. GitHub Actions voi pyytää allekirjoitettuna JSON Web Tokenin (JWT) GitHubn OIDC-toimittajalta:
https://token.actions.githubusercontent.com
Token sisältää claimit, jot kuvata työsyötön identiteettiä ja ympäriväoloa toiminto. Pilvikeskustelunavaussovellus vahvistaa tokenin allekirjoitus-, julistaja-, arvolauseet- ja relevantit claimit, tehdessään sitten päätöksen muodostetaanko väliaikatunnukset.
Ulkoinen palvelu on mainitava luottamaan suunnittelemaansa GitHub työsyöttön identiteettiin. Yllä olevassa OIDC-määritteessä ei tee mitään, jos ei virallisesti jaa kierto.
Katso GitHubn OIDC dokumentaatio.
Staattiset tunnustukset vs OIDC: turvallisuusvertailu
| Turvallisuuskysymys | Pitkäikäinen avausavain | OIDC-federointi |
|---|---|---|
| Julkaisujärjestelmässä pysyvät pilvikeskustelunavukset | tavallisesti vaaditaan | Ei vaadita tuettuille toimittajille |
| Tunnus elinikä | Pyynnön päivittämiseen tai peräänottamiseen | Välitön sessio |
| Kierroskulusta vastuuntunto | Tiimit hoitavat avaaminenhistorian | Pilvitoimittaja toimittaa väliaikatunnuksia |
| Identiteetin rajoitaminen | Keskikäsitellen avaaminenhistorian ja IAM:n mukaan | Luottamustaulukko voi rajata työsyötön identiteettiä |
| Valtuutus | IAM-oikeudet | IAM-oikeudet edelleen vaaditaan |
| Ongelmat jäljellä | Tunnuksen varastaminen ja toistaminen | Hyväksytty työsyöttön tunnus tai laaja luottamus |
OIDC pienentää tunnuksen varastamisen riskiä ja vaikutusta; se ei poista jokaikaista salakoa. Sovelluksesta voi edelleen olla tarpeen tietokannan salako, allekirjoitussalako tai kolmannen osapuolen API-tunnusia.
Miten OIDC-todennusjono toimii
- Valtuutetut GitHub Actions-työsyöttö pyytää tunnistenumero-tokenin.
- GitHubn tuottaa allekirjoitetun JWT:n kyseelle työsyöttölle.
- Työsyöttö tuo tokenin pilvikeskustelunavaussovellukselle.
- Pilvitoimittaja vahvistaa tokenin ja arvioitu luottamusratkons mummann mukaan.
- Jos identiteetti sallitaan, toimittaja muodostaa väliaikitunnuksia.
- Työsyöttö käyttää kyseiset tunnutuksit roolin sallitulla alueella.
Pilvitoimittajan on hylättava token, jonka subjekti-, arvo- tai muita ehtoja ei vastattu. Tämä todennus on rajan, joka erottaa turvallisen julkaisun liian suuren luottamuksen.
Vaihe 1: Määritä GitHubn OIDC-toimittaja AWS:ss
AWS IAM tukee OpenID Connect-identiteetti-toimittajia. Luo identiteetti-toimittaja käyttäen:
| Setting | Value |
|---|---|
| Provider URL | https://token.actions.githubusercontent.com |
| Audience | sts.amazonaws.com |
| Provider type | OpenID Connect |
Arvolause kertoo tokenin suunnitellun vastaanottajan. AWS-avaussopimusnormaalisti käyttää sts.amazonaws.com.
Katso AWS IAM OIDC-roolin määrittely.
Vaihe 2: Rajaa ketkä voivat hakea julkaisuroolia
Luo IAM-rooli, jonka luottamustaulukko sallii vain sts:AssumeRoleWithWebIdentity GitHubn identiteetti-toimittajalta ja suunnitteleman työsyöttön identiteetiltä.
Seuraava esimerkki käyttää GitHubn perinteistä branch-pohjaisen subjektiluettelon muotoa:
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Federated": "arn:aws:iam::123456789012:oidc-provider/token.actions.githubusercontent.com"
},
"Action": "sts:AssumeRoleWithWebIdentity",
"Condition": {
"StringEquals": {
"token.actions.githubusercontent.com:aud": "sts.amazonaws.com",
"token.actions.githubusercontent.com:sub": "repo:example-org/example-app:ref:refs/heads/main"
}
}
}
]
}
Vaihda AWS-tilinumero, organisaatio ja repo.
Älä kopioi subjektiluettelo suoraksi. GitHubn on ottanut käyttöön kokoelmaisen oletustunnuksen muodon julkiset seotetut repo 7. heinäkuuta jälkeen. Tarkistakoiden oikea subjektiluettelo käytetynsi repo ja määrittele AWS näin sen mukaan. Ympäristöpohjaiset työsyöttöt voivat myös käyttää eri subjektinmuotoa. ks.GitHubn OIDC-tunnutuksen luettelo.
Rajoitettu luottamustaulukko on yksi tärkeimmistä keinoista estää epävarmat työsyöttöt saamasta tuotantotunnuksia. Vältä valtavia subjektiluetteloita, jotka välttämättä sallivat alkoyhtiötiedotreposseja tai ympäristöjä.
Vaihe 3: Määrittele roolin tehtävät
Luottaminen määrittelee kenen roolia voidaan hakea. IAM-oikeudet määrittelä miten roolia voidaan toteuttaa todennuksen jälkeen.
Vain tiedoston lataamiseen yhdelle S3-kansioille sopivalle julkaisulle, yksinkertaistettu politiikka on:
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": ["s3:PutObject"],
"Resource": "arn:aws:s3:::example-deploy-bucket/*"
}
]
}

Tämä esimerkki sallii tiedoston latauksen, ei tilanvalvonnan tai kansioluutanpoistamisen. Jos julkaisu myös poistaa käytetyn tiedoston tai listaa kansiot, salli vain sen lisää työnkielivä uusina toimintoina kuin rajattu s3:DeleteObject tai s3:ListBucket.
Älä vain anna AdministratorAccess saadaksesi julkaisun toimimaan. Väliaikatunnut liian runsaskaa oikeuksiin voivat aiheuttaa vakavaa vahinkoa.
Vaihe 4: Pyydä väliaikatunnuksia työsyöttöltä
Julkaisutyösyöttöjen on sallittava pyytää OIDC-tokeni. Seuraava esimerkki ladalta valmiiksi rakennetun dist/-kansion S3:hen:
name: Deploy website
on:
push:
branches:
- main
permissions:
contents: read
jobs:
deploy:
runs-on: ubuntu-latest
permissions:
contents: read
id-token: write
steps:
- name: Checkout repository
uses: actions/checkout@v4
- name: Configure AWS credentials
uses: aws-actions/configure-aws-credentials@v4
with:
role-to-assume: arn:aws:iam::123456789012:role/github-deploy-role
aws-region: eu-west-1
- name: Deploy website
run: |
aws s3 cp ./dist/ s3://example-deploy-bucket/ --recursive
Esimerkki käyttää major-versioactionin viittaukset, jotta ne voidaan lukea helposti. Käytännössä, tarkista nykyisin suoritatut versiot ja neuvokaan pinata tai ainakin immuoituneet commit-SHA:t. Esimerkki oletetaan käyttävän valmiiksi rakentettuun dist/:n.
Huomaa mikä puuttuu: ei pysyvää AWS-avauksenvälinettä tai salainen avausavain työsyöttömän kansion.
Virallinen AWS-avauksenvälinettä toimittava action vaihtaa OIDC-tokenin väliaikaisiin AWS-tunnutuksiin.
Vaihe 5: Ymmärrä id-token: write
Nämä oikeudet:
permissions:
id-token: write
sallivat työsyöttömän pyydellä GitHub OIDC-tunnistenumero-tokenin. Se ei itse ainakaan anna työsyöttömälle oikeutta kirjoittaa GitHubn repossseihin tai saada väliaikaa pääsy Pilvikeskusteluun.
Pilvitoimittaja vieläpä päätteekö luottamaan identiteettiin, ja IAM-rooli vieläpä kontrolloi mikä toimintoja on sallittu.
Anna id-token: write vain toimitetville työsyöttömille, jotka todellisesti todennutavat Pilvikeskusteluun. Koostaminen, linter ja testityösyöttöt pitävät harvoin tarvetta.
Vaihe 6: Suojaa tuotantoympäristöjä
OIDC ei kompensoi oikeuttua työsyöttöä julkaisessa huonokoodia. jos hyökkääjä pystyy muuttamaan valtuutetun julkaisutyösyöttö tai suorittamaan tarkistamaton kood työsyöttön kontekstissä, hän saa mahdollisesti väliaikatunnuksia.
GitHub Environments voi lisätä suojauksia kuten julkaisubransioidrajoituksia ja vaatimia arbitrosteja, riippuen repoasetuksissa ja plan availability.
jobs:
deploy:
runs-on: ubuntu-latest
environment: production
permissions:
contents: read
id-token: write
Työsyöttömän käyttessä ympäristöä, OIDC-subjekti voi tunnistaa ympäristön sen sijaan että branchin. Päivitä IAM luottamustaulukko vastaamaan aidon claimit ja suojele ympäristö itse.
Lisää tuotantoon rajoitettu identiteetti branch protection-, code review-, rajoitettu työsyöttön oikeudet ja environment approval rulesi tahditt voi olla tarpeen. Tämä on siinä on OIDC muuttuu osana vahvempaa julkaisujärjestelmän turvallisuuskäsikriteereissä, yksittäisen salakacan korvaus joka vaan joka ei riitä.
Vaihe 7: Varmista hakevan identiteetin todennus ja testaa kieltoja
AWS-turvausauksen jälkeen lisää diagnostinen askel:
- name: Verify AWS identity
run: aws sts get-caller-identity
Varmista että vastauks tunnistee suunniteltu AWS tilä ja julkaisuroolin. Komento ei paljenna salakkaavisa unaeselu tunnit.
Tsekkaa myös että epävarmoitu branch, repository tai environment ei hae tuotanturoolia. Epävarmoitu julkaisurytty kiellettyä testaus on menestyksekäs turvausaus.
Ei loge suoraan OIDC-tunnutuksia tai väliaikatunnuksia debuggausaatossa.
Yleinen OIDC turvaus ja konfigurointimokkia
Puuttuva id-token: write
Työsyöttön ei voi pyytää OIDC-tokeni ellei se saaka ainakin oikeudet. Työsyöttömän nivelmäisyysoikeudet voivat ylikirjoista työsyöttömän oikeudet.

Pilvikeskustelunavus vasta AccessDenied roolia hakennea
Tarkistakoiden identiteetti-toimittaja, arvolause, roolin ARN ja subjektiluettelo. erityisesti tarkista aidon GitHub subjektiluettelo muoto eikä ajatteko että kaikki repo käyttävät samaa oletuseslua.
Todennus onnistui mutta latausten epäonnistuminen
Luottamusehdon saatta olla kunnossa mutta rooli on kertooko säännolliset S3 oikeudet. Korja rajatut IAM-oikeuspolitiikka eikä laajenna identiteetin luottamusta.
Tuotanton pääsy sallitaan liian monelta kontekstilta
Valtava subjektiluettelo tai ympäristön tarjouksentyyvä voi tehdä tuotantotunnuksia saataviseksi työsyöttöille jotka eivät saa niitä millään muulla. Rajoita luottamustaulukko ja testaa epävarmoa tapaukset.
Tuhous pull request julkaisua
Pull requestillä voi olla erilaisia claimeja ja epävarmoita koodia. älä alenna tuotantoluottamuslause vain antaaksesi tuhous pull request hakea julkaisuroolia. vapauta vapauta vapauttua koodia ja vapauta tarkistus eri työsyöttömän konteksteissä.
Voiko käyttää OIDC Azure tai Google Cloud kanssa?
Kyllä. Federointimekanismi on samankaltainen mutta identiteetin konfigurointi eroaa.
| Pilvis | Federointimekanismi | GitHub action |
|---|---|---|
| AWS | IAM OIDC provider ja rooli | aws-actions/configure-aws-credentials |
| Microsoft Azure | Federated identity credentials | azure/login |
| Google Cloud | Workload Identity Federation | google-github-actions/auth |
Azure tavallisestiAssocioi federated tunnutus applikaation tai managed identity kanssa. Google Cloud käyttää workload identity pool ja provider, suoraan resurssin tai service account impersonoin mukaan setupyn mukaan.
Jokainen platform oma audience, subjektiluettelo matching ja valtuutusehdon. tarkistakoiden toimittajan nykyisin virallinen dokumentaatio ennen kuin copiaaat esimerkin.
Mitä PHP websites perinteisen hostingille?
Kaikki web-host ei hyväksytä GitHub OIDC identity. Shared hosting ja managed PHP hosting voi sitten käyttää SSH keys, SFTP credentials, deployment webhook tai provider API tokens.
OIDCin aktivoimisessa GitHub Actions ei automaatisesti korvaa SSH key jos kohdepalvelimen kyet federation mechanism ei toimimmakkaan.
OIDCin käyminenä ei käy , käytä dedicated deployment account, rajoitettu oikeudet, protected secrets ja credential rotation. rajosta filesystem ja command access WHERE possible.
Turvasäteijän tavoitel pseudopolvollinen ja rajattu tunninkohtainen paljastaminen, OIDC käy tai ei käy ole.
Julkaisujärjestelmän turvauschecklist
Ennen tuotantojulkaisua varmistakaa että:
- OIDC issuer ja arvolause on konfiguroitu oikein.
- Luottamustaulukko vastaa vain suunniteltua repoja ja julkaisujärjestelmän kontekstio.
- Subjektiluettelo heijättelee tekee repon todellinen GitHub tunnuksen muoto.
- IAM rooli saa vain julkaisujärjestelmän tarpeelliset oikeudet.
- vain julkaisutyösyöttömät saavat
id-token: write. - Tuotantobransio ja environmentsa saavat sopiva protection.
- Third-party actions on tsekattomia ja neuvokkaat pinata ainakin immmuoituneet commit SHAs.
- Epävarmoitu pull request ei saa hakea tuotanto roolia.
- Epävarmoitu branch ja repository epävonnsta todennus.
- Tokeni ja väliaikatunnukset on ikinä laggettu tai talletettu tarpeettomasti.
Usein kysyttyjä kysymyksiä
Onko OIDC turvenبوettu staattine AWS avauksenvälinetteä enemmän?
Se pienentää pitkäikäisen tunnutkohin paljastamisen riski. Vahvat luottamustaulukko, rajoitettu oikeudet ja protected työsyöttömäät toimittaja ovat edelleen välttämättttiä.
Onko OIDC tekee GitHub salakacan loppumaan?
Se joka joissakin pilvissä todennus tunnutkse, joka joissakin sovelluksen salakaco tai API-tunnussia.
Mitä id-token: write antaa?
Sen sallii työsyöttömän pyydettää tunnistenumero-token. Pilvikeskustelun avaus oikeudet määritetään erikseen toimittaja kaut.
Voivat epävarmot pull request käyttää tuotanto OIDC tunnutkseä?
Ne pitävät käyttää. Määritä rajoitettu luottamustause ja pidä tuotantojulkaisut erilln epävarmosta koodelta.
Onko OIDC toimittaaS mille tahansa hosting palvelu?
EI. Kohdepalvelin tai identiteetin broker tulee tukea ja luottavaa GitHubn OIDC tunnutuksia.
Loppu: Vahvenna turvauminstituut, älä vain todennus
GitHub Actions OIDC on tehokkaaksi tapaus lisätä julkaisujärjestelmän turvallisuutta tuettuille pilvisille sovelluksiin. Se poistaa sen tarpeen pitä pysyvät pilvikeskusväliniat GitHub, mahdollistaa välitön pääsy ja pilvien luottamustaulukko voivat rajata minkälainen työsyöttö voi julkaista.
Mutta vahvin design yhdistää OIDCin vähimmäiskäyttömääröisen IAM, protected environments, tarkistetty työsyöttön kood ja ekspliittit testaaja epävarmoita identiteettiä hylttämästä.
Tavoitel ei ole vain korvautua salakaco. Se on varmistaa että vain oikea työsyöttö pääsee käsiksi oikeisiin resursseinsa, vähimmillä oikeuksilla ja lyhin mahdollinen ajanjakson kanssa.