Окружения в SourceCraft: секреты и права для каждой среды

У приложения могут быть один репозиторий и общая логика CI/CD, а у стейджа и прода — разные токены, пароли и требования к доступу. Часть секретов нужна нескольким сервисам, другие относятся к конкретному приложению.

Мы добавили в SourceCraft окружения: они объединяют секреты и настройки доступа для каждой среды. С ними можно разделять учётные данные, назначать участникам нужные права и подключать общие секреты к нескольким репозиториям.

Разные секреты, привычный CI/CD

Предположим, приложение обращается к внешнему API: на стейдже использует тестовую учётную запись, в проде — рабочую. Создайте два окружения и добавьте в каждое секрет API_TOKEN со своим значением.

Окружение задаётся на уровне workflow. Обращение к секрету остаётся привычным —
${{ secrets.API_TOKEN }}. Фрагмент конфигурации для стейджа:

workflows:
  check-service:
    environment: staging
    env:
      API_TOKEN: ${{ secrets.API_TOKEN }}

В проде можно использовать те же имена секретов и ту же логику работы с ними, указав соответствующее окружение. Скрипты обращаются к API_TOKEN, а его значение определяется выбранной средой. Это позволяет поддерживать общую логику CI/CD и отдельно управлять учётными данными.

Права для каждой среды

Для каждого окружения можно назначить участникам свои права. Например, предоставить разработчикам доступ к стейджу, а права на работу с продом выдать ответственным за выпуск. При подключении нового инженера или смене его задач доступ настраивается для соответствующих сред. Так права участников отражают их обязанности в команде.

Общие секреты и локальные значения

Если нескольким сервисам нужен общий ключ API, храните его в окружении уровня проекта или организации. Окружения репозиториев могут подключать такие секреты через явные ссылки.

Например, окружение shared содержит общий ключ, а production конкретного сервиса ссылается на него и хранит собственный пароль к базе. При ротации общего ключа достаточно обновить его в исходном окружении — поддерживать копии в каждом репозитории не придётся. Чтобы изменить исходный секрет, нужны права на окружение, в котором он хранится.

Связи задаются явно: одинаковые имена окружений сами по себе не создают наследования. Порядок проверки ссылок можно настроить.

Если одному сервису нужно отдельное значение общего ключа, добавьте секрет с тем же именем непосредственно в его окружение. У собственного секрета есть приоритет над подключённым по ссылке. Остальные общие секреты продолжат использоваться из подключённого окружения.

Окружения уже доступны в SourceCraft

Попробуйте разделить секреты и права для стейджа и прода в своём проекте.

author
Денис Макрушин
CPO SourceCraft Security
author
Алексей Чернышев
Руководитель группы разработки SourceCraft
Окружения в SourceCraft: секреты и права для каждой среды
Войдите, чтобы сохранить пост