Если секрет уже попал в Terraform log, считать его скрытым после удаления строки нельзя: CI мог сохранить artifact, отправить лог в агрегатор или показать его пользователям проекта. Первый шаг — ограничить доступ и отозвать credential. Редактирование конфигурации предотвращает повтор, но не отменяет уже состоявшееся раскрытие.
Не вставляйте значение секрета в задачу расследования. Достаточно типа credential, run ID, времени, пути артефакта и места появления: plan diff, output, provider debug или shell-команда. Rotation выполняется по процедуре владельца системы.
Каждая поверхность хранит данные по-своему
| Поверхность | Что делает sensitive | Что ещё требуется |
|---|---|---|
| terraform plan/apply | Редактирует известное значение | Не печатать через provisioner и внешние команды |
| CI log | Помогает только для Terraform-aware вывода | Маскирование runner и запрет debug |
| Saved plan | Может содержать нужные Terraform данные | Контроль доступа и срок хранения |
| State | Не удаляет значение | Защищённый backend, encryption, ACL, audit |
| Provider log | Не абсолютная граница | Доверенный provider и безопасный log level |
HashiCorp прямо указывает: sensitive скрывает значение в CLI и UI, но Terraform может хранить его в state. Логи также нельзя считать безусловной границей безопасности, особенно при debug или trace и при работе стороннего provider.
Конфигурация описывает намерение явно
variable "session_token" {
type = string
sensitive = true
ephemeral = true
}
provider "example" {
token = var.session_token
}
output "endpoint" {
value = example_service.main.endpoint
}sensitive редактирует отображение. ephemeral, доступный для переменных и некоторых других контекстов в Terraform 1.10+, исключает значение из plan и state, но накладывает ограничения на места использования. Write-only аргументы managed resource появились в Terraform 1.11+ и зависят от поддержки provider. Перед применением проверьте версию CLI и схему конкретного ресурса.
nonsensitive — осознанное снятие защиты
Функция nonsensitive сообщает Terraform, что значение безопасно показывать. Не используйте её только ради красивого plan. Если из секретного объекта нужен открытый признак, вычислите отдельное несекретное поле, например host или boolean, и документируйте, почему оно не раскрывает credential.
- Не помещайте секрет в output даже с временной целью.
- Не передавайте token аргументом командной строки provisioner.
- Не включайте TF_LOG=TRACE в общей CI-задаче.
- Не коммитьте tfvars и local state с credentials.
- Не загружайте saved plan в публичные artifacts.
State защищается отдельно
Terraform нужен state для сравнения управляемых атрибутов, поэтому sensitive не означает отсутствие значения в state. Используйте удалённый backend с шифрованием, минимальными правами, versioning и audit. Доступ к state часто равен доступу к инфраструктурным секретам.
Если секрет обнаружен в старых версиях state, rotation остаётся обязательной. Удаление history зависит от backend и политики хранения; выполняйте его как отдельную контролируемую операцию, не редактируя state вручную во время активного run.
Источник утечки находят по кратчайшему пути
- Обычный plan без debug: проверить outputs и атрибуты без sensitive metadata.
- Provider debug: выключить TF_LOG и проверить версию provider.
- local-exec или external data: проверить stdout/stderr дочернего процесса.
- CI shell tracing: отключить печать команд с раскрытыми переменными.
- Ошибка API: убедиться, что provider не включает Authorization или URL query в текст ошибки.
- Run Task или hook: считать сторонний компонент отдельным получателем данных.
Приёмка проверяет отсутствие значения, не его маску
Создайте новый короткоживущий тестовый credential, запустите plan и apply в изолированном workspace, затем выполните поиск по точному тестовому marker в логах и доступных артефактах. После теста credential отзывается. Строка (sensitive value) в CLI — хороший сигнал, но проверка state и сторонних логов остаётся отдельной.
Отчёт об инциденте не повторяет утечку
В отчёте оставьте run ID, тип и владельца credential, затронутые хранилища, время rotation, Terraform/provider versions и исправленную data flow. Сам секрет, фрагмент signed URL и полный state не прикладывают. Так команда может проверить закрытие всех каналов без нового распространения значения.