Nett og utvikling

GitHub Actions OIDC: Hvordan sikre dine distribusjoner uten langvarige hemmeligheter

GitHub Actions OIDC: How to Secure Your Deployments Without Long-Lived Secrets

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

  1. En godkjent GitHub Actions-jobb ber om en identitetstoken.
  2. GitHub utsteder et signert JWT for den jobben.
  3. Arbeidsflyten presenterer tokenet for skyidentitetstjenesten.
  4. Skyleverandøren validerer tokenet og evaluerer sine konfigurert tillitsbetingelser.
  5. Hvis identiteten er tillatt, utsteder leverandøren midlertidige legitimasjoner.
  6. 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/*"
    }
  ]
}
Illustration of the article's main concept

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.

Technical workflow illustration

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.

Offisielle referanser