Если секрет уже попал в 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.

Источник утечки находят по кратчайшему пути

  1. Обычный plan без debug: проверить outputs и атрибуты без sensitive metadata.
  2. Provider debug: выключить TF_LOG и проверить версию provider.
  3. local-exec или external data: проверить stdout/stderr дочернего процесса.
  4. CI shell tracing: отключить печать команд с раскрытыми переменными.
  5. Ошибка API: убедиться, что provider не включает Authorization или URL query в текст ошибки.
  6. 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 не прикладывают. Так команда может проверить закрытие всех каналов без нового распространения значения.

Проверенные источники