GitHub Actions OIDC: Cum să protejați Deployările fără secrete lungi traind
Î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
- Un job autorizat GitHub Actions cere un token de identitate.
- GitHub furnizează un JWT semnat pentru acel job.
- Workflow‑ul prezintă token‑ul furnizorului de identitate cloud.
- Furnizorul cloud validează token‑ul și evaluă condițiile de încredere configurate.
- Dacă identitatea este permesată, furnizorul emite credențe temporare.
- 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/*"
}
]
}

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.

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.