S3やRDSのデータは、AWSが管理する鍵で暗号化するだけでも、保存されたデータは守られます。ただ、「誰がデータを復号できるかを細かく決めたい」「鍵の利用を監査ログに残したい」といった要件があると、**自分で管理するKMSの鍵(カスタマー管理キー)**が必要になります。
この記事では、KMSのカスタマー管理キーをTerraformで作り、S3の暗号化に使う方法と、運用で注意することを紹介します。
AWS管理キーとカスタマー管理キーの違い
- SSE-S3(S3が管理する鍵):S3が自動で暗号化する。設定は不要で、料金もかからない
- AWS管理キー(aws/s3 など):KMSの鍵だが、AWSが作成・管理する。鍵のポリシーは変更できない
- カスタマー管理キー:自分で作るKMSの鍵。鍵のポリシーで使える人を決められ、ローテーションや削除も自分で管理する
カスタマー管理キーを使う理由は、主に次の3つです。
- アクセスを分けられる:S3を読む権限があっても、鍵を使う権限がなければ、データを復号できない
- 利用を記録できる:鍵を使うたびにCloudTrailに記録され、誰がいつ復号したかを確認できる
- 別アカウントと共有できる:鍵のポリシーで、別のAWSアカウントに使う権限を渡せる
鍵を作る
data "aws_caller_identity" "current" {}
data "aws_iam_policy_document" "kms" {
statement {
sid = "AllowAccountAdmin"
actions = ["kms:*"]
resources = ["*"]
principals {
type = "AWS"
identifiers = ["arn:aws:iam::${data.aws_caller_identity.current.account_id}:root"]
}
}
}
resource "aws_kms_key" "data" {
description = "myapp prod data encryption"
enable_key_rotation = true
deletion_window_in_days = 30
policy = data.aws_iam_policy_document.kms.json
}
resource "aws_kms_alias" "data" {
name = "alias/myapp-prod-data"
target_key_id = aws_kms_key.data.key_id
}
- 鍵のポリシー:この例では、アカウント(root)に全権限を与えている。これは「このアカウントのIAMポリシーで、鍵の権限を管理できるようにする」という意味で、AWSが既定で作るポリシーと同じ考え方
- enable_key_rotation:鍵の中身(鍵の素材)を自動で新しくする。古いデータも引き続き復号できるので、アプリケーション側の対応は要らない
- deletion_window_in_days:削除を予約してから実際に削除されるまでの日数(7〜30日)
- エイリアス:鍵IDの代わりに使える分かりやすい名前。コンソールでも見分けやすくなる
S3の暗号化に使う
resource "aws_s3_bucket_server_side_encryption_configuration" "data" {
bucket = aws_s3_bucket.data.id
rule {
apply_server_side_encryption_by_default {
sse_algorithm = "aws:kms"
kms_master_key_id = aws_kms_key.data.arn
}
bucket_key_enabled = true
}
}
bucket_key_enabled = true は、必ず付けておきます。KMSは、鍵を使うリクエストの数に応じて料金がかかります。バケットキーを有効にすると、S3がバケット単位の鍵を一時的に使い回すため、KMSへのリクエストが大きく減り、料金を抑えられます。
鍵を使う権限を渡す
アプリケーションのロールには、S3の権限に加えて、鍵を使う権限も必要です。
data "aws_iam_policy_document" "app" {
statement {
actions = ["s3:GetObject", "s3:PutObject"]
resources = ["${aws_s3_bucket.data.arn}/*"]
}
statement {
actions = ["kms:Decrypt", "kms:GenerateDataKey"]
resources = [aws_kms_key.data.arn]
}
}
- kms:GenerateDataKey:書き込み(PutObject)のときに、データを暗号化する鍵を作るために使う
- kms:Decrypt:読み込み(GetObject)のときに、データを復号するために使う
この権限がないと、S3の権限があっても AccessDenied になります。「S3の権限は付けたのに読めない」ときは、まずKMSの権限を確認します。
鍵の削除には特に注意する
**KMSの鍵を削除すると、その鍵で暗号化したデータは二度と復号できなくなります。**S3のオブジェクトもRDSのスナップショットも、読めないデータになります。
- lifecycle の prevent_destroy を付ける:terraform destroy や、誤ったコードの変更で削除されないようにする
- 削除の待機期間は長めにする:deletion_window_in_days を30日にしておけば、削除を予約してしまっても、その期間内なら取り消せる
- 削除の予約を通知する:EventBridgeで、KMSの ScheduleKeyDeletion の操作を検知して通知すると、気づかないまま削除されることを防げる
resource "aws_kms_key" "data" {
# ...
lifecycle {
prevent_destroy = true
}
}
使わなくなった鍵は、すぐに削除するのではなく、まず無効化して様子を見ます。無効化した鍵は、いつでも有効に戻せます。
鍵の数を増やしすぎない
カスタマー管理キーは、鍵1つごとに月額の料金がかかります。バケットごと・テーブルごとに鍵を作ると、数が増えて管理も料金も大変になります。
- 用途やデータの重要度で分ける:「アプリケーションのデータ」「ログ」「バックアップ」のように、アクセスできる人が同じものは1つの鍵にまとめる
- 環境ごとに分ける:dev と prod で同じ鍵を使わない。devの権限でprodのデータを復号できてしまうのを防ぐ
まとめ
- カスタマー管理キーを使うと、復号できる人を分けたり、鍵の利用を記録したりできる
- 鍵には enable_key_rotation を付け、エイリアスで分かりやすい名前を付ける
- S3で使うときは、bucket_key_enabled でKMSのリクエスト料金を抑える
- アプリケーションのロールには、kms:Decrypt と kms:GenerateDataKey の権限も渡す
- 鍵を削除すると、データは二度と復号できない。prevent_destroy と長めの待機期間で守る
- 鍵は用途と環境で分け、増やしすぎない
暗号化の鍵は、作るのは簡単でも、なくすと取り返しがつきません。Terraformでコードにしておけば、鍵の設定と権限をいつでも確認でき、誤って削除する事故も防ぎやすくなります。