Terraformで始めるAmazon Bedrock AgentCore ⑥〜Identity編〜
はじめに
Fusicのレオナです。本ブログはAmazon Bedrock AgentCoreをTerraformで構築してみたシリーズブログになります。今回はWorkload Identity編になります。
Amazon Bedrock AgentCoreとは
Amazon Bedrock AgentCoreは、2025年7月にPreview、10月にGAされたサービスです。AIエージェントを安全かつスケーラブルに運用するためのフルマネージド基盤で、実行環境(Runtime)・認証基盤(Identity)・Gateway・Memory・Code Interpreter・Browser・Observabilityのコンポーネントを備えています。GAに伴い、TerraformでIaCとして実装ができるようになりました。
Workload Identity 概要
Workload Identityは、AIエージェントのデジタルIDを表すコンポーネントです。エージェントがAWSリソースや外部サービスにアクセスする際の認証・認可を管理します。
| 特徴 | 仕様 |
|---|---|
| 役割 | エージェントのデジタルID |
| 用途 | Workload Access Tokenの取得 |
| 統合先 | Gateway, Agent Runtime, Token Vault |
| プロビジョニング | 手動/自動(Runtime・Gateway連携時) |
検証環境
- Terraform: v1.13.4
- AWS Provider: v6.20.0
- Python: 3.12
- Region: us-west-2
ディレクトリ構造
Workload Identityモジュールを実装します。
root/
├── modules/
│ └── bedrock-agentcore-identity/ # Workload Identity
│ ├── main.tf
│ ├── variables.tf
│ └── outputs.tf
├── envs/dev/ # 環境別設定
│ ├── main.tf
│ ├── variables.tf
│ ├── outputs.tf
│ └── providers.tf
└── tests/
└── 06_invoke_identity.py
0. 事前準備
前提条件
Workload Identityは、単独で作成できる独立したコンポーネントです。IAMロールの設定は不要です。
1. モジュール実装
1.1 Workload Identityモジュール
resource "aws_bedrockagentcore_workload_identity" "this" {
name = var.name
}
variable "name" {
description = "Workload Identity名"
type = string
}
output "workload_identity_arn" {
value = aws_bedrockagentcore_workload_identity.this.workload_identity_arn
}
1.2 環境設定
# Workload Identity Module
module "workload_identity" {
source = "../../modules/bedrock-agentcore-identity"
name = var.workload_identity_name
}
ポイント:
- スタンドアロンで作成、他モジュールへの依存なし
# Workload Identity Configuration
variable "workload_identity_name" {
description = "Name of the Workload Identity."
type = string
default = "demoIdentity"
}
output "workload_identity_arn" {
value = module.workload_identity.workload_identity_arn
description = "Workload Identity ARN"
}
1.3 IAMロール
Workload Identityは、IAMロールを必要としない独立したコンポーネントです。OAuth2ベースの認証を提供します。
2. デプロイ
2.1 Terraform初期化と適用
# Terraform初期化
terraform -chdir=envs/dev init
# 実行計画の確認
terraform -chdir=envs/dev plan -var="aws_profile=your-profile"
# デプロイ実行
terraform -chdir=envs/dev apply -var="aws_profile=your-profile"
実行結果:
workload_identity_arn = "arn:aws:bedrock-agentcore:us-west-2:xxxx:workload-identity-directory/default/workload-identity/demoIdentity"
2.2 デプロイ確認
AWS CLIで Workload Identity が正しく作成されたことを確認します。
# Workload Identity名を直接指定
AWS_PROFILE=your-profile AWS_REGION=us-west-2 \
aws bedrock-agentcore-control get-workload-identity \
--name demoIdentity \
--output json
期待される出力:
{
"name": "demoIdentity",
"workloadIdentityArn": "arn:aws:bedrock-agentcore:us-west-2:xxxx:workload-identity-directory/default/workload-identity/demoIdentity",
"status": "READY"
}
確認ポイント:
-
status:READYになっていること
3. 動作確認
boto3でget_workload_identity APIを呼び出し、作成したWorkload Identityの情報を取得します。ステータスがREADYであれば正常にデプロイされています。
3.1 テストスクリプト
"""Workload Identity 動作確認テスト"""
import os
import subprocess
import boto3
def terraform_output(name: str) -> str:
return subprocess.check_output(
["terraform", "-chdir=envs/dev", "output", "-raw", name], text=True
).strip()
def test_identity():
identity_arn = os.environ.get("WORKLOAD_IDENTITY_ARN", terraform_output("workload_identity_arn"))
identity_name = identity_arn.split("/")[-1]
region = os.getenv("AWS_REGION", "us-west-2")
print("=== Workload Identity Test ===")
print(f"Identity Name: {identity_name}")
print()
session = boto3.Session()
client = session.client("bedrock-agentcore-control", region_name=region)
# Identity情報を取得
print("--- Identity Info ---")
response = client.get_workload_identity(name=identity_name)
print(f"Name: {response['name']}")
print(f"Status: {response['status']}")
print(f"ARN: {response['workloadIdentityArn']}")
print()
print("Identity test completed!")
if __name__ == "__main__":
test_identity()
3.2 テスト実行
# 環境変数を設定して実行
AWS_PROFILE=your-profile AWS_REGION=us-west-2
uv run python tests/06_invoke_identity.py
実行結果:
=== Workload Identity Test ===
Identity Name: demoIdentity
--- Identity Info ---
Name: demoIdentity
Status: READY
ARN: arn:aws:bedrock-agentcore:us-west-2:xxxx:workload-identity-directory/default/workload-identity/demoIdentity
Identity test completed!
最後に
本ブログでは、Amazon Bedrock AgentCoreのWorkload IdentityコンポーネントをTerraformでデプロイする実装を解説しました。
次回予告
次回は、Observabilityの実装について解説します。
Discussion