✅

Terraformで始めるAmazon Bedrock AgentCore ⑥〜Identity編〜

に公開
2026/01/06

はじめに

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モジュール

modules/bedrock-agentcore-identity/main.tf
resource "aws_bedrockagentcore_workload_identity" "this" {
  name = var.name
}
modules/bedrock-agentcore-identity/variables.tf
variable "name" {
  description = "Workload Identity名"
  type        = string
}
modules/bedrock-agentcore-identity/outputs.tf
output "workload_identity_arn" {
  value = aws_bedrockagentcore_workload_identity.this.workload_identity_arn
}

1.2 環境設定

envs/dev/main.tf
# Workload Identity Module
module "workload_identity" {
  source = "../../modules/bedrock-agentcore-identity"

  name = var.workload_identity_name
}

ポイント:

  • スタンドアロンで作成、他モジュールへの依存なし
envs/dev/variables.tf
# Workload Identity Configuration
variable "workload_identity_name" {
  description = "Name of the Workload Identity."
  type        = string
  default     = "demoIdentity"
}
envs/dev/outputs.tf
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 テストスクリプト

tests/06_invoke_identity.py
"""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の実装について解説します。
https://zenn.dev/fusic/articles/eac2ec70c0941f

Fusic 技術ブログ

Discussion