Web a vývoj

GitHub Actions OIDC: Jak zabezpečit své nasazení bez dlouhodobých tajných kódů

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

Naučte se, jak posílit zabezpečení nasazení GitHub Actions pomocí OIDC. Nahraďte dlouhodobé cloudové přihlašovací údaje krátkodobými tokeny, omezte přístup pomocí důvěryhodných politik IAM a chráněte své CI/CD kanály.

GitHub Actions OIDC: Jak zabezpečit nasazení bez dlouhodobých tajných klíčů

Nasazení aplikace z GitHub Actions obvykle vyžaduje přístup k externí infrastruktuře. Pracovní postupy mohou nahrávat soubory do Amazon S3, publikovat kontejnery nebo aktualizovat cloudové zdroje. Tradičně týmy ukládají cloudové přístupové klíče do GitHub Secrets. To funguje, ale dlouhodobě platné přihlašovací údaje zůstávají pro útočníky cenné, pokud je pracovní postup, závislost nebo protokol odhalí.

OpenID Connect (OIDC) pomáhá posílit bezpečnost CI/CD tím, že nahrazuje dlouhodobě platné cloudové přihlašovací údaje dočasným přístupem uděleným pouze oprávněným identitám pracovních postupů. Snižuje riziko odhalení přihlašovacích údajů, omezuje neoprávněný přístup a podporuje přísněji kontrolované nasazení do produkce.

Tento návod vysvětluje bezpečnostní výhody, ukazuje praktickou konfiguraci AWS a identifikuje ochrany, které stále potřebujete. OIDC není kouzelným bezpečnostním tlačítkem: zásady důvěryhodnosti, oprávnění rolí a kontroly pracovních postupů jsou stejně důležité jako výměna tokenů.

Proč je bezpečnost nasazení důležitá

CI/CD pipeline je privilegovaná automatizace. Může nahrazovat produkční kód, nahrávat aktiva, číst konfigurace nasazení nebo upravovat infrastrukturu. Kompromitovaná pipeline proto může mít větší dopad než kompromitovaný vývojářský pracovník.

Tři běžné rizikové faktory si zaslouží zvláštní pozornost:

  • Odhalení přihlašovacích údajů: ukradený statický cloudový klíč z prostředí sestavení může zůstat platný, dokud jej někdo nezruší.
  • Nadměrné oprávnění: přihlašovací údaje pro nasazení s oprávněními správce mohou ovlivnit nesouvisející služby.
  • Neoprávněné nasazení: nedůvěryhodná větev nebo pracovní postup může získat přístup do produkce, pokud jsou kontroly identity příliš široké.

OIDC řeší část tohoto problému tím, že váže ověřování k krátkodobé, ověřitelné identitě pracovního postupu. Nenahrazuje princip nejmenších oprávnění IAM, kontrolu kódu ani ochranu prostředí.

Co je OIDC v GitHub Actions?

OpenID Connect je identitní vrstva založená na OAuth 2.0. GitHub Actions může požadovat podepsaný JSON Web Token (JWT) od poskytovatele OIDC společnosti GitHub:

https://token.actions.githubusercontent.com

Token obsahuje claims popisující identitu úlohy a kontext provádění. Cloudová identitní služba ověří podpis tokenu, vydavatele, publikum a relevantní claims a poté rozhodne, zda vydá dočasné přihlašovací údaje.

Externí služba musí explicitně důvěřovat zamýšlené identitě pracovního postupu GitHubu. Pouhé povolení OIDC v YAML souboru neuděluje přístup.

Viz Dokumentace OIDC GitHubu.

Statické přihlašovací údaje vs OIDC: bezpečnostní srovnání

Bezpečnostní aspekt Dlouhodobě platný přístupový klíč Federace OIDC
Trvalé cloudové přihlašovací údaje v GitHubu Obvykle vyžadováno Není vyžadováno pro podporované poskytovatele
Životnost přihlašovacích údajů Do uplynutí platnosti nebo zrušení Dočasná relace
Odpovědnost za rotaci Tým musí spravovat životní cyklus klíčů Poskytovatel cloudu vydává krátkodobé přihlašovací údaje
Omezení identity Záleží na úložišti přihlašovacích údajů a IAM Zásady důvěryhodnosti mohou omezit identitu pracovního postupu
Autorizace Oprávnění IAM Oprávnění IAM jsou stále vyžadována
Zbývající riziko Krádež a opětovné použití statického klíče Kompromitovaný oprávněný pracovní postup nebo široká důvěra

OIDC snižuje riziko a dopad krádeže přihlašovacích údajů; nezrušuje však každý tajný klíč. Aplikace mohou stále potřebovat hesla k databázím, podpisové klíče nebo tokeny API třetích stran.

Jak funguje proces ověřování OIDC

  1. Oprávněná úloha GitHub Actions požaduje identifikační token.
  2. GitHub vydá podepsaný JWT pro tuto úlohu.
  3. Pracovní postup předloží token cloudové identitní službě.
  4. Poskytovatel cloudu ověří token a vyhodnotí své nakonfigurované podmínky důvěryhodnosti.
  5. Pokud je identita povolena, poskytovatel vydá dočasné přihlašovací údaje.
  6. Pracovní postup používá tyto přihlašovací údaje v rámci povoleného rozsahu role.

Poskytovatel cloudu musí odmítnout token, jehož subjekt, publikum nebo jiné požadované podmínky neodpovídají. Tato validace je hranicí mezi bezpečným nasazením a nasazením, které příliš důvěřuje.

Krok 1: Nakonfigurujte poskytovatele OIDC GitHubu v AWS

AWS IAM podporuje poskytovatele identity OpenID Connect. Vytvořte poskytovatele identity pomocí následujících nastavení:

| Nastavení | Hodnota | |---|---|---| | URL poskytovatele | https://token.actions.githubusercontent.com | | Publikum | sts.amazonaws.com | | Typ poskytovatele | OpenID Connect |

Publikum identifikuje zamýšleného příjemce tokenu. Akce AWS credentials obvykle používá sts.amazonaws.com.

Viz Konfigurace role OIDC AWS IAM.

Krok 2: Omezte, kdo může převzít roli pro nasazení

Vytvořte roli IAM, jejíž zásady důvěryhodnosti povolují sts:AssumeRoleWithWebIdentity pouze od identity poskytovatele GitHubu a zamýšlené identity pracovního postupu.

Následující příklad používá tradiční formát subjektu větve GitHubu:

{
  "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"
        }
      }
    }
  ]
}

Nahraďte číslo AWS účtu, organizaci a repository.

Neopomíjejte podmínku subjektu. GitHub zavedl neměnný výchozí formát subjektu pro repository vytvořená po 15. červenci 2026. Zkontrolujte skutečný formát subjektu používaný vaším repository a nakonfigurujte AWS tak, aby odpovídal. Pracovní postupy založené na prostředí mohou také používat jiný tvar subjektu. Viz Referenční informace o OIDC tokenu GitHubu.

Omezení zásady důvěryhodnosti je jedním z nejdůležitějších způsobů, jak zabránit neoprávněným pracovním postupům v získání produkčních přihlašovacích údajů. Vyhněte se podmíněným subjektům s divokým znakem, které náhodou povolují nesouvisející repository nebo kontexty.

Krok 3: Omezte, co role může dělat

Důvěryhodnost určuje, kdo může převzít roli. Oprávnění IAM určují, co role může dělat po ověření.

Pro nasazení, které pouze nahrává soubory do jednoho S3 bucketu, je zjednodušená politika následující:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": ["s3:PutObject"],
      "Resource": "arn:aws:s3:::example-deploy-bucket/*"
    }
  ]
}
Illustration of the article's main concept

Tento příklad povoluje nahrávání objektů, nikoli správu účtů nebo mazání bucketů. Pokud vaše nasazení také odstraňuje zastaralé soubory nebo vypisuje obsah bucketu, udělejte oprávnění pouze pro další požadované operace, jako je omezeně s3:DeleteObject nebo s3:ListBucket.

Nikdy nedělejte oprávnění AdministratorAccess pouze proto, aby nasazení fungovalo. Dočasné přihlašovací údaje s nadměrnými oprávněními mohou stále způsobit vážné škody.

Krok 4: Požádejte o dočasné přihlašovací údaje z pracovního postupu

Nasazovací úloha musí být oprávněna požadovat OIDC token. Následující příklad nahrává předem sestavený dist/ adresář do 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

Příklad používá reference na majoritní verze pro lepší čitelnost. V produkčním prostředí zkontrolujte aktuální podporované verze a pokud možno připněte akce třetích stran k plným commit SHAs. Příklad předpokládá, že webová stránka již byla sestavena do dist/.

Všimněte si, co chybí: nejsou uloženy žádné trvalé AWS přístupové klíče nebo tajné přístupové klíče ve pracovním postupu.

Oficiální akce AWS credentials vyměňuje OIDC token za dočasné AWS přihlašovací údaje.

Krok 5: Pochopte id-token: write

Toto oprávnění:

permissions:
  id-token: write

umožňuje úloze požadovat identifikační token OIDC GitHubu. Neuděluje samo o sobě úloze oprávnění zapisovat do repository GitHub nebo přistupovat k AWS.

Poskytovatel cloudu stále rozhoduje, zda důvěryhodnost identity, a role IAM stále ovládá, jaké operace jsou povoleny.

Udělejte oprávnění id-token: write pouze úlohám, které se skutečně ověřují u cloudu. Úlohy pro sestavení, kontrolu kódu a testování obvykle toto oprávnění nepotřebují.

Krok 6: Chraňte produkční prostředí

OIDC nemůže kompenzovat oprávněný pracovní postup spouštějící škodlivý kód. Pokud může útočník změnit důvěryhodný nasazovací pracovní postup nebo spustit neschválený kód v tomto kontextu, může být schopen získat dočasné přihlašovací údaje.

GitHub Environments mohou přidat kontroly, jako jsou omezení větví nasazení a požadovaní recenzenti, v závislosti na nastavení repository a dostupnosti plánu.

jobs:
  deploy:
    runs-on: ubuntu-latest
    environment: production

    permissions:
      contents: read
      id-token: write

Pokud pracovní postup používá prostředí, může OIDC subjekt identifikovat toto prostředí, nikoli větev. Aktualizujte zásadu důvěryhodnosti IAM tak, aby odpovídala skutečným claims a chránila samotné prostředí.

Pro produkční prostředí kombinujte omezené identity s ochranou větví, kontrolou kódu, omezenými oprávněními pracovních postupů a pravidly schválení prostředí, kde je to vhodné. Tím se OIDC stává součástí silnějšího bezpečnostního postoje nasazení, nikoli pouze náhradou přihlašovacích údajů.

Krok 7: Ověřte předpokládanou identitu a otestujte odmítnutí

Po konfiguraci ověřování AWS přidejte diagnostický krok:

- name: Verify AWS identity
  run: aws sts get-caller-identity

Zkontrolujte, zda odpověď identifikuje zamýšlený AWS účet a roli pro nasazení. Příkaz neodhaluje tajný přístupový klíč.

Otestujte také, zda neoprávněná větev, repository nebo prostředí nemůže převzít roli pro produkční nasazení. Nepovedené neoprávněné nasazení je úspěšný bezpečnostní test.

Nepřeplňujte syrové OIDC tokeny nebo dočasné přihlašovací údaje během ladění.

Běžné bezpečnostní a konfigurační chyby OIDC

Chybějící id-token: write

Úloha nemůže požadovat OIDC token, pokud nemá oprávnění. Oprávnění na úrovni úlohy mohou přepsat oprávnění na úrovni pracovního postupu.

Technical workflow illustration

AWS vrací AccessDenied pro převzetí role

Zkontrolujte poskytovatele identity, publikum, ARN role a podmínku subjektu. Zejména ověřte skutečný formát subjektu GitHubu, nikoli předpokládat, že každé repository používá stejný výchozí formát.

Ověření uspěje, ale nahrávání selže

Důvěryhodný vztah může být správný, zatímco role postrádá požadovaná oprávnění S3. Opravte úzkostně ohraničenou zásadu oprávnění IAM, nikoli rozšiřujte důvěru identity.

Přístup k produkci je povolen z příliš mnoha kontextů

Podmíněný subjekt s divokým znakem nebo nedostatečná omezení prostředí mohou učinit produkční přihlašovací údaje dostupnými pro pracovní postupy, které by je nikdy neměly obdržet. Omezte zásadu důvěryhodnosti a otestujte neoprávněné případy.

Pull request nemůže nasadit

Pull requesty mohou mít různé claims a nedůvěryhodný kód. Neoslabujte podmínky důvěryhodnosti produkce pouze proto, aby pull request mohl převzít roli pro nasazení. Provádějte validaci odděleně od nasazení do produkce.

Můžete použít OIDC s Azure nebo Google Cloud?

Ano. Mechanismy federace jsou podobné, ale konfigurace identity se liší.

Cloud Mechanismy federace Akce GitHubu
AWS Poskytovatel OIDC IAM a role aws-actions/configure-aws-credentials
Microsoft Azure Federované identifikační přihlašovací údaje azure/login
Google Cloud Federace pracovních identit google-github-actions/auth

Azure obvykle spojuje federované přihlašovací údaje s aplikací nebo spravovanou identitou. Google Cloud používá fond a poskytovatele pracovních identit, s přímým přístupem k prostředkům nebo imitací služby účtu v závislosti na nastavení.

Každá platforma má svá vlastní pravidla pro publikum, shodu subjektu a autorizaci. Před kopírováním příkladu zkontrolujte aktuální oficiální dokumentaci poskytovatele.

Co PHP weby na tradičním hostingu?

Ne každý webový hostitel přijímá identity OIDC GitHubu. Sdílení hostingu a spravovaný PHP hosting mohou stále používat SSH klíče, SFTP přihlašovací údaje, webové háčky pro nasazení nebo tokeny API poskytovatele.

Povolení OIDC v GitHub Actions automaticky nenahrazuje SSH klíč, pokud cílový server nemá mechanismus federace.

Pokud OIDC není dostupný, použijte samostatný účet pro nasazení, úzce ohraničená oprávnění, chráněné tajné klíče a rotaci přihlašovacích údajů. Omezte přístup k souborovému systému a příkazům, kde je to možné.

Cílem bezpečnosti je princip nejmenších oprávnění a omezené odhalení přihlašovacích údajů, ať už je OIDC podporován nebo ne.

Kontrolní seznam bezpečnosti nasazení

Před nasazením do produkce ověřte, že:

  • Poskytovatel OIDC a publikum jsou správně nakonfigurováni.
  • Zásada důvěryhodnosti odpovídá pouze zamýšlenému repository a kontextu nasazení.
  • Podmínka subjektu odráží skutečný formát tokenu GitHubu vašeho repository.
  • Role IAM má pouze oprávnění vyžadovaná nasazením.
  • Pouze úlohy pro nasazení obdrží id-token: write.
  • Produkční větve a prostředí mají odpovídající ochranu.
  • Akce třetích stran jsou zkontrolovány a pokud možno připnuty k neměnným commit SHAs.
  • Nedůvěryhodné pull requesty nemohou převzít role pro produkční nasazení.
  • Neoprávněné větve a repository selžou při ověřování.
  • Tokeny a dočasné přihlašovací údaje nejsou nikdy logovány nebo ukládány zbytečně.

Časté dotazy

Je OIDC bezpečnější než statické AWS přístupové klíče?

Snižuje riziko krádeže dlouhodobě platných přihlašovacích údajů. Silné zásady důvěryhodnosti, omezená oprávnění a chráněné pracovní postupy jsou však stále nezbytné.

Zruší OIDC GitHub Secrets?

Nahrazuje některé cloudové přihlašovací údaje pro ověřování, ne každý tajný klíč aplikace nebo token API.

Co id-token: write uděluje?

Umožňuje pracovnímu postupu požadovat identifikační token. Cloudová oprávnění jsou určována samostatně poskytovatelem.

Mohou nedůvěryhodné pull requesty použít produkční OIDC přihlašovací údaje?

Neměly by. Nakonfigurujte restriktivní podmínky důvěryhodnosti a udržujte produkční nasazení odděleně od nedůvěryhodného kódu.

Funguje OIDC s jakýmkoli poskytovatelem hostingu?

Ne. Cílová služba nebo zprostředkovatel identity musí podporovat a důvěřovat tokenům OIDC GitHubu.

Závěr: Posílit bezpečnost, nejen ověřování

GitHub Actions OIDC je účinný způsob, jak zvýšit bezpečnost nasazení pro podporované cloudové služby. Odstraňuje potřebu udržovat trvalé cloudové klíče v GitHubu, umožňuje krátkodobý přístup a umožňuje cloudovým zásadám důvěryhodnosti omezit, které pracovní postupy mohou nasazovat.

Ale nejsilnější návrh kombinuje OIDC s principem nejmenších oprávnění IAM, chráněnými prostředími, zkontrolovaným kódem pracovního postupu a explicitními testy, že neoprávněné identity jsou odmítnuty.

Cílem není pouze nahradit tajný klíč. Cílem je zajistit, aby pouze správný pracovní postup mohl přistupovat k správným prostředkům, s minimálními oprávněními a na nejkratší možnou dobu.

Oficiální reference