0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

【Terraform×AWS】KMSのカスタマー管理キーでS3を暗号化する:権限の渡し方と削除の注意点

0
Posted at

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でコードにしておけば、鍵の設定と権限をいつでも確認でき、誤って削除する事故も防ぎやすくなります。

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?