HN 日本語サマリー

← 一覧へ戻る
プログラミング

AWS Secrets Manager Terraform: 最小権限アクセス

AWS Secrets Manager Terraform: Least-Privilege Access (blog.victorsilva.com.uy)

18 pointsby meysamazad0 コメント

要約

AWS Secrets Managerで最小権限アクセスを実現する方法を、Terraformを用いて解説します。修正不可能な広範なIDベースポリシーしかない場合でも、シークレットにリソースベースポリシーを直接アタッチすることで、アクセスを効果的に制限できることを説明しています。このパターンは、AWS Academy Learner Labsのような環境で特に有効です。

全文翻訳

AWS Secrets Manager Terraform: 最小権限アクセス

AWSアカウントへのアクセス権限を付与されたものの、与えられたID(ロールでありユーザーではない)には既に広範な権限が付与されており、編集もできない状況を想像してみてください。さらに、iam:CreatePolicyを実行してより狭い権限を作成することもできません。それにもかかわらず、タスクは単純です。このデータベースパスワードをAWS Secrets Managerに保存し、Terraformでプロビジョニングし、アプリケーションのみがそれを読み取れるようにする必要があります。

もしあなたの直感が「IAMを制御しない限り不可能だ」というものであれば、あなたは最小権限を一方的にしか考えていません。この状況は、見た目よりも一般的です。AWS Academyのラーナーラボでは、全ての学生に、広範なIDポリシーを持ち、iam:CreateRole権限を持たない、事前に作成されたLabRoleを付与します。クロスアカウント設定では、あなたが所有していない別のアカウントから引き受けられたロールを渡されることがよくあります。ベンダー管理の実行環境(SaaSプラットフォームの「AWSアカウント持ち込み」統合、中央プラットフォームチームが全てのIAMポリシーを所有するSCPロックされたランディングゾーン)も、全く同じ状況に置かれます。つまり、作業するためのIDはありますが、そのIDがIAMレイヤーで何を実行できるかを狭める能力はゼロです。

この記事では、AWS Secrets Managerに特化したその問題を解決するパターンを解説します。触れることのできないIDベースのポリシーと戦う代わりに、リソースベースのポリシーをシークレットに直接アタッチします。AWSは両方のレイヤーを評価し、十分にスコープされたリソースポリシーは、広範すぎるIDポリシーを補完します。Terraformを使用して、シークレットの作成、値の安全な書き込み、そして必要なものだけを正確に制限するリソースポリシーのレイヤリングをエンドツーエンドで構築し、それが実際に機能することを肯定的なテストと否定的なテストの両方で検証します。

この記事が意図的にカバーしていないことの一つは、シークレットのローテーションです。シークレットを作成し、誰がそれを読み取れるかをロックダウンすることは、それ自体で大きなトピックであり、Lambda関数によるローテーションは、それ自身の記事に値します。それは次に続きます。

デュアルレイヤーアクセスモデル:IDポリシーが機能しない場合にリソースポリシーが機能する理由

AWS Secrets Manager(および一般的にIAM)における全ての認可決定は、同じリクエストに対して2つの独立したポリシータイプを評価した結果です。

  • IDベースのポリシー — 呼び出し元のプリンシパル(ユーザー、ロール、またはフェデレーテッドID)にアタッチされます。これは「このIDは何ができるか」というポリシーです。私たちのシナリオでは、これはLabRoleです。広範で、事前に作成されており、手が届きません。
  • リソースベースのポリシー — アクセスされるリソースにアタッチされます。Secrets Managerの場合、これはaws_secretsmanager_secret_policyリソースです。これは「この特定のシークレットに誰が触れることができるか」というポリシーであり、実際に制御できる唯一のレバーです。

AWSは全てのリクエストに対して両方のレイヤーを評価し、その組み合わせロジックは、一度理解すればシンプルです。

  1. どちらかのレイヤーに、リクエストに一致する明示的なDenyが含まれている場合、リクエストは拒否されます。それ以上何も問題になりません。
  2. どちらのレイヤーにも拒否がない場合、リクエストは、少なくとも一方のレイヤーに明示的なAllowが含まれている場合のみ許可されます。
  3. 明示的に許可されていないものはすべて、暗黙的に拒否されます。

このパターンを可能にする部分がここにあります。シークレットにリソースベースのポリシーが存在する場合、AWSはそのリソースに対してそれを権威あるものとして扱います。IDポリシーで広範なsecretsmanager:*権限を持つプリンシパルでも、シークレットのリソースポリシーがアクセスを許可しない限り、拒否されます。逆に、シークレットにアタッチされた狭いリソースポリシーは、IDポリシーだけでは問題にならないプリンシパルにアクセスを許可できます。しかし、私たちにとってより重要なのは、リソースポリシーのAllowを特定のプリンシパル、特定の操作、特定の条件にスコープすることで、広範すぎるIDポリシーが本来許可するであろうものを制限できることです。

平たく言えば、LabRoleがIDレイヤーでsecretsmanager:GetSecretValueを*に対して呼び出すことが許可されていても、シークレットのリソースポリシーが「はい、このプリンシパルに限り、これらの条件で」と言わない限り、それは問題になりません。あなたはLabRoleを狭めているのではありません。あなたは、その自身のポリシーがどれほど寛容であっても、LabRoleが通過しなければならないシークレットの周りにゲートを構築しているのです。

リクエスト: LabRole がシークレット X に対して secretsmanager:GetSecretValue を呼び出す
                    │
        ┌───────────┴────────────┐
        │                        │
  ID ポリシー          リソースポリシー
  (LabRole — 広範、        (シークレット X にアタッチ —
   編集不可)            制御可能なレバー)
        │                        │
        │   許可 (暗黙的、     │   許可、LabRole ARN に
        │   広範なワイルドカード) │   スコープ + VersionStage = AWSCURRENT
        │                        │
        └───────────┬────────────┘
                     │
        両方のレイヤーが許可する必要があり、
        どちらかのレイヤーでの明示的な Deny が優先される
                     │
              ┌──────┴──────┐
              │   決定     │
              └─────────────┘

これはクラウドセキュリティにおける補償的統制の背後にあるメカニズムです。根本原因を修正できない場合、影響範囲を制約する第二の独立したレイヤーを追加します。これはアカデミーに固有の回避策ではなく、形状を変えられないIDを引き継ぐ場合はいつでも正しいパターンです。

開始前の前提条件と自己チェック

必要となるもの:

  • Terraform >= 1.5 (secret_stringのメインパターンを使用。Terraform >= 1.11の場合は書き込み専用の代替手段も示します)
  • AWSプロバイダー hashicorp/aws >= 5.0
  • AWS CLI v2、ラボセッション用の認証情報で設定済み(アカデミーセッションは通常約4時間で期限切れになり、一時的な認証情報を再コピーする必要があります)
  • アクティブなAWS Academyラーナーラボセッション、または変更できない事前作成済みロールで作業している任意のAWS環境

アカデミーの正確な許可サービスリストは公式には公開されておらず、コースやラボテンプレートによって異なります。推測しないで、確認してください。Terraformを一行書く前に、2つのことを確認してください。あなたが誰であるか、そしてSecrets Managerがこのセッションで到達可能かどうか。

# セッションが実際に使用しているIDを確認
aws sts get-caller-identity

# Secrets Manager が到達可能で、このラボで許可されているか確認
aws secretsmanager list-secrets --region us-east-1

最初のコマンドは、ARNにassumed-role/LabRole(またはコーステンプレートによってはvoclabs)が含まれていることを返すはずです。2番目のコマンドは、新規アカウントでは空のSecretList: []を返すはずであり、AccessDeniedExceptionではありません。2番目のコマンドが失敗した場合、ここで停止してください。この特定のラボテンプレートはSecrets Managerを公開しておらず、Terraformの量ではそれを修正できません。

以下の全ての例は、通常のアカデミーのデフォルトリージョンであるus-east-1を対象としています。これはaws_region変数で完全に設定可能ですが、アカデミーラボが使用可能なリージョンを制限する場合があることに注意してください。切り替える前に確認してください。

ステップバイステップ実装

プロバイダーと変数

プロバイダーブロックに変わったものはありませんが、バージョンを固定してください。リソースポリシーの動作とblock_public_policyのサポートは特定のプロバイダーリリースで導入されており、依存しているフィールドをサポートしていないバージョンをterraform initがサイレントに取得するのを避けたいからです。

terraform {
  required_providers {
    aws = {
      source  = "hashicorp/aws"
      version = "~> 5.0"
    }
  }
  required_version = ">= 1.5"
}

provider "aws" {
  region = var.aws_region
}
variable "aws_region" {
  description = "全てのソースのAWSリージョン"
  type        = string
  default     = "us-east-1"
}

variable "db_password" {
  description = "データベースパスワードのシークレット値。TF_VAR_db_password を介して設定され、コミットされることはありません。"
  type        = string
  sensitive   = true
}

db_password変数はデフォルト値が設定されていません。Terraformを実行する前に環境変数としてエクスポートします。これにより、.tfファイル、シェル履歴(先頭にスペースを使用すると、ほとんどのシェルはログに記録しません)、およびバージョン管理から完全に除外されます。

export TF_VAR_db_password="$(openssl rand -base64 24)"
terraform apply
LabRole ARN の動的な解決

リソースポリシーで参照するためにLabRoleの完全なARNが必要ですが、そのARNにはアカウントIDが含まれています。アカウントIDはハードコーディングすべきではありません。なぜなら、アカデミーがラボをリセットするたびに変更されるからです。また、コンテキストに関わらず、TerraformでアカウントIDをハードコーディングすることは移植性の問題です。aws_caller_identityデータソースは、Terraformが現在使用している認証情報のIDを提供します。

data "aws_caller_identity" "current" {}

locals {
  lab_role_arn = "arn:aws:iam::${data.aws_caller_identity.current.account_id}:role/LabRole"
}

環境が異なる名前の事前作成済みロール(クロスアカウントで引き受けられたロール、ベンダー管理の実行ロール)を使用している場合は、LabRoleをそのロール名に置き換えてください。それ以降の全ては同じままです。この文字列だけが変わります。

シークレットコンテナの作成
resource "aws_secretsmanager_secret" "db_password" {
  name                    = "app/production/db-password"
  description             = "本番アプリケーション層のデータベース管理者パスワード"
  recovery_window_in_days = 0

  tags = {
    Environment = "production"
    ManagedBy   = "terraform"
  }
}

立ち止まって確認する価値のある2つの詳細:

recovery_window_in_days = 0 は、Terraformがシークレットを破棄する際に、シークレットを即座に削除します(7〜30日のソフト削除ウィンドウなし)。通常のAWSアカウントでは、これについて二度考えるでしょう。ソフト削除は誤った削除に対するセーフティネットです。しかし、アカデミーラボでは、セッションは約4時間ごとにリセットされ、以前のセッションが保留中の削除状態のシークレットを残した後に、新しいセッションで同じTerraformを再適用した場合、aws_secretsmanager_secretの作成は名前の衝突で失敗します。Secrets Managerは、ソフト削除されたものによってまだ予約されている名前で新しいシークレットを作成することを許可しません。リカバリウィンドウをゼロに設定すると、terraform destroyは名前を即座に解放します。これは、複数の短命なセッションを跨いで反復処理する場合に非常に重要です。安定したライフサイクルを持つ実際のプロダクションアカウントでは、デフォルトのリカバリウィンドウを使用する可能性が高いでしょう。

KMS設定は一切なし。 このブロックにkms_key_id引数がないことに注意してください。Secrets Managerは、デフォルトでAWS管理キーaws/secretsmanagerを使用して、全てのシークレットを暗号化して保存します。このデフォルトキーを使用するには、追加のIAM権限は一切不要です。LabRoleの既存のアクセスで十分です。なぜなら、カスタマー管理KMSキーのように、AWS管理キーは明示的なキーポリシーの許可を必要としないからです。これは本当にAWS固有です。GCP Secret ManagerとOCI Vaultの両方で、シークレットが機能する前に、プロバイダー管理またはカスタマー管理キーとその独自の許可が必要になります。AWSは、どちらよりも速く「保存時に暗号化、追加設定ゼロ」を実現します。

シークレット値の書き込み
resource "aws_secretsmanager_secret_version" "db_password" {
  secret_id     = aws_secretsmanager_secret.db_password.id
  secret_string = var.db_password
}

これはメインラインのパターンであり、どこでも機能しますが、それが何をするかを明確に理解してください。secret_stringは、このリソースの属性としてプレーンテキスト値をTerraformステートファイルに書き込みます。変数をsensitive = trueとマークすることは、CLI出力(terraform plan/applyログ)からそれを抑制するだけで、ステートファイルに値が格納された後の保護には何も影響しません。Terraformのバージョンによって軽減策のランクが異なるため、これはセキュリティの考慮事項のセクションで適切に説明します。このブログのGCPとOCIのシークレットに関する投稿で指摘した問題と同じです。

Terraform >= 1.11を実行している場合、より良いオプションがあります:secret_string_wo、書き込み専用属性です。書き込み専用属性はステートに永続化されることはありません。Terraformは適用中に値を送信し、その後忘れます。代わりに、コンパニオンバージョンカウンターによって追跡されます。

resource "aws_secretsmanager_secret_version" "db_password_wo" {
  secret_id                = aws_secretsmanager_secret.db_password.id
  secret_string_wo         = var.db_password
  secret_string_wo_version = 1 # 新しい値をプッシュするためにこの整数を増やす
}

この記事では、多くのパイプライン(アカデミー環境を含む)が古いTerraformバージョンに固定されているため、secret_string_woはそこでは利用できないため、メインラインの例としてsecret_stringを維持しています。1.11以降を使用している場合は、こちらを優先してください。

中心的な要素:LabRole を制限するリソースポリシー

これが実際の最小権限作業が行われる場所です。JSONを直接作成するのではなく、aws_iam_policy_documentを使用してポリシー文書を構築します。これはエラーが発生しにくく、Terraformは生のJSON文字列では検出できない構造的な間違いを計画時に検出します。

data "aws_iam_policy_document" "db_password_resource_policy" {
  statement {
    sid    = "AllowLabRoleReadCurrentVersion"
    effect = "Allow"

    principals {
      type        = "AWS"
      identifiers = [local.lab_role_arn]
    }

    actions = [
      "secretsmanager:GetSecretValue",
      "secretsmanager:DescribeSecret",
    ]

    resources = [aws_secretsmanager_secret.db_password.arn]

    condition {
      test     = "StringEquals"
      variable = "secretsmanager:VersionStage"
      values   = ["AWSCURRENT"]
    }
  }
}

resource "aws_secretsmanager_secret_policy" "db_password" {
  secret_arn          = aws_secretsmanager_secret.db_password.arn
  policy              = data.aws_iam_policy_document.db_password_resource_policy.json
  block_public_policy = true
}

これが実際に何をもたらすかを順を追って説明します。

Allowステートメントは、LabRole — そしてLabRoleのみ(その完全なARNで参照) — がこの1つのシークレットに対してGetSecretValueとDescribeSecretを呼び出すことを許可します。それ以上の広範な権限はありません。LabRoleのIDポリシーがアカウント内の全てのシークレットにアクセスすることを許可しているとしても、このリソースポリシーがLabRoleとこの特定のシークレットの間に立ちはだかる唯一のものであり、「現在のバージョンのみ、このアクションセットのみ」と述べています。

secretsmanager:VersionStage条件は、これを装飾的なものではなく、真に制限的なものにしています。Secrets Managerはバージョンをステージでラベル付けします — AWSCURRENTはアクティブなもの、AWSPREVIOUSは最後の更新の前にカレントだったものです。条件をAWSCURRENTに制限することは、このプリンシパルがライブ値を読み取ることはできますが、以前のステージを明示的に要求することによって古い値にロールバックすることはできないことを意味します。これがなければ、GetSecretValueを呼び出すことができる人なら誰でも、--version-stage AWSPREVIOUSを要求して、シークレットが以前何であったかを読み取ることができます。

block_public_policy = trueは、実際に役立つAWS固有のガードレールをオンにします。Secrets Managerは、AWSの自動推論エンジンであるZelkovaを使用してリソースポリシーをチェックし、ポリシーがPrincipal: "*"へのアクセスを許可したり、シークレットを事実上公開したりする場合、applyを outright に拒否します。GCP Secret ManagerのIAMバインディングモデルもOCI Vaultのコンパートメントスコープポリシーも、ポリシーを受け入れる前にこのような形式検証パスを実行しません。デフォルトでオンにしておいてください。これは、本番環境に到達する前に間違いを検出するだけです。

明示的にフラグを立てる価値のある注意点があります。Terraformは、計画時にpolicy = "{}"を設定することを喜んで許可します — JSONとしては構文的に有効ですが、Secrets Manager APIは適用時にそれを拒否します。リソースポリシーには少なくとも1つのステートメントが必要です。リソースポリシーは「空だが存在する」というものは存在しません。

高度なバリアント:VPCエンドポイントによる制限(オプション)

ワークロードがSecrets Manager VPCエンドポイント(com.amazonaws.<region>.secretsmanagerインターフェイスエンドポイント)を経由してVPC内からのみSecrets Managerを呼び出す場合、その特定のエンドポイントを経由しないリクエストを拒否する2番目のステートメントを追加できます。これは真に強力な制御です — 攻撃対象領域を「この1つのエンドポイントを通過したトラフィック」に収束させます — しかし、それは厳格な前提条件があります:VPCエンドポイントが既に存在している必要があります。アカデミーラボのVPCには、デフォルトでそれが付属していないことがよくあります。また、独自のaws_vpc_endpointリソースを作成することが、ラボセッションで許可されている範囲内にあるかどうかはわかりません。

これをメインラインのパスではなく、高度なパスとして扱ってください。

variable "secretsmanager_vpc_endpoint_id" {
  description = "VPC内にSecrets ManagerのVPCエンドポイントが存在する場合のID。この制御をスキップする場合は空のままにします。"
  type        = string
  default     = ""
}

data "aws_iam_policy_document" "db_password_resource_policy_with_vpce" {
  source_policy_documents = [data.aws_iam_policy_document.db_password_resource_policy.json]

  statement {
    sid    = "DenyOutsideVpcEndpoint"
    effect = "Deny"

    principals {
      type        = "AWS"
      identifiers = [local.lab_role_arn]
    }

    actions   = ["secretsmanager:GetSecretValue"]
    resources = [aws_secretsmanager_secret.db_password.arn]

    condition {
      test     = "StringNotEquals"
      variable = "aws:sourceVpce"
      values   = [var.secretsmanager_vpc_endpoint_id]
    }
  }
}

resource "aws_secretsmanager_secret_policy" "db_password_vpce" {
  count = var.secretsmanager_vpc_endpoint_id != "" ? 1 : 0

  secret_arn          = aws_secretsmanager_secret.db_password.arn
  policy              = data.aws_iam_policy_document.db_password_resource_policy_with_vpce.json
  block_public_policy = true
}

これは明示的なDenyであり、2番目のAllowではありません — どこかのDenyが常に優先されるため、このステートメントは既存の許可の上に例外を設けているだけです。countガードは、VPCエンドポイントIDが提供されていない場合にリソースが作成されないことを意味するため、このブロックは、それを持っていない環境を壊すことなくモジュールに残すことができます。

この設定を配線する前に、ラボVPCに既にSecrets Managerエンドポイントがあるかどうかを確認したい場合:

aws ec2 describe-vpc-endpoints \
  --filters "Name=service-name,Values=com.amazonaws.us-east-1.secretsmanager" \
  --query 'VpcEndpoints[].VpcEndpointId' --output text

それが空で返された場合、このセクション全体をスキップしてください — メインライン例のVersionStage条件は、それ自体で既に実際の作業を行っています。

テストと検証

設定を適用し、肯定的なテストと否定的なテストの両方を実行します。これは、リソースポリシーが単に存在するだけでなく、実際に何かをしていることを証明する部分です。

シークレットとその暗号化キーの確認
aws secretsmanager describe-secret \
  --secret-id app/production/db-password \
  --region us-east-1 \
  --query '{Name:Name, ARN:ARN, KmsKeyId:KmsKeyId, LastChangedDate:LastChangedDate}'

KmsKeyIdは空で返されるか、デフォルトのaws/secretsmanagerエイリアスを参照する必要があります — 保存時の暗号化がアクティブであることを、あなたが何も設定していないことを確認します。

リソースポリシーがアタッチされていることの確認
aws secretsmanager get-resource-policy \
  --secret-id app/production/db-password \
  --region us-east-1 \
  --query 'ResourcePolicy' --output text | jq .

あなたのLabRole ARNにスコープされたAllowステートメントと、VersionStage条件がそのまま残っているのを見るはずです。これが空で返された場合、aws_secretsmanager_secret_policyリソースが適用されなかったか、拒否されたかのどちらかです — Zelkovaの拒否に関するterraform applyの出力を確認してください。

肯定的なテスト:LabInstanceProfile を実行している EC2 インスタンスからの読み取り

LabInstanceProfile(アカデミーがコンピューティング用に提供するLabRoleをラップするインスタンスプロファイル)をアタッチしたEC2インスタンスを起動(または既存のものを使用)します。そのインスタンスのシェルから:

aws secretsmanager get-secret-value \
  --secret-id app/production/db-password \
  --region us-east-1 \
  --query SecretString --output text

これは、TF_VAR_db_passwordを介して設定したプレーンテキスト値を返すはずです。インスタンスに静的認証情報はありません — インスタンスプロファイルのテンポラリ認証情報を使用しており、リソースポリシーは明示的にLabRole(LabInstanceProfileが引き受けるもの)にAWSCURRENTの読み取りアクセスを許可しています。

否定的なテスト:ポリシーが許可しないバージョンステージを要求する

これは有用な部分です。なぜなら、アカデミーラボではテストするための2番目のIDがないからです — 全員がLabRoleです。代わりに、条件が本物であることを、それを直接違反することで証明します。まず、以前のバージョンが存在するように新しいバージョンをプッシュして、それを違反の対象とします。

aws secretsmanager put-secret-value \
  --secret-id app/production/db-password \
  --secret-string "rotated-test-value" \
  --region us-east-1

これにより新しいAWSCURRENTが作成され、古い値はAWSPREVIOUSにダウングレードされます。次に、以前のステージを明示的に読み取ろうとします。

aws secretsmanager get-secret-value \
  --secret-id app/production/db-password \
  --version-stage AWSPREVIOUS \
  --region us-east-1 \
  --query SecretString --output text

これは失敗するはずです。エラーテキストは正確なメカニズムを名指しします。

An error occurred (AccessDeniedException) when calling the GetSecretValue operation:
User: arn:aws:sts::123456789012:assumed-role/LabRole/i-0abcd1234ef567890 is not authorized
to perform: secretsmanager:GetSecretValue on resource: app/production/db-password
because no resource-based policy allows the secretsmanager:GetSecretValue action

そのメッセージは、デュアルレイヤーモデルを可視化したものです。LabRoleのIDポリシーは広範であるため、AWSはID側について文句を言いません — エラーは具体的に「リソースベースのポリシーがこのリクエストを許可していない」というものです。なぜなら、VersionStage条件がAWSPREVIOUSと一致しないからです。補償的統制は、設計通りに機能しています。

実際の2番目のプリンシパル(別のAWSアカウントの別のIAMロール)が利用可能な場合 — 真のクロスアカウントテストのため — そのIDからAWSCURRENTに対して同じget-secret-value呼び出しを実行すると、同じ根本的な理由で同様に失敗します。それは単にポリシーのprincipalsブロックに名前がありません。

アプリケーションコードからのシークレットの読み取り

CLIは検証には適していますが、実際のワークロードはSDKを使用します。以下はboto3の同等物であり、同じインスタンスプロファイル認証情報とリソースポリシーを尊重します。

import boto3
from botocore.exceptions import ClientError


def get_secret(secret_id: str, region: str = "us-east-1") -> str:
    client = boto3.client("secretsmanager", region_name=region)
    try:
        response = client.get_secret_value(SecretId=secret_id)
    except ClientError as e:
        raise RuntimeError(f"Unable to retrieve secret '{secret_id}': {e}") from e
    return response["SecretString"]


if __name__ == "__main__":
    db_password = get_secret("app/production/db-password")
    print(f"Secret retrieved successfully (length: {len(db_password)})")

このスクリプトではどこにも認証情報は設定されていません — boto3はインスタンスプロファイルのテンポラリ認証情報を自動的に取得します。これは、上記のCLIテストと同じIDチェーンです。LabInstanceProfileを持たないインスタンス以外の場所から実行すると、同じAccessDeniedExceptionで失敗します。

セキュリティに関する考慮事項

このパターンを実際の環境に持ち込む前に、内面化する価値のある点がいくつかあります。

これをアカデミー限定のトリックとして扱わないでください。 IDポリシーを編集できない瞬間 — 他のチームが所有するロール、管理していないアカウントのロール、プラットフォームチームが全てのIAM変更を所有するSCPロックされた環境 — このパターンがあなたの答えです。自分で制御するIDポリシーがそれ自体で十分に狭いと仮定しないでください。リソースポリシーは、防御の2番目の独立したラインであり、保持する価値があります。

デフォルトでblock_public_policy = trueをオンのままにしてください。 シークレットのリソースポリシーがPrincipal: "*"を許可する正当な理由は実質的に存在しません。このチェックのコストはゼロです — 間違いをブロックするだけです。

サービスプリンシパルに拡張する場合、混乱した代行者(confused deputy)の問題に注意してください。 ここにある全てはIAMロールへのアクセスを許可します。後でAWSサービスプリンシパルにリソースポリシーのステートメントを付与する場合(例えば、CloudFormationやEventBridge経由)、aws:SourceArnおよび/またはaws:SourceAccount条件を追加してください。それらがないと、どの顧客のそのサービスタイプの、どのアカウントのリソースも、あなたのシークレットへのアクセスをトリガーする可能性があります。上記のLabRoleの例では問題ありませんが、ロールではなくサービスに付与し始めると、自然な次の間違いです。

ステート露出の軽減策を正しくランク付けしてください。 secret_stringはプレーンテキストをterraform.tfstateに書き込みます。各オプションがその値を実際に保護する度合いで降順に並べると:

  1. secret_string_wo (Terraform >= 1.11) — 値はステートに全く書き込まれません。Terraformバージョンがサポートしている場合、最も強力なオプションです。
  2. 別ライフサイクルパターン — Terraformはシークレットコンテナとリソースポリシーのみを管理します。CI/CDパイプラインステップ(または人)が後でaws secretsmanager put-secret-valueを使用して実際の値を書き込みます。これはTerraformのステートの外側で行われます。これはどのTerraformバージョンでも機能し、まだ1.11にいないチームにとって正しい選択です。
  3. sensitive = true — 3つの中で最も弱い。これはplan/applyコンソール出力から値を抑制しますが、ステートファイル自体には何も影響しません。あなたのステートバックエンドへの読み取りアクセス権を持つ人は誰でも、terraform state showまたはterraform output -json(出力として表示されている場合)で値を抽出できます。このフラグを実際の保護と混同しないでください。

このブログのGCP Secret ManagerとOCI Vaultについて説明したのと同じトレードオフです — 基本的な問題、つまりTerraformステートがプレーンテキストシークレットストアであることは、プロバイダー間で普遍的です。軽減策の名前だけが異なります。

CIS AWS Foundations Benchmarkとの整合性。 ここで構築したものから直接導き出される2つの関連するコントロールがあります。シークレットは公開可能であってはならない(block_public_policy = trueでカバーされ、手動監査ではなく適用時に自動的に検証される)、シークレットは保存時に暗号化されなければならない(Secrets Managerはデフォルトでこれを提供し、オプトアウトなし — 誤って作成できる「暗号化されていないシークレット」リソースの同等物はありません)。これらのチェックを手動ではなく中央で追跡したい場合は、このブログのAWS Security HubとTerraformの記事を参照して、このような発見を単一のダッシュボードに配線してください。

もう一つ知っておくと良いこと、簡潔に: AWSのセキュリティブログは、2026年4月にSecrets Managerがポスト量子TLS(ML-KEM鍵交換)をトランスポートレイヤーに採用したことをカバーしました。これは、Terraformの書き方やリソースポリシーの設計には何も影響しません — これはAWSが透過的に展開するトランスポートレイヤーのアップグレードです — しかし、Secrets Managerの基盤となるインフラストラクチャが積極的に強化されており、盲目的に信頼する静的なサービスではないという良い兆候です。

GCPとOCIのシークレットモデルとの比較

このブログのOCI Vaultの記事またはGCP Secret Managerの記事を読んだことがあるなら、ここのアクセス制御モデルは、単にラベルが付け替えられただけでなく、意味的に異なると感じるはずです。

GCP Secret ManagerとOCI Vaultは両方ともIAMバインディングモデルを中心に据えています。プリンシパルにシークレットにスコープされたロールを付与します(GCPのgoogle_secret_manager_secret_iam_member — これらのロールバインディングとサービスアカウントの構築方法については、GCP IAM Terraformの記事を参照してください)、またはコンパートメントスコープのポリシー(OCIのAllow group ... to read secret-bundles in compartment ...)を記述します。アクセス許可は完全にID側に存在します — IAMとは別に「シークレット自体に存在するポリシー」というレイヤーはありません。

AWSのデュアルレイヤーモデルは本当に異なります。リソースは、IDのポリシーと並行して評価される独自のポリシーを保持します。それがLabRoleの問題を解決可能にする具体的な機能です。AWSがGCPやOCIのように動作した場合、変更不可能なLabRoleは行き止まりになります — それを狭めるレバーはどこにもありません。リソースベースのポリシーがそのレバーです。

まとめ

Terraformを使用して、Secrets Managerシークレットをゼロから構築しました — コンテナ、安全にソースされた値、そして制御できないIDが何を実行できるかを実際に制限するリソースポリシーです。VersionStage条件、block_public_policy、および動的なロールARNのためのaws_caller_identityルックアップは、「シークレットにJSONをアタッチする」を実際の最小権限制御に変える要素であり、EC2インスタンスからの肯定的な読み取りと、設計通りに失敗する否定的なテストの両方で検証されました。

意図的に触れなかったこと — それはローテーションです。シークレットを作成し、読み取りアクセスをロックダウンすることは、ライフサイクルの半分に過ぎません。そのシークレットの値がLambdaローテーション関数とaws_secretsmanager_secret_rotationリソースで自動的に最新の状態に保たれるようにすることは、それ自身の記事に値する大きなトピックです。それは次に続きます。

ハッピースクリプティング!