Коротко
- Terraform state хранит значения ресурсов в открытом виде по умолчанию, включая то, что передавалось как чувствительные данные.
- Публично доступный бакет с state-файлами — это не теоретический риск: подобные случаи фиксировались на практике.
- Удалённый backend с шифрованием и ограниченным доступом снижает риск сильнее, чем попытки «спрятать» секреты внутри кода.
- Ротация значений, которые когда-либо попадали в state в открытом виде, должна быть частью процесса, а не разовой мерой.
Что такое Terraform state и почему он чувствителен
Terraform state — это файл, в котором Terraform хранит текущее представление об инфраструктуре: какие ресурсы созданы, какие у них атрибуты, как они связаны между собой. Без этого файла Terraform не может понять, что уже существует, и будет пытаться создать ресурсы заново или удалить то, что считает лишним.
Проблема в том, что многие атрибуты ресурсов — это именно то, что команды обычно считают секретами: пароли баз данных, ключи доступа, токены API, сертификаты. Terraform записывает их в state в открытом виде, если явно не настроено иное, потому что ему нужно знать актуальное значение для последующих операций сравнения и обновления.
Отдельный источник риска — локальные копии state, которые остаются на компьютерах разработчиков после отладки или ручного запуска команд. Даже если основной процесс работы команды использует удалённый backend с шифрованием, разовый локальный запуск может создать файл state на диске ноутбука, который не попадёт ни под один из контролей, настроенных для общего хранилища.
Отдельная практическая деталь — разграничение прав на чтение самого state и на применение изменений инфраструктуры (terraform apply). Это не одно и то же право: инженеру может быть нужно смотреть на текущее состояние для диагностики, но не обязательно иметь возможность вносить изменения, и наоборот — CI-система, которая применяет изменения, не обязательно должна иметь удобный интерфейс для чтения state человеком.
Как секреты попадают в state
Есть несколько типичных путей, которыми чувствительные значения оказываются в файле состояния:
- Ресурс создаёт пароль или ключ и возвращает его как атрибут — Terraform фиксирует значение в state, чтобы знать текущее состояние ресурса.
- Значение передаётся в модуль как входная переменная и используется в атрибутах нескольких ресурсов — оно размножается по state в нескольких местах.
- Провайдер возвращает в ответе больше данных, чем нужно было бы ожидать, включая служебные токены сессии.
- Старые версии state, сохранённые в системе контроля версий по ошибке, продолжают хранить значения, которые давно изменились в реальной инфраструктуре, но остались читаемыми в истории.
Маркировка переменной как sensitive = true в Terraform скрывает значение из вывода в консоли и в логах выполнения. Она не шифрует и не исключает значение из самого файла state — это частое заблуждение.
CI-системы — ещё одна точка, где state проходит через промежуточные системы: логи сборки, временные файлы, кэш между запусками. Если пайплайн выводит содержимое плана или состояния в лог для отладки, эти логи могут храниться дольше и с более широким доступом, чем сам backend, и превращаться в отдельный канал утечки тех же значений.
Полезно также документировать для команды, какие именно типы ресурсов в проекте создают чувствительные атрибуты — это не всегда очевидно из названия ресурса в коде, а разработчик, который добавляет новый модуль, может не знать, что конкретный провайдер возвращает секрет в открытом виде, пока не увидит его в state своими глазами.
Читайте такжеНормализация путей в API-шлюзах: где ломается авторизацияПочему публичный бакет с state — не абстрактный риск
State часто хранят в удалённом хранилище — например, в объектном хранилище облачного провайдера — чтобы несколько членов команды и CI-процессы могли работать с одной и той же версией состояния. Если доступ к такому хранилищу настроен неправильно и бакет оказывается читаемым без авторизации, любой, кто найдёт его URL, получает не абстрактный «файл конфигурации», а конкретные значения: имена ресурсов, внутренние адреса, а в части случаев и живые учётные данные для доступа к облаку.
Подобные случаи с публично доступными хранилищами state-файлов фиксировались на практике и становились предметом разборов в исследованиях безопасности, в том числе в материале про поиск открытых бакетов с файлами состояния, который редакция Vechron разбирала в новостях. Общий вывод таких историй устойчив: неправильно настроенное хранилище state — это не узкая инженерная недоработка, а прямой путь к компрометации облачной учётной записи.
Стоит отдельно продумать модульную структуру инфраструктурного кода: если секреты нужны только для узкого набора ресурсов, разумно изолировать эти ресурсы в отдельный модуль с собственным, более строго ограниченным state, а не держать все ресурсы проекта в одном файле состояния с общим уровнем доступа.
Стоит периодически прогонять проверку самого репозитория инфраструктурного кода на случайно закоммиченные файлы state — такие ошибки происходят на удивление часто, особенно при локальной отладке, когда разработчик забывает, что временный файл state создался в рабочей директории репозитория, а не только в настроенном удалённом backend.
Эта тема пересекается с нормализацией путей в API-шлюзах — разбор смежных рисков помогает увидеть общую картину.
Как настроить безопасный backend
Базовый набор мер для удалённого backend без привязки к конкретному облаку:
| Мера | Что она даёт |
|---|---|
| Шифрование хранилища на стороне сервера | Данные в state нечитаемы без ключа даже при прямом доступе к диску хранилища |
| Блокировка публичного доступа к бакету/контейнеру | Исключает случайную публикацию state наружу из-за неправильной политики |
| Отдельные учётные данные и минимальные права для CI | Компрометация одного пайплайна не даёт доступ ко всей инфраструктуре |
| Механизм блокировки state (locking) | Предотвращает одновременную запись и повреждение файла при параллельном запуске |
| Версионирование хранилища | Позволяет восстановить состояние после ошибки, но требует отдельной очистки старых секретов из истории |
Версионирование — отдельная ловушка: если в старой версии state было значение секрета, которое позже сменилось, старая версия файла в истории хранилища может оставаться читаемой с тем же уровнем доступа, что и текущая. Удаление «последней» версии не решает проблему целиком.
При работе с несколькими окружениями — тестовым, промежуточным, продуктивным — соблазн использовать один и тот же backend с разными префиксами путей понятен, но увеличивает последствия одной ошибки конфигурации сразу для всех окружений. Разделение backend по окружениям ограничивает ущерб, если что-то пойдёт не так в одном из них.
Что делать с уже утёкшими значениями
Если есть основания полагать, что в state когда-либо хранилось значение секрета в открытом виде — даже если доступ к хранилищу не был публичным, — разумный порядок действий такой:
- Определить, какие именно значения потенциально экспонировались — пароли, ключи доступа, токены.
- Провести ротацию всех этих значений, а не только тех, в утечке которых есть прямые доказательства.
- Проверить права доступа к backend на момент, когда секрет мог попасть в state, и сузить их, если они были шире необходимого.
- Очистить историю версий хранилища от старых state-файлов, которые не нужны для аудита, или ограничить к ним доступ отдельно от текущей версии.
Ротация — это не разовая реакция на инцидент, а часть обычного цикла работы с инфраструктурным кодом, особенно если команда часто меняет модули, которые создают ресурсы с чувствительными атрибутами.
Регулярный аудит прав доступа к backend — отдельная задача, которую легко отложить «на потом»: права настраиваются один раз в начале проекта и годами не пересматриваются, даже когда состав команды и список CI-систем, которым они нужны, меняется. Периодический пересмотр прав стоит включать в тот же цикл, что и ревизию остальной инфраструктуры.
Эта тема пересекается с проверкой открытых датасетов перед обучением — разбор смежных рисков помогает увидеть общую картину.
Читайте такжеНормализация путей в API-шлюзах: где ломается авторизацияАльтернативный подход: не хранить секрет в state вовсе
Самый надёжный способ не беспокоиться о секрете в state — не создавать его средствами Terraform, которые кладут значение в атрибут ресурса. Вместо этого можно использовать внешнее хранилище секретов, которое генерирует и хранит значение отдельно, а Terraform лишь ссылается на него по идентификатору или управляет доступом к нему, не читая само значение в открытом виде.
Это не всегда возможно технически — некоторые провайдеры возвращают сгенерированное значение независимо от того, нужно оно вам в state или нет. Но там, где выбор есть, вынос секрета за пределы state снимает целый класс рисков разом, вместо того чтобы закрывать его слоями защиты вокруг файла, который по своей природе должен описывать текущее состояние, включая чувствительные значения.
Частые вопросы
Если переменная помечена sensitive = true, секрет в state всё равно есть?
Да. Эта настройка скрывает значение из вывода в консоли и логов выполнения, но не шифрует и не удаляет значение из самого файла состояния.
Нужно ли шифровать state, если доступ к хранилищу закрыт паролем или ролями?
Да, это разные уровни защиты. Шифрование защищает от прямого доступа к данным на диске хранилища, ограничение доступа — от сетевого и логического доступа. Полагаться только на один уровень рискованно.
Достаточно ли удалить последнюю версию state с секретом?
Нет, если включено версионирование хранилища. Старые версии файла могут оставаться доступными в истории с тем же уровнем прав, что и текущая версия.
С чего начать проверку, если state хранится локально на ноутбуках разработчиков?
С перевода на удалённый backend с шифрованием и общими правами доступа для команды. Локальные копии state на отдельных машинах труднее контролировать и легче потерять вместе с устройством.
Разбор подготовлен редакцией Vechron по открытым источникам. Нашли неточность — напишите нам.




