Web și dezvoltare

GitHub Actions OIDC: Cum să protejați Deployările fără secrete lungi traind

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

Învața cum îmbunătăți securitatea deployamentelor GitHub Actions folosind OIDC. Înlocuiți credentialele cloud lungi traind cu tokeni scurti, restring accesul folosind politicile de trust IAM, și protejați pipeline-urile CI/CD.

GitHub Actions OIDC: Cum să protejați implementările fără chei permanente

Implementarea unei aplicații de GitHub Actions obișnuit necesită acces la infrastructură externă. Un workflow poate încărca fișiere în Amazon S3, publica conținere sau actualiza resursele cloud. Traditionally, echipele stochează o cheie de acces cloud în GitHub Secrets. Acest lucru funcționează, dar o credență cu viață lungă rămâne utilă unui atacator dacă un workflow, dependența sau un jurnal o expune.

OpenID Connect (OIDC) ajută la întărirea securității CI/CD prin înlocuirea cheilor permanente de cloud cu acces temporar oferit doar identităților de flux de lucru autorizate. Reduce expunerea credențelor, limită accesul non‑autorizat și susține implementări de producție mai strict controlate.

Acest ghid explică beneficiile de securitate, prezintă o configurare practică AWS și identifică protecțiile pe care le veți necesita încă. OIDC nu este un tău de schimbare magic pentru securitate: politica de încredere, permisiunile rolului și controlele fluxului de lucru au același importanță ca schimbarea de token.

De ce importă securitatea implementării

Pipeline-urile CI/CD sunt automatizări cu privilegii. Ele pot înlocui codul de producție, încărca active, citi configurații de implementare sau modifica infrastructura. Oameni compromisiți pot avea un impact mai mare decât un workstation de dezvoltare compromisat.

Săi trei riscuri comune merită atenție particulară:

  • Expoziție credențială: o cheie statică de cloud, luată dintr-un mediu de construire, poate rămâne validă până când o revochează cineva.
  • Privilegi excesivi: o credență de implementare cu permisiuni de administrator poate afecta servicii ne‑relate.
  • Implementare neautorizată: o ramură sau un workflow ne‑încredere pot obține acces de producție dacă verificarea identității este prea largă.

OIDC rezolvă parte din acest problemă prin legarea autentificării cu o identitate de flux de lucru scurtă durată și verificabilă. Nu înlocuiește IAM cu privilegii minimale, revizuirea codului sau protecția mediului.

Ce este OIDC în GitHub Actions?

OpenID Connect este o strat de identitate construit pe OAuth 2.0. GitHub Actions poate cere un JSON Web Token semnat (JWT) de la furnizorul OIDC al GitHub:

https://token.actions.githubusercontent.com

The token contains claims describing the job's identity and execution context. A cloud identity service validates the token's signature, issuer, audience and relevant claims, then decides whether to issue temporary credentials.

Serviciul extern trebuie să înțeleagă explicit identitatea fluxului de lucru GitHub prevăzută. Simplemente activarea OIDC într-un fișier YAML nu acordă acces.

See GitHub's OIDC documentation.

Compararea securității credențelor statice cu OIDC

Considerarea de securitate Cheie de acces lungă durată Federație OIDC
Cheie de cloud permanentă în GitHub Obișnuită frecvent Nu este necesară pentru furnizorii susținători
Durata cheii Până la expirare sau revocare Sesiune temporară
Responsabilitatea de roatăre Echipa trebuie să administreze ciclul vieții cheii Furnizorul cloud emite credențe scurte durată
Restricțiuni de identitate Depinde de stocarea credențelor și a IAM Politica de încredere poate restricționa identitatea fluxului de lucru
Autorizație Permisiuni IAM Permisiunile IAM sunt încă necesare
Risc rămânând Stolen and reused static key Flux de lucru autorizat compromisat sau încredere largă

OIDC reducează riscul și impactul furării credențelor; nu elimină fiecare secret. Aplicațiile pot necesita stillă parole de bază de date, chei de semnătură sau tokenuri API de către terți.

Cum funcționează fluxul de autentificare OIDC

  1. Un job autorizat GitHub Actions cere un token de identitate.
  2. GitHub furnizează un JWT semnat pentru acel job.
  3. Workflow‑ul prezintă token‑ul furnizorului de identitate cloud.
  4. Furnizorul cloud validează token‑ul și evaluă condițiile de încredere configurate.
  5. Dacă identitatea este permesată, furnizorul emite credențe temporare.
  6. Workflow‑ul utilizează acele credențe în limitele rolului permis.

Furnizorul cloud trebuie să respingă un token cu subiect, audiență sau alte condiții necesare care nu potepotrivi. Această validație constituie granița dintre o implementare secură și una care încredere prea mult.

Pasul 1: Configurați furnizorul OIDC al GitHub în AWS

AWS IAM susține furnizoruri de identitate OpenID Connect. Crearea unui furnizor de identitate se face astfel:

Setare Valoare
Provider URL https://token.actions.githubusercontent.com
Audience sts.amazonaws.com
Provider type OpenID Connect

Audiența identifică destinatia dorită a tokenului. Acțiunea AWS credentials de regulă utilizează sts.amazonaws.com.

See AWS IAM OIDC role configuration.

Pasul 2: Restricționează pe cine poate assume rolul de implementare

Creați un rol IAM cu o politică de încredere care permite sts:AssumeRoleWithWebIdentity doar din furnizorul de identitate GitHub și de la identitatea fluxului de lucru dorită.

următorul exemplu utilizează formatul tradițional bazat pe ramură al subiectului GitHub:

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

Împrospătați numărul de cont AWS, organizația și repository‑ul. Nu copiați condiția subiect blindat. GitHub a introdus un format implicit de subiect imposibil pentru repozitorii create după 15 iulie 2026. Verificați formatul real de subiect folosit de repository‑ul dvs. și configuraţi AWS să corespundă‑l. Fluxurile bazate pe mediu pot folosi și o altă formă de subiect. Consultați referența token OIDC GitHub.

O polyniciodă de încredere este una dintre cele mai importante feluri pentru a preveni fluxuri neautorizate de a obține credențele de producție. Evitați subiecte cu joker care autorizează accidental repozitorii sau contexturi ne‑relate.

Pasul 3: Limitați ce rolul poate face

Increderea determină cine poate assume un rol. Permisiunile IAM determină ce rolul poate face după autentificare.

Pentru o implementare care doar încarcă fișiere într-un bucket S3, o politică simplificată este:

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

Acest exemplu permite încărcarea obiectelor, nu administrarea contului sau șterea bucket‑ului. Dacă implementarea vă trebue să elimini fișiere obținute sau să listeze conținutul bucket‑ului, oferă doar operațiile suplimentare necesare, cum ar fi s3:DeleteObject sau s3:ListBucket scoped.

Nu oferi AdministratorAccess doar pentru a face o implementare să funcționeze. Credențele temporare cu privilegii excesive pot încădea grave.

Pasul 4: Cererea credentialelor temporare dintr-un workflow

Un job de implementare trebuie să fie permis să ceră un token OIDC. Exemplul următor încarcă un director preconstruit dist/ în 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

Exemplul folosește referințe de acțiune major-version pentru a fi mai clar. În producție, verificați versiunile suportate actuale și preferiți să pinuiți acțiunile externe la full SHA‑uri de commit. Exemplul presupune că site‑ul a fost deja construit în dist/.

Observați ce lipsește: nu există nici o cheie de acces permanent AWS sau cheie secretă stocate în workflow.

Acțiunea oficială de credențiale AWS schimba tokenul OIDC pentru credențele temporare AWS.

Înțelegerea id-token: write

Această permisiune:

permissions:
  id-token: write

permită un job să ceră un token de identitate GitHub OIDC. El nu însuprinde singur job‑ul permisiune de a scrie în repository‑uri GitHub sau a accesa AWS.

Furnizorul cloud decide tot dacă să încredere identitatea, iar rolul IAM controlează ce operații sunt permise.

Dă id-token: write doar job‑urilor care autentifică real în cloud. Job‑uri de construire, lintare și testare de regulă nu necesită‑o.

Pasul 6: Protejarea mediilor de producție

OIDC nu poate compensa execuții de cod malicious dintr-un workflow autorizat. Dacă un atacător poate schimba un workflow de implementare încredere sau executa cod neînregiat în acest context, poate obține credențele temporare.

GitHub Environments pot adăuga controluri precum restricții de ramură de implementare și revizorii obligatorii, subiecte la setările repository și la disponibilitatea planului.

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

    permissions:
      contents: read
      id-token: write

Când workflow‑ul folosește un mediu, subiectul OIDC poate identifica acel mediu în loc de o ramură. Actualizați politica de încredere IAM să corespundă afirmațiilor reale și protejați însuți mediul.

Pentru producție, combinați identități restricționate cu protecție de ramură, revizuire cod, permisiuni limitate ale fluxului de lucru și reguli de aprobare a mediului, după ce este cazul. Așa se transformă OIDC într-un strat mai puternic de securitate implementării, nu doar în înlocuirea credențelor.

Pasul 7: Verificați identitatea assumată și testați denaturile

După configurarea autentificării AWS, adăugați un pas diagnostic:

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

Verificați că răspunsul identifică contul AWS dorit și rolul de implementare. Comandă nu dezvăluie cheia secretă de acces.

Testați și faptul că o ramură, repository sau mediu neautorizat nu poate assume rolul de producție. O implementare neautorizată eșuată este un test de securitate reușios.

Nu salvați tokenuri OIDC crude sau credențele temporare în timpul debug‑ului.

Comunele greșeli de securitate și configurare OIDC

Lipă de id-token: write

Job‑ul nu poate cere un token OIDC dacă nu are permisiunea. Permisiunile de job pot suprada permisiunile de workflow.

Technical workflow illustration

AWS returnează AccessDenied pentru asumarea rolului

Verificați furnizorul de identitate, audiența, ARN‑ul rolului și condiția subiectului. În special, verificați formatul real de subiect GitHub, nu asumând că fiecare repository folosește același format implicit.

Autentificarea reușește, dar încărcarea eșuează

Relația de încredere poate fi corectă, dar rolul lipsă de permisiuni S3 necesare. Coregiți politica IAM cu scop mic, nu lăsați încrederea identității prea largă.

Accesul de producție este permis de prea multe contexturi

Un subiect cu joker sau restricții de mediu insuficiente pot face credențele de producție disponibile fluxurilor de lucru care nu ar trebui să le primească. Restricționați politica de încredere și testați cazurile neautorizate.

O pull request nu poate implementa

Pull request‑uri pot avea afirmații diferite și cod neînregiat. Nu slăbiți condițiile de încredere de producție doar pentru a permite unei pull request‑uri să asume rolul de implementare. Rulează validarea separat de implementarea de producție.

Poți folosi OIDC cu Azure sau Google Cloud?

Da. Mecanismul de federare este similară, dar configurația de identitate se diferențiază.

Cloud Mecanism de federare Acțiune GitHub
AWS IAM OIDC provider and role aws-actions/configure-aws-credentials
Microsoft Azure Federated identity credentials azure/login
Google Cloud Workload Identity Federation google-github-actions/auth

Azure de regulă asociază un credential federat cu o aplicație sau o identitate gestionată. Google Cloud utilizează un pool de identitate de încărcare și un furnizor, cu acces direct la resurse sau impersonarea unui service account, în funcție de configurare.

Fiecare platformă are propriile sale audiență, cocătură subiect și reguli de autorizare. Revedere documentația oficială actuală a furnizorului înainte de a copia un exemplu.

Ce se întâmplă cu site‑uri PHP pe hosting tradițional?

Nu toate furnizorii web acceptă identități GitHub OIDC. Hosting‑ul comun și hosting‑ul PHP geriat la management pot folosi încărcuri SSH, credențele SFTP, webhook‑uri de implementare sau tokenuri API de furnizor.

Activarea OIDC în GitHub Actions nu înlocuiește automat o cheie SSH dacă serverul destinație nu are mecanism de federare.

Unde OIDC nu este disponibil, folosiți un cont de implementare dedicat, permisiuni scurte, secrete protejate și rotația credențelor. Restricționați accesul la sistem și la comenzi când posibil.

Obiectivul de securitate este cel mai mic privilegiu și expunere limitată a credențelor, indiferent dacă OIDC este susținut sau nu.

Lista de verificare pentru securitate implementării

Înainte de a implementa în producție, verificați că:

  • Issuerul OIDC și audiența sunt configurate corect.
  • Politica de încredere se potrivește doar cu repository‑ul dorit și cu contextul de implementare.
  • Condiția subiect reflectă formatul real de token GitHub al repository‑ului dvs.
  • Rolul IAM are doar permisiunile necesare implementării.
  • Doar job‑urile de implementare primește id-token: write.
  • Ramurile și mediile de producție au protecție adecvată.
  • Acțiunile de terți sunt recenseate și preferiți să fie pinate la SHA‑uri de commit immuabile.
  • Pull request‑uri neîncredere nu pot assume roluri de producție.
  • Ramurile și repository‑urile neautorizate eșuează autentificarea.
  • Tokenurile și credențele temporare nu sunt niciodată logate sau stocate fără nevoie.

Întrebări frecvente

Este OIDC mai sigur decât cheile de acces AWS statice?

Este OIDC mai sigur decât cheile de acces AWS statice?

OIDC elimina GitHub Secrets?

OIDC elimina GitHub Secrets?

Ce face id-token: write?

Permite unui workflow să ceră un token de identitate. Permisiunile de cloud sunt determinate separat de către furnizorul.

Pot pull request‑uri neîncredere folosi credențele OIDC de producție?

Nu trebuie să le folosească. Configurați condiții restrictive de încredere și mențineți implementările de producție separate de cod neîncredere.

OIDC funcționează cu oricare furnizor de hosting?

Nu. Serviciul destinație sau un broker de identitate trebuie să susțină și să înțeleagă tokenurile OIDC ale GitHub.

Concluzie: întăriți securitatea, nu doar autentificarea

GitHub Actions OIDC este un fel eficient de întărirea securității implementării pentru servicii cloud susținute. Îl elimina nevoa de a păstra chei permanente de cloud în GitHub, permite acces scurt durată și permite politicii de încredere cloud să restricționeze ce fluxuri de lucru pot implementa.

Dar cea mai puternică design combină OIDC cu IAM cu privilegii minimale, mediuri protejate, cod flux de lucru recenzat și teste explicită care resping identități neautorizate.

Obiectivul nu este simplu înlocuirea unei secrete. Este să se asigure că doar fluxul corect poate accesa resursele corecte, cu permisiunile minimale și pentru cea mai scurt timp practic.