INFRASTRUCTURE LEARNINGインフラ学習
インフラ大全インフラ大全IT INFRASTRUCTURE / LEARNING
インフラ学習ガイド
教材・演習を探す/

Escで閉じる · 検索語は送信しません

LEARNINGEN

テーマ別の解説テーマ:Terraform:変更の流れと機密情報

Terraformの機密情報を守る:sensitiveとstate・planの注意点

sensitiveは表示を伏せる指定で、値を保存しない保証ではありません。 state、保存plan、明示的な値の出力、CIの成果物を分けて確認します。秘密を扱うときは「どこから来るか・どこへ残るか・誰が読めるか」を追いましょう。

この教材で学ぶこと

表示の秘匿と保存の抑制を区別し、state・plan・ログの保護と、ephemeral/write-onlyの適用条件を説明する。

先に知っておくこと

Terraformのplan・apply・stateを知っていると読みやすい教材です。値は架空の説明用で、実際の秘密・state・planを入力する機能はありません。

伏字表示と、ファイルへ保存される内容は別

HCLの反例:伏字にしても保存の問題は残る長い行は横スクロールで読めます。コード欄では左右キーを使えます。
variable "report_token" {
  type      = string
  sensitive = true
}

output "token_for_reading_example" {
  value     = var.report_token
  sensitive = true
}

これは秘密をoutputへ追加する推奨例ではありません。入力変数と、root moduleの出力を両方sensitiveにしても、表示と保存は別問題だと読む反例です。不要な出力は作らず、値を使う必要のある場所を先に絞ります。

同じ架空値でも、確認する場所が違う
確認する場所読み方
通常の表示sensitiveで隠れて見えても、値の存在は否定できない。
state管理対象の属性や出力等に機密値が含まれ得る。アクセス保護が必要。
保存plan画面で伏せた値でも、保存物に含まれ得る。公開ファイル扱いにしない。
値の明示出力とログ名前指定のoutputや-json/-raw等は値を示し得る。CIへ転載しない。

値の経路と、読む権限をたどる

秘密の経路:伏字だけでは保存先を守れない
秘密の経路:伏字だけでは保存先を守れない1: 値の供給元 — 渡す — Terraformの処理. 2: Terraformの処理 — 保存経路 — state・保存plan. 3: Terraformの処理 — 表示経路 — 出力・CIログ123値の供給元Terraformの処理state・保存plan出力・CIログ秘密の経路:伏字だけでは保存先を守れない1: 値の供給元 — 渡す — Terraformの処理. 2: Terraformの処理 — 保存経路 — state・保存plan. 3: Terraformの処理 — 表示経路 — 出力・CIログ123値の供給元Terraformの処理state・保存plan出力・CIログ
  1. 値の供給元 → Terraformの処理渡す
  2. Terraformの処理 → state・保存plan保存経路
  3. Terraformの処理 → 出力・CIログ表示経路
値の供給元
必要な場所だけへ渡す
Terraformの処理
入力と参照先を確認
state・保存plan
保存・権限・保持期間
出力・CIログ
伏字の例外・転載先

remote backendへ移したことだけで保護完了とはしません。暗号化・アクセス権・同時操作の制御・保存期間は、それぞれ確認が必要です。 backendの排他制御は競合対策で、機密性の代わりにはなりません。

ephemeralは、保存を抑えるための別の指定

HCLの読解例:値を直書きしない長い行は横スクロールで読めます。コード欄では左右キーを使えます。
variable "session_token" {
  type      = string
  sensitive = true
  ephemeral = true
}
使える版と参照先を確認する
確認点条件
Terraformの版変数やchild module出力等のephemeralは1.10以降。
参照できる場所provider設定等のephemeral contextに限定される。通常の永続属性へ自由に流せるわけではない。
出力の境界ephemeralなchild module出力は使えるが、root module出力には指定できない。
表示の秘匿保存を抑えるephemeralと、表示を伏せるsensitiveを分けて考える。

すべての変数へephemeralを足せば終わり、ではありません。値を必要とする引数が対応しているか、参照が許可されるかを確認します。値を別の出力やログへ自分で書き出せば、その経路の保護も必要です。

write-onlyは、対応する資源の引数で使う

言語の版とprovider側の対応は両方必要
項目確認すること
Terraformwrite-only引数は1.11以降が必要。
資源とprovider使いたい資源の、その引数がwrite-onlyとして定義されているか。
値の経路対応引数へ渡す値が、別の通常属性やoutputに複製されていないか。
更新方法必要な更新用のversion引数など、資源ごとの仕様を読む。

通常の引数へ好きな名前で_woを付けても、write-onlyにはなりません。 対応する資源仕様を確認してから設計します。この教材は特定providerの導入や実資源の作成を行いません。

レビューするのは設定だけでなく、保存物と配布先

  1. 実値が必要な処理と担当を絞り、不要なoutputや画面への転載を避ける。
  2. state・保存plan・CI成果物の保管場所、読める主体、暗号化、保持と削除を確認する。
  3. 版とproviderが対応する場合にephemeral/write-onlyを検討し、実際の値の経路で確認する。
  4. Gitの追跡済みファイルと履歴、CIログや成果物の複製も調べる。gitignoreだけで既存履歴が消えたとは扱わない。

機密情報の扱いを確かめる

選択すると、正誤と理由が表示されます。

通常表示が伏字なら、stateを誰でも読める場所へ置いてよい?
答えと理由を読む

正解:よくない。保存内容と読める主体を確認する · 伏字でもstateに機密値が含まれ得るので、アクセス保護が必要です。

レビュー画面では秘密が伏せられた。保存planを公開CI成果物にしてよい?
答えと理由を読む

正解:よくない。機密を含み得る保存物として保護する · 画面の伏字と保存planの内容は別の境界です。

root outputをsensitiveにした。名前指定や-json/-rawでも値は絶対に出ない?
答えと理由を読む

正解:いいえ。明示的な値の取得では表示され得る · 通常表示の秘匿だけで、明示出力やそのログを保護したとは言えません。

ephemeralな値を、root moduleのephemeral outputで保存せず公開できる?
答えと理由を読む

正解:できない。参照先とmodule境界を確認する · child module出力などの条件があり、root outputへ自由に流せません。

Terraformが1.11以降なら、任意のpassword引数をwrite-onlyにできる?
答えと理由を読む

正解:できない。資源ごとの対応引数を確認する · Terraformの版とproviderが提供する引数の両方が条件です。

stateをGitで追跡した後、gitignoreへ追加した。過去の値も消えた?
答えと理由を読む

正解:いいえ。追跡済み内容や履歴は別に確認する · ignore指定は、既に追跡している内容や過去の履歴を消す機能ではありません。

確認して、自分の言葉で説明する

  1. 反例で、表示の秘匿と保存の違いを読む。
  2. 経路図と条件表で、保存先・版・参照先を整理する。
  3. 設問と復習で、保護すべき保存物と主体を説明する。
理解を確かめる: 「sensitiveを付けたから安全」と言われたら、何を追加確認する?

stateと保存plan、明示出力、CIログや成果物、Gitへの混入を確認し、読む権限と保持を整理する。保存を抑える機能は版・参照先・providerの対応を確かめる。

表示、保存、複製先、読む主体はそれぞれ異なる保護対象だから。

出典と確認した条件

説明に用いた公式資料を、確認した内容・条件と本文の参照箇所に分けてまとめています。専門家による監修・実際のAWSとの比較検証は行っていません。