Технологічна галузь

GitHub Actions OIDC: Як забезпечити безпеку ваших розгортань без довготривалих секретів

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

Дізнайтеся, як зміцнити безпеку розгортання GitHub Actions за допомогою OIDC. Замініть довготривалі облікові дані хмарних сервісів на короткочасні токени, обмежте доступ за допомогою політик довіри IAM і захистіть ваші CI/CD конвеєри.

GitHub Actions OIDC: Як захистити розгортання без довгоживучих секретів

Розгортання додатку з GitHub Actions зазвичай вимагає доступу до зовнішньої інфраструктури. Робочий процес може завантажувати файли в Amazon S3, публікувати контейнери або оновлювати хмарні ресурси. Традиційно команди зберігають хмарний ключ доступу в GitHub Secrets. Це працює, але довгоживучий обліковий запис залишається корисним для атакуюча, якщо робочий процес, залежність або лог його розкривають.

OpenID Connect (OIDC) допомагає посилити безпеку CI/CD, заміщуючи довгоживучі хмарні облікові дані тимчасовим доступом, надаваним лише авторизованим ідентичностям робочих процесів. Це зменшує ризик розкриття облікових даних, обмежує несанкціонований доступ і підтримує більш строго контролювані продакшн-розгортання.

Цей посібник пояснює переваги безпеки, показує практичну конфігурацію AWS і визначає захисти, які ви все ще потребуєте. OIDC — це не магічний перемикач безпеки: політика довіри, дозволи ролей та контролі робочих процесів мають таке ж значення, як і обмін токенами.

Чому важлива безпека розгортання

CI/CD конвеєри — це привілейована автоматизація. Вони можуть замінювати продакшн-код, завантажувати активи, читати конфігурації розгортання або змінювати інфраструктуру. Скомпрометований конвеєр може мати більший вплив, ніж скомпрометована робоча станція розробника.

Три поширені ризики заслуговують на особливу увагу:

  • Розкриття облікових даних: статичний хмарний ключ, вкрадений з середовища збірки, може залишатися дійсним до його відкликання.
  • Надлишкові привілеї: облікові дані розгортання з правами адміністратора можуть впливати на непов'язані сервіси.
  • Несанкціоноване розгортання: недовірена гілка або робочий процес можуть отримати продакшн-доступ, якщо перевірки ідентичності занадто широкі.

OIDC вирішує частину цієї проблеми, прив'язуючи автентифікацію до короткоживучої, перевіреної ідентичності робочого процесу. Це не замінює найменші IAM-привілеї, код-рев'ю або захист середовищ.

Що таке OIDC в GitHub Actions?

OpenID Connect — це шар ідентичності, побудований на OAuth 2.0. GitHub Actions може запитати підписаний JSON Web Token (JWT) у провайдера OIDC GitHub:

https://token.actions.githubusercontent.com

Токен містить претензії (claims), що описують ідентичність завдання та контекст його виконання. Хмарний сервіс ідентичності перевіряє підпис токена, видавця, аудиторію та відповідні претензії, а потім вирішує, чи видавати тимчасові облікові дані.

Зовнішній сервіс має явно довіряти наміченій ідентичності робочого процесу GitHub. Просто увімкнення OIDC у YAML-файлі не надає доступу.

Див. документацію GitHub про OIDC.

Порівняння безпеки: статичні облікові дані проти OIDC

Рішення для безпеки Довгоживучий ключ доступу Федерація OIDC
Постійні хмарні облікові дані в GitHub Зазвичай обов'язкові Не обов'язкові для підтримуваних провайдерів
Тривалість життя облікових даних До закінчення терміну дії або відкликання Тимчасова сесія
Відповідальність за ротацію Команда повинна керувати життєвим циклом ключа Хмарний провайдер видає короткоживучі облікові дані
Обмеження ідентичності Залежить від зберігання облікових даних та IAM Політика довіри може обмежувати ідентичність робочого процесу
Авторизація IAM дозволи IAM дозволи все ще потрібні
Залишковий ризик Крадіжка та повторне використання статичного ключа Скомпрометований авторизований робочий процес або широка довіра

OIDC зменшує ризик та вплив крадіжки облікових даних; він не усуває кожен секрет. Додатки все ще можуть потребувати паролі баз даних, ключі підпису або токени сторонніх API.

Як працює потік автентифікації OIDC

  1. Авторизоване завдання GitHub Actions запитує токен ідентичності.
  2. GitHub видає підписаний JWT для цього завдання.
  3. Робочий процес передає токен хмарному сервісу ідентичності.
  4. Хмарний провайдер перевіряє токен та оцінює налаштовані умови довіри.
  5. Якщо ідентичність дозволена, провайдер видає тимчасові облікові дані.
  6. Робочий процес використовує ці облікові дані в межах дозволеного обсягу ролі.

Хмарний провайдер має відхилити токен, чиї subject, audience або інші обов'язкові умови не відповідають. Ця перевірка є межею між безпечним розгортанням та тим, що довіряє занадто багато.

Крок 1: Налаштуйте OIDC-провайдера GitHub в AWS

AWS IAM підтримує провайдерів ідентичностей OpenID Connect. Створіть провайдера ідентичностей за допомогою:

Налаштування Значення
URL провайдера https://token.actions.githubusercontent.com
Аудиторія sts.amazonaws.com
Тип провайдера OpenID Connect

Аудиторія ідентизує наміченого отримувача токена. Дія AWS credentials зазвичай використовує sts.amazonaws.com.

Див. конфігурація IAM OIDC ролі AWS.

Крок 2: Обмежте, хто може припустити роль розгортання

Створіть IAM роль, чия політика довіри дозволяє sts:AssumeRoleWithWebIdentity лише від провайдера ідентичності GitHub та наміченої ідентичності робочого процесу.

Наступний приклад використовує традиційний формат subject на основі гілок 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"
        }
      }
    }
  ]
}

Замініть номер облікового запису AWS, організацію та репозиторій.

Не копіюйте умову subject сліпо. GitHub ввів незмінний формат subject за замовчуванням для репозиторіїв, створених після 15 липня 2026 року. Перевірте фактичний формат subject, що використовується вашим репозиторієм, і налаштуйте AWS відповідно. Робочі процеси на основі середовищ також можуть використовувати іншу форму subject. Звертайтеся до довідника OIDC токенів GitHub.

Рестриктивна політика довіри — один з найважливіших способів запобігти неавторизованим робочим процесам отримання продакшн-облікових даних. Уникайте wildcard-subjects, які випадково авторизують непов'язані репозиторії або контексти.

Крок 3: Обмежте, що може робити роль

Довіря визначає хто може припустити роль. IAM дозволи визначають що роль може робити після автентифікації.

Для розгортання, яке лише завантажує файли в один S3 bucket, спрощена політика виглядає так:

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

Цей приклад дозволяє завантаження об'єктів, а не адміністрування облікового запису або видалення bucket. Якщо ваше розгортання також видаляє застарілі файли або перелічує вміст bucket, надайте лише додаткові операції, що потрібні, такі як обмежені s3:DeleteObject або s3:ListBucket.

Ніколи не надавайте AdministratorAccess лише для того, щоб розгортання спрацювало. Тимчасові облікові дані з надлишковими привілеями все ще можуть завдати серйозної шкоди.

Крок 4: Запитайте тимчасові облікові дані з робочого процесу

Завдання розгортання повинно мати дозвіл запитувати OIDC токен. Наступний приклад завантажує попередньо зібрану директорію dist/ в 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

Приклад використовує посилання на дії major-version для читабельності. У продакшні перегляньте поточні підтримувані версії і краще закріпіть сторонні дії на повних коміт SHAs. Приклад припускає, що веб-сайт вже зібрано в dist/.

Зверніть увагу, що відсутнє: постійний AWS access key або secret access key не зберігається в робочому процесі.

Офіційна дія AWS credentials обмінює OIDC токен на тимчасові AWS облікові дані.

Крок 5: Зрозумійте id-token: write

Цей дозвіл:

permissions:
  id-token: write

дозволяє завданню запитати GitHub OIDC токен ідентичності. Він не дає сам по собі завданню дозвіл писати в GitHub репозиторії або отримувати доступ до AWS.

Хмарний провайдер все ще вирішує, чи довіряти ідентичності, а IAM роль все ще контролює, які операції дозволені.

Надавайте id-token: write лише завданням, які реально автентифікуються в хмарі. Завдання збірки, lint та тестування зазвичай не потребують його.

Крок 6: Захистіть продакшн-середовища

OIDC не може компенсувати авторизований робочий процес, що виконує шкідливий код. Якщо атакувальник може змінити довірений робочий процес розгортання або виконати неперевірений код в цьому контексті, він може отримати тимчасові облікові дані.

GitHub Environments можуть додати контролі, такі як обмеження гілок розгортання та обов'язкові рецензенти, залежно від налаштувань репозиторію та доступності плану.

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

    permissions:
      contents: read
      id-token: write

Коли робочий процес використовує середовище, OIDC subject може ідентифікувати це середовище, а не гілку. Оновіть IAM політику довіри відповідно до фактичних претензій і захистіть саме середовище.

Для продакшну поєднуйте обмежені ідентичності з захистом гілок, code review, обмеженими дозволами робочих процесів та правилами схвалення середовищ, де це доречно. Ось як OIDC стає частиною сильнішої позиції безпеки розгортання, а не просто заміною облікових даних.

Крок 7: Перевірте припущену ідентичність та протестуйте відмови

Після налаштування AWS автентифікації додайте діагностичний крок:

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

Перевірте, що відповідь ідентифікує намічений AWS обліковий запис і роль розгортання. Команда не розкриває secret access key.

Також протестуйте, що неавторизована гілка, репозиторій або середовище не можуть припустити продакшн-роль. Невдала неавторизована спроба розгортання — це успішний тест безпеки.

Не логуйте сирі OIDC токени або тимчасові облікові дані під час дебагінгу.

Поширені помилки безпеки та конфігурації OIDC

Відсутній id-token: write

Завдання не може запитати OIDC токен, якщо у нього немає дозволу. Дозволи рівня завдання можуть перекривати дозволи рівня робочого процесу.

Technical workflow illustration

AWS повертає AccessDenied при припущенні ролі

Перевірте провайдера ідентичностей, аудиторію, ARN ролі та умову subject. Зокрема, перевірте фактичний формат GitHub subject, а не припускайте, що кожен репозиторій використовує той самий формат за замовчуванням.

Автентифікація пройшла, але завантаження не вдається

Відносини довіри можуть бути правильними, тоді як роль не має необхідних S3 дозволів. Виправте обмежену IAM політику дозволів, а не розширюйте довіру до ідентичностей.

Продакшн-доступ дозволено з надбагатьох контекстів

Wildcard subject або недостатні обмеження середовищ можуть робити продакшн-облікові дані доступними для робочих процесів, які ніколи не повинні їх отримувати. Обмежте політику довіри і протестуйте неавторизовані випадки.

Pull request не може розгортатися

Pull requests можуть мати інші претензії та недовірений код. Не послаблюйте умови довіри продакшну лише для того, щоб дозволити pull request припустити роль розгортання. Запускайте валідацію окремо від продакшн-розгортання.

Чи можна використовувати OIDC з Azure або Google Cloud?

Так. Механізм федерації схожий, але конфігурація ідентичності відрізняється.

Хмара Механізм федерації GitHub дія
AWS IAM OIDC провайдер та роль aws-actions/configure-aws-credentials
Microsoft Azure Федеровані облікові дані ідентичності azure/login
Google Cloud Workload Identity Federation google-github-actions/auth

Azure зазвичай асоціює федеральні облікові дані з додатком або керованою ідентичністю. Google Cloud використовує workload identity pool та провайдера, з прямим доступом до ресурсів або імітацією service account залежно від налаштувань.

Кожна платформа має свою аудиторію, відповідність subject та правила авторизації. Перегляньте поточну офіційну документацію провайдера перед копіюванням прикладу.

А що з PHP веб-сайтами на традиційному хостингу?

Не кожен веб-хостинг приймає GitHub OIDC ідентичності. Спільний хостинг та керований PHP хостинг можуть все ще використовувати SSH ключі, SFTP облікові дані, веб-хуки розгортання або токени API провайдера.

Увімкнення OIDC в GitHub Actions не автоматично замінює SSH ключ, якщо сервер призначення не має механізму федерації.

Де OIDC недоступний, використовуйте спеціальний обліковий запис розгортання, строго обмежені дозволи, захищені секрети та ротацію облікових даних. Обмежуйте доступ до файлової системи та команд, де це можливо.

Мета безпеки — найменші привілеї та обмежене розкриття облікових даних, незалежно від того, чи підтримується OIDC.

Чек-лист безпеки розгортання

Перед розгортанням у продакшн перевірте, що:

  • OIDC issuer та audience налаштовані правильно.
  • Політика довіри відповідає лише наміченому репозиторію та контексту розгортання.
  • Умова subject відображає фактичний формат GitHub токена вашого репозиторію.
  • IAM роль має лише дозволи, необхідні для розгортання.
  • Тільки завдання розгортання отримують id-token: write.
  • Продакшн-гілки та середовища мають відповідний захист.
  • Сторонні дії переглянуті та краще закріплені на незмінних коміт SHAs.
  • Недовірені pull requests не можуть припустити продакшн-ролі.
  • Неавторизовані гілки та репозиторії не пройдуть автентифікацію.
  • Токени та тимчасові облікові дані ніколи не логуються та не зберігаються зайво.

Поширені запитання

Чи OIDC безпечніший за статичні AWS access keys?

Він зменшує розкриття крадіжці довгоживучих облікових даних. Сильні політики довіри, обмежені дозволи та захищені робочі процеси все ще є суттєвими.

Чи OIDC усуває GitHub Secrets?

Він замінює деякі хмарні облікові дані автентифікації, а не кожен секрет додатку або API ключ.

Що надає id-token: write?

Він дозволяє робочому процесу запитати токен ідентичності. Хмарні дозволи визначаються окремо провайдером.

Чи недовірені pull requests можуть використовувати продакшн OIDC облікові дані?

Вони не повинні. Налаштуйте рестриктивні умови довіри та тримайте продакшн-розгортання окремо від недовіреного коду.

Чи OIDC працює з будь-яким хостинг-провайдером?

Ні. Сервіс призначення або брокер ідентичностей має підтримувати та довіряти GitHub OIDC токенам.

Висновок: посилюйте безпеку, а не просто автентифікацію

GitHub Actions OIDC — ефективний спосіб підвищити безпеку розгортання для підтримуваних хмарних сервісів. Він усуває необхідність зберігати постійні хмарні ключі в GitHub, увімкнює короткоживучий доступ і дозволяє хмарним політикам довіри обмежувати, які робочі процеси можуть розгортати.

Але найсильніший дизайн поєднує OIDC з least-privilege IAM, захищеними середовищами, переглянутим кодом робочих процесів та явними тестами, що неавторизовані ідентичності відхиляються.

Мета — не просто замінити секрет. Це гарантувати, що тільки правильний робочий процес може отримати доступ до правильних ресурсів, з мінімальними дозволами та на найкоротший практичний час.

Офіційні посилання