GitHub Actions OIDC: Hvordan sikre dine distribusjoner uten langvarige hemmeligheter
Lær hvordan du kan styrke sikkerheten for GitHub Actions-distribusjoner med OIDC. Erstatt langvarige skytillatelser med kortvarige tokens, begrens tilgang ved hjelp av IAM-tillitspolicyer, og beskytt dine CI/CD-pipelines.
GitHub Actions OIDC: Slik sikrer du distribusjoner uten langvarige hemmeligheter
Distribusjon av en applikasjon fra GitHub Actions krever vanligvis tilgang til ekstern infrastruktur. En arbeidsflyt kan laste opp filer til Amazon S3, publisere beholdere eller oppdatere skyeressurser. Traditionelt lagrer team en skyadgangsnøkkel i GitHub-hemmeligheter. Det fungerer, men en langvarig legitimasjon forblir nyttig for en angriper hvis en arbeidsflyt, avhengighet eller logg eksponerer den.
OpenID Connect (OIDC) styrker CI/CD-sikkerheten ved å erstatte langvarige skylegitimasjoner med midlertidig tilgang som kun gis til godkjente arbeidsflytidentiteter. Det reduserer eksponering av legitimasjoner, begrenser uautorisert tilgang og støtter strengere kontrollerte produksjonsdistribusjoner.
Denne veiledningen forklarer sikkerhetsfordelene, viser en praktisk AWS-konfigurasjon og identifiserer beskyttelser du fortsatt trenger. OIDC er ikke en magisk sikkerhetsbryter: tillitspolicyen, rolletillatelsene og arbeidsflytkontrollene er like viktige som tokenutvekslingen.
Hvorfor distribusjonssikkerhet er viktig
CI/CD-pipeliner er privilegiert automatisering. De kan kunne erstatte produksjonskode, laste opp ressurser, lese distribusjonskonfigurasjoner eller endre infrastruktur. En kompromittert pipeline kan derfor ha en større påvirkning enn en kompromittert utviklerstasjon.
Tre vanlige risikomeritterer fortjenester særlig oppmerksomhet:
- Eksponering av legitimasjon: en statisk skyløvel som stjåles fra et byggemiljø, kan forblive gyldig inntil noen kaller den tilbake.
- Overdrevne rettigheter: en distribusjonslegitimasjon med administratorrettigheter kan påvirke urelaterte tjenester.
- Uautorisert distribusjon: en utrolig gren eller arbeidsflyt kan få tilgang til produksjon hvis identitetskontroller er for brede.
OIDC løser en del av dette problemet ved å knytte autentisering til en kortlivet, verifiserbar arbeidsflytidentitet. Det erstatter ikke IAM med minste privilegium, kodegjennomgang eller miljøbeskyttelse.
Hva er OIDC i GitHub Actions?
OpenID Connect er et identitetslag bygget på OAuth 2.0. GitHub Actions kan be om et signert JSON Web Token (JWT) fra GitHubs OIDC-leverandør:
https://token.actions.githubusercontent.com
Tokenet inneholder krav som beskriver jobbens identitet og kjørekontekst. En skyidentitetstjeneste validerer tokenets signatur, utsteder, målgruppe og relevante krav, og bestemmer deretter om den skal utstede midlertidige legitimasjoner.
Den eksterne tjenesten må eksplisitt stole på den tiltenkte GitHub-arbeidsflytidentiteten. Det å enkelt aktivere OIDC i en YAML-fil gir ikke tilgang.
See GitHub's OIDC documentation.
Statiske legitimasjoner mot OIDC: sikkerhetssammenligning
| Sikkerhetshensyn | Langvarig adgangsnøkkel | OIDC-føderasjon |
|---|---|---|
| Permanent skylegitimasjon i GitHub | Vanligvis nødvendig | Ikke nødvendig for støttede leverandører |
| Legitimasjonslevetid | Inntil utløp eller tilbakekalling | Midlertidig sesjon |
| Rotasjonsansvar | Teamet må administrere nøkkelsyklusen | Skyleverandør utsteder kortlivede legitimasjoner |
| Identitetsbegrensninger | Avhenger av lagring av legitimasjon og IAM | Tillitspolicy kan begrense arbeidsflytidentitet |
| Autorisasjon | IAM-tillatelser | IAM-tillatelser er fortsat nødvendig |
| Gjenværende risiko | Tyveri og gjenbruk av statisk nøkkel | Kompromittert godkjent arbeidsflyt eller vid tillit |
OIDC reduserer risikoen og konsekvensene av legitimasjonstyveri; det fjerner ikke alle hemmeligheter. Applikasjoner kan fortsatt trenge databasepassord, signeringssøkler eller tredjeparts-API-tokens.
Slik fungerer OIDC-autentiseringsflyten
- En godkjent GitHub Actions-jobb ber om en identitetstoken.
- GitHub utsteder et signert JWT for den jobben.
- Arbeidsflyten presenterer tokenet for skyidentitetstjenesten.
- Skyleverandøren validerer tokenet og evaluerer sine konfigurert tillitsbetingelser.
- Hvis identiteten er tillatt, utsteder leverandøren midlertidige legitimasjoner.
- Arbeidsflyten bruker disse legitimasjonene innenfor rollets tillatte omfang.
Skyleverandøren må avvise en token der subjekt, målgruppe eller andre påkrevde betingelser ikke samsvarer. Denne valideringen er grensen mellom en sikker distribusjon og en som stoler for mye.
Steg 1: Konfigurer GitHubs OIDC-leverandør i AWS
AWS IAM støtter OpenID Connect-identitetsleverandører. Opprett en identitetsleverandør med:
| Innstilling | Verdi |
|---|---|
| Leverandør-URL | https://token.actions.githubusercontent.com |
| Målgruppe | sts.amazonaws.com |
| Leverandørtype | OpenID Connect |
Målgruppen identifiserer den tiltrakte mottakeren av tokenet. AWS-legitimasjonshandlingen bruker vanligvis sts.amazonaws.com.
See AWS IAM OIDC role configuration.
Steg 2: Begrens hvem som kan anta distribusjonsrollen
Opprett en IAM-rolle hvis tillitspolicy tillater sts:AssumeRoleWithWebIdentity kun fra GitHub-identitetsleverandøren og den tiltenkte arbeidsflytidentiteten.
Følgende eksempel bruker GitHubs tradisjonelle grenbaserte subjektformat:
{
"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"
}
}
}
]
}
Erstatt AWS-kontonummer, organisasjon og repository.
Kopier ikke subjektbetingelsen blinde. GitHub har introdusert et uforanderlig standardsubjektformat for repositoryer opprettet etter 15. juli 2026. Sjekk det faktiske subjektformatet som brukes av repositoryet ditt, og konfigurer AWS slik at det samsvarer. Arbeidsflyter basert på miljø kan også bruke en annen subjektform. Consult GitHub's OIDC token reference.
En restriktiv tillitspolicy er en av de viktigste måtene å forhindre uautoriserte arbeidsflyter i å skaffe seg produksjonslegitimasjoner på. Unngå jokertegnsubjekter som utilsiktet autoriserer urelaterte repositoryer eller kontekster.
Steg 3: Begrens hva rollen kan gjøre
Tillit bestemmer hvem som kan anta en rolle. IAM-tillatelser bestemmer hva rollen kan gjøre etter autentisering.
For en distribusjon som kun laster opp filer til en S3-bøtte, er en forenklet policy:
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": ["s3:PutObject"],
"Resource": "arn:aws:s3:::example-deploy-bucket/*"
}
]
}

Dette eksemplet tillater opplasting av objekter, ikke kontoadministrasjon eller bøttesletting. Hvis distribusjonen din også fjerner utdaterte filer eller lister innholdet i bøtten, gir du kun de ekstra operasjonene som er nødvendige, for eksempel begrenset s3:DeleteObject eller s3:ListBucket.
Gir aldri AdministratorAccess bare for å få en distribusjon til å fungere. Midlertidige legitimasjoner med overdrevne rettigheter kan fortsatt forårsake alvorlig skade.
Steg 4: Be om midlertidige legitimasjoner fra en arbeidsflyt
En distribusjonsjobb må ha lov til å be om en OIDC-token. Følgende eksempel laster opp en forhåndsbygd dist/-katalog til S3:
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
Eksemplet bruker referanser til store versjoner av handlinger for lesbarhet. I produksjon, gjennomgå gjeldende støttede versjoner og helst lås tredjeparts handlinger til fullstendig commit-SHAer. Eksemplet antar at nettsiden allerede er bygget til dist/.
Merk hva som mangler: ingen permanent AWS-adgangsnøkkel eller hemmelig adgangsnøkkel lagres i arbeidsflyten.
The official AWS credentials action exchanges the OIDC token for temporary AWS credentials.
Steg 5: Forstå id-token: write
Denne tillatelsen:
permissions:
id-token: write
gir en jobb mulighet til å be om en GitHub OIDC-identitetstoken. Den gir ikke i seg selv jobben tillatelse til å skrive til GitHub-repositorier eller få tilgang til AWS.
Skyleverandøren bestemmer fortsatt om den skal stole på identiteten, og IAM-rollen styrer fortsatt hvilke operasjoner som er tillatt.
Gi id-token: write kun til jobber som faktisk autentiserer seg mot skyen. Bygg-, lint- og testerjobber trenger vanligvis ikke dette.
Steg 6: Beskytt produksjonsmiljøer
OIDC kan ikke oppveie en godkjent arbeidsflyt som kjører skadelig kode. Hvis en angriper kan endre en betrodd distribusjonsarbeidsflyt eller kjøre urevidert kode i den konteksten, kan de kunne oppnå midlertidige legitimasjoner.
GitHub Environments can add controls such as deployment branch restrictions and required reviewers, subject to repository settings and plan availability.
jobs:
deploy:
runs-on: ubuntu-latest
environment: production
permissions:
contents: read
id-token: write
Når arbeidsflyten bruker et miljø, kan OIDC-subjektet identifisere det miljøet i stedet for en gren. Oppdater IAM-tillitspolicyen slik at den samsvarer med de faktiske kravene, og beskyt miljøet i seg selv.
For produksjon, kombiner begrensede identiteter med grensebeskyttelse, kodegjennomgang, begrensede arbeidsflyttillatelser og miljøgodkjennelsesregler der det er passende. Slik blir OIDC en del av en sterkere distribusjonssikkerhetsposisjon i stedet for bare en erstatning for legitimasjoner.
Steg 7: Verifiser den antatte identiteten og test avslag
Etter å ha konfigurert AWS-autentisering, legg til en diagnostisk steg:
- name: Verify AWS identity
run: aws sts get-caller-identity
Kontroller at svaret identifiserer den tiltrakte AWS-kontoen og distribusjonsrollen. Kommandoen avslører ikke den hemmelige adgangsnøkkelen.
Test også at en uautorisert gren, repository eller miljø ikke kan anta produksjonsrollen. Et mislykket uautorisert distribusjonsforsøk er en vellykket sikkerhetstest.
Ikke logg rå OIDC-tokens eller midlertidige legitimasjoner under feilsøking.
Vanlige OIDC-sikkerhets- og konfigurasjonsfeil
Mangler id-token: write
Jobben kan ikke be om en OIDC-token med mindre den har tillatelsen. Jobbnivåtillatelser kan overskrive arbeidsflytnivåtillatelser.

AWS returnerer AccessDenied for rolleantakelse
Kontroller identitetsleverandør, målgruppe, rolle-ARN og subjektbetingelse. Verifiser særlig det faktiske GitHub-subjektformatet i stedet for å anta at alle repositoryer bruker samme standard.
Autentisering lykkes, men opplasting mislykkes
Tillitsforholdet kan være korrekt mens rollen mangler de nødvendige S3-tillatelsene. Rett den snålere scopede IAM-tillatelsespolicyen i stedet for å utvide identitetstilliten.
Produksjonstilgang er tillatt fra for mange kontekster
Et jokertegnsubjekt eller utilstrekkelige miljøbegrensninger kan gjøre produksjonslegitimasjoner tilgjengelige for arbeidsflyter som aldri burde motta dem. Begrens tillitspolicyen og test uautoriserte tilfeller.
En pull request kan ikke distribuere
Pull requests kan ha forskjellige krav og utrolig kode. Svek ikke produksjonstillitsbetingelser bare for å la en pull request anta distribusjonsrollen. Kjør validering separat fra produksjonsdistribusjon.
Kan du bruke OIDC med Azure eller Google Cloud?
Ja. Føderasjonsmekanismen er lik, men identitetskonfigurasjonen varierer.
| Sky | Føderasjonsmekanisme | GitHub-handling |
|---|---|---|
| AWS | IAM OIDC-leverandør og rolle | aws-actions/configure-aws-credentials |
| Microsoft Azure | Fødererte identitetslegitimasjoner | azure/login |
| Google Cloud | Workload Identity Federation | google-github-actions/auth |
Azure assosierer vanligvis en føderert legitimasjon med en applikasjon eller administrert identitet. Google Cloud bruker en arbeidsbelastningsidentitetspulje og -leverandør, med direkte ressurstilgang eller personering av tjenestekonto avhengig av oppsettet.
Hver plattform har sine egne målgrupper, subjektmatching og autorisasjonsregler. Gjennomgå leverandørens gjeldende offisielle dokumentasjon før du kopierer et eksempel.
Hva med PHP-nettsider på tradisjonell vertstjeneste?
Ikke alle webvertstjenester aksepterer GitHub OIDC-identiteter. Delt vertstjeneste og administrerte PHP-vertstjenester kan fortsatt bruke SSH-nøkler, SFTP-legitimasjoner, distribusjonswebkroker eller leverandør-API-tokens.
Å aktivere OIDC i GitHub Actions erstatter ikke automatisk en SSH-nøkkel hvis destinasjonsserveren ikke har en føderasjonsmekanisme.
Der OIDC ikke er tilgjengelig, bruk en dedikert distribusjonskonto, snålere scopede tillatelser, beskyttede hemmeligheter og rotasjon av legitimasjoner. Begrens filsystem- og kommandotilgang der det er mulig.
Sikkerhetsmålet er minste privilegium og begrenset legitimasjonseksponering, uavhengig av om OIDC støttes.
Distribusjonssikkerhetsliste
Før du distribuerer til produksjon, verifiser at:
- OIDC-utstederen og målgruppen er konfigurert korrekt.
- Tillitspolicyen samsvarer kun med den tiltenkte repositoryen og distribusjonskonteksten.
- Subjektbetingelsen avspeiler repositoryets faktiske GitHub-tokenformat.
- IAM-rollen har kun tillatelsene som kreves av distribusjonen.
- Kun distribusjonsjobber mottar
id-token: write. - Produksjonsgrener og miljøer har passende beskyttelse.
- Tredjeparts handlinger er gjennomgått og helst låst til uforanderlige commit-SHAer.
- Utrolige pull requests kan ikke anta produksjonsroller.
- Uautoriserte grener og repositoryer mislykkes med autentisering.
- Tokens og midlertidige legitimasjoner blir aldri lagret eller logget unødvendig.
Vanlige spørsmål
Er OIDC tryggere enn statiske AWS-adgangsnøkler?
Det reduserer eksponering for tyveri av langvarige legitimasjoner. Sterke tillitspolicyer, begrensede tillatelser og beskyttede arbeidsflyter er fortsat avgjørende.
Fjerner OIDC GitHub-hemmeligheter?
Det erstatter noen skyautentiseringslegitimasjoner, ikke hver applikasjonshemmelighet eller API-nøkkel.
Hva gir id-token: write?
Det lar en arbeidsflyt be om en identitetstoken. Sky tillatelser bestemmes separat av leverandøren.
Kan utrolige pull requests bruke produksjon OIDC-legitimasjoner?
De burde ikke. Konfigurer restriktive tillitsbetingelser og hold produksjonsdistribusjoner separert fra utrolig kode.
Fungerer OIDC med enhver vertstjeneste?
Nei. Destinasjonstjenesten eller en identitetsmegler må støtte og stole på GitHubs OIDC-tokens.
Konklusjon: styrk sikkerhet, ikke bare autentisering
GitHub Actions OIDC er en effektiv måte å øke distribusjonssikkerhet på for støttede skytjenester. Det fjerner behovet for å lagre permanente skyløveler i GitHub, muliggjør kortvarig tilgang og tillater sky tillitspolicyer å begrense hvilke arbeidsflyter som kan distribuere.
Men den sterkeste designen kombinerer OIDC med minste-privilegium IAM, beskyttede miljøer, gjennomgått arbeidsflytkode og eksplisitte tester som bekrefter at uautoriserte identiteter avvises.
Målet er ikke bare å erstatte en hemmelighet. Det er å sikre at kun rett arbeidsflyt kan få tilgang til rett ressurser, med minimum tillatelser og for den kortest praktisk mulige tiden.