クロスアカウントメモリアクセス

Amazon Bedrock AgentCore Memory はクロスアカウントアクセスをサポートしているため、メモリリソースと消費エージェントが複数のアカウントにまたがるマルチ AWS アカウントアーキテクチャを構築できます。クロスアカウントアクセスには、次の 2 つのシナリオがあります。

前提条件

クロスアカウントメモリアクセスを設定する前に、以下があることを確認します。

クロスアカウントデータプレーンアクセス

別のアカウントのプリンシパルに、メモリリソースに対してメモリデータプレーン APIsを直接呼び出すことを許可できます。これは、 PutResourcePolicy API を使用してリソースベースのポリシーをメモリにアタッチすることによって設定されます。リソースベースのポリシーの詳細については、「Amazon Bedrock AgentCore のリソースベースのポリシー」を参照してください。

仕組み

サポートされているアクション

任意のメモリデータプレーンアクションにクロスアカウントアクセスを付与できます。次の表に、使用可能なアクションを示します。

リソースベースのポリシーをメモリにアタッチする

別のアカウントに 1 つのアクションを付与する

次の例では、アカウント A (<account-B-id>) のメモリリソースBatchCreateMemoryRecordsで を呼び出すアクセス許可をアカウント B () に付与します<account-A-id>。

aws bedrock-agentcore-control put-resource-policy \
    --region us-east-1 \
    --resource-arn "arn:aws:bedrock-agentcore:us-east-1:<account-A-id>:memory/<memory-id>" \
    --policy '{
        "Version": "2012-10-17",
        "Statement": [
            {
                "Sid": "AllowCrossAccountBatchCreate",
                "Effect": "Allow",
                "Principal": {
                    "AWS": "arn:aws:iam::<account-B-id>:root"
                },
                "Action": "bedrock-agentcore:BatchCreateMemoryRecords",
                "Resource": "arn:aws:bedrock-agentcore:us-east-1:<account-A-id>:memory/<memory-id>"
            }
        ]
    }'

別のアカウントに複数のアクションを付与する

次の例では、メモリレコードとイベントへの完全な読み取りおよび書き込みアクセスをアカウント B に付与します。

aws bedrock-agentcore-control put-resource-policy \
    --region us-east-1 \
    --resource-arn "arn:aws:bedrock-agentcore:us-east-1:<account-A-id>:memory/<memory-id>" \
    --policy '{
        "Version": "2012-10-17",
        "Statement": [
            {
                "Sid": "AllowCrossAccountMemoryReadWrite",
                "Effect": "Allow",
                "Principal": {
                    "AWS": "arn:aws:iam::<account-B-id>:root"
                },
                "Action": [
                    "bedrock-agentcore:CreateEvent",
                    "bedrock-agentcore:GetEvent",
                    "bedrock-agentcore:ListEvents",
                    "bedrock-agentcore:ListActors",
                    "bedrock-agentcore:ListSessions",
                    "bedrock-agentcore:BatchCreateMemoryRecords",
                    "bedrock-agentcore:BatchUpdateMemoryRecords",
                    "bedrock-agentcore:BatchDeleteMemoryRecords",
                    "bedrock-agentcore:ListMemoryRecords",
                    "bedrock-agentcore:RetrieveMemoryRecords",
                    "bedrock-agentcore:GetMemoryRecord",
                    "bedrock-agentcore:DeleteMemoryRecord"
                ],
                "Resource": "arn:aws:bedrock-agentcore:us-east-1:<account-A-id>:memory/<memory-id>"
            }
        ]
    }'

特定の IAM ロールへのアクセスを許可する

最小特権の原則に従うには、アカウント全体ではなく、特定のロールへのアクセス権を付与します。

aws bedrock-agentcore-control put-resource-policy \
    --region us-east-1 \
    --resource-arn "arn:aws:bedrock-agentcore:us-east-1:<account-A-id>:memory/<memory-id>" \
    --policy '{
        "Version": "2012-10-17",
        "Statement": [
            {
                "Sid": "AllowSpecificRoleReadAccess",
                "Effect": "Allow",
                "Principal": {
                    "AWS": "arn:aws:iam::<account-B-id>:role/AgentMemoryReaderRole"
                },
                "Action": [
                    "bedrock-agentcore:RetrieveMemoryRecords",
                    "bedrock-agentcore:ListMemoryRecords",
                    "bedrock-agentcore:GetMemoryRecord"
                ],
                "Resource": "arn:aws:bedrock-agentcore:us-east-1:<account-A-id>:memory/<memory-id>"
            }
        ]
    }'

リソースベースのポリシーを削除する

クロスアカウントデータプレーンアクセスを取り消すには、リソースベースのポリシーを削除します。

aws bedrock-agentcore-control delete-resource-policy \
    --region us-east-1 \
    --resource-arn "arn:aws:bedrock-agentcore:us-east-1:<account-A-id>:memory/<memory-id>"

ポリシーを削除すると、それ以降のクロスアカウントリクエストは を返しますAccessDeniedException。

アカウント B からデータプレーン APIs呼び出す

リソースベースのポリシーがアタッチされると、アカウント B のプリンシパルは、フルメモリ ARN を として指定することで、データプレーン APIs を呼び出すことができますmemory-id。

アカウント B からメモリレコードを作成します。

aws bedrock-agentcore batch-create-memory-records \
    --region us-east-1 \
    --memory-id "arn:aws:bedrock-agentcore:us-east-1:<account-A-id>:memory/<memory-id>" \
    --records '[
      {
        "requestIdentifier": "rec-001",
        "content": {"text": "User prefers morning meeting times before 10 AM"},
        "namespaces": ["preferences/user-123"],
        "timestamp": "1729525989"
      }
    ]'

アカウント B からメモリレコードを取得します。

aws bedrock-agentcore retrieve-memory-records \
    --region us-east-1 \
    --memory-id "arn:aws:bedrock-agentcore:us-east-1:<account-A-id>:memory/<memory-id>" \
    --namespace "preferences/user-123" \
    --search-criteria '{"searchQuery": "meeting preferences"}' \
    --max-results 10

アカウント B からイベントを作成します。

aws bedrock-agentcore create-event \
    --region us-east-1 \
    --memory-id "arn:aws:bedrock-agentcore:us-east-1:<account-A-id>:memory/<memory-id>" \
    --actor-id "agent-in-account-b" \
    --session-id "cross-account-session-1" \
    --event-timestamp "$(date -u +"%Y-%m-%dT%H:%M:%S.%3NZ")" \
    --payload '[
      {
        "conversational": {
          "content": {"text": "Schedule my standup for 9 AM tomorrow"},
          "role": "USER"
        }
      }
    ]'

クロスアカウント配信先

カスタム (セルフマネージド) 戦略またはストリーム配信設定でメモリを作成すると、Amazon Bedrock AgentCore はメモリ実行ロールを使用してペイロードを送信先リソースに配信します。これらのリソースが別のアカウントに存在する場合は、両側を設定する必要があります。アカウント A の実行ロールにはリソースにアクセスするためのアクセス許可が必要であり、アカウント B のリソースにはアカウント A からのアクセスを許可するポリシーが必要です。

仕組み

メモリ実行ロールを設定する

アカウント A にメモリ実行ロールを作成します。このロールには、Amazon Bedrock AgentCore が引き受けることを許可する信頼ポリシーと、アカウント B のターゲットリソースへのアクセスを許可するアクセス許可ポリシーが必要です。

信頼ポリシー:

{
"Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "bedrock-agentcore.amazonaws.com"
      },
      "Action": "sts:AssumeRole",
      "Condition": {
        "ArnLike": {
          "aws:SourceArn": "arn:aws:bedrock-agentcore:<region>:<account-A-id>:memory/*"
        }
      }
    }
  ]
}

アクセス許可ポリシー (使用しているリソースに関連するステートメントのみを含む):

{
"Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowS3Access",
      "Effect": "Allow",
      "Action": [
        "s3:PutObject",
        "s3:GetObject"
      ],
      "Resource": "arn:aws:s3:::<bucket-name-in-account-B>/*"
    },
    {
      "Sid": "AllowSNSPublish",
      "Effect": "Allow",
      "Action": "sns:Publish",
      "Resource": "arn:aws:sns:<region>:<account-B-id>:<topic-name>"
    },
    {
      "Sid": "AllowKinesisAccess",
      "Effect": "Allow",
      "Action": [
        "kinesis:PutRecords",
        "kinesis:DescribeStream"
      ],
      "Resource": "arn:aws:kinesis:<region>:<account-B-id>:stream/<stream-name>"
    }
  ]
}

アカウント B で S3 バケットポリシーを設定する

アカウント B の S3 バケットに次のリソースベースのポリシーを追加して、アカウント A のメモリ実行ロールがペイロードを配信できるようにします。

{
"Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowMemoryExecutionRoleAccess",
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::<account-A-id>:role/<memory-execution-role-name>"
      },
      "Action": [
        "s3:PutObject",
        "s3:GetObject"
      ],
      "Resource": "arn:aws:s3:::<bucket-name>/*"
    }
  ]
}

アカウント B で SNS トピックポリシーを設定する

アカウント B の SNS トピックに次のリソースベースのポリシーを追加して、アカウント A のメモリ実行ロールが通知を発行できるようにします。

{
"Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowMemoryExecutionRolePublish",
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::<account-A-id>:role/<memory-execution-role-name>"
      },
      "Action": "sns:Publish",
      "Resource": "arn:aws:sns:<region>:<account-B-id>:<topic-name>"
    }
  ]
}

アカウント B で Kinesis Data Stream ポリシーを設定する

次のリソースベースのポリシーをアカウント B の Kinesis Data Stream に追加して、アカウント A のメモリ実行ロールがイベントをストリーミングできるようにします。

{
"Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowMemoryExecutionRolePutRecords",
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::<account-A-id>:role/<memory-execution-role-name>"
      },
      "Action": [
        "kinesis:PutRecords",
        "kinesis:DescribeStream"
      ],
      "Resource": "arn:aws:kinesis:<region>:<account-B-id>:stream/<stream-name>"
    }
  ]
}

クロスアカウント S3 および SNS でメモリを作成する

実行ロールとリソースポリシーを設定したら、アカウント B のクロスアカウントリソースを参照するメモリをアカウント A に作成します。

aws bedrock-agentcore-control create-memory \
    --region us-east-1 \
    --name "cross-account-memory" \
    --description "Memory with cross-account S3 and SNS delivery" \
    --event-expiry-duration 30 \
    --memory-execution-role-arn "arn:aws:iam::<account-A-id>:role/MemoryCrossAccountRole" \
    --memory-strategies '[
      {
        "customMemoryStrategy": {
          "name": "cross_account_strategy",
          "configuration": {
            "selfManagedConfiguration": {
              "triggerConditions": [
                {"messageBasedTrigger": {"messageCount": 5}}
              ],
              "invocationConfiguration": {
                "topicArn": "arn:aws:sns:us-east-1:<account-B-id>:memory-notifications",
                "payloadDeliveryBucketName": "<bucket-name>"
              },
              "historicalContextWindowSize": 10
            }
          }
        }
      }
    ]'

クロスアカウント Kinesis ストリーミングでメモリを作成する

aws bedrock-agentcore-control create-memory \
    --region us-east-1 \
    --name "cross-account-streaming-memory" \
    --description "Memory with cross-account Kinesis streaming" \
    --event-expiry-duration 30 \
    --memory-execution-role-arn "arn:aws:iam::<account-A-id>:role/MemoryCrossAccountRole" \
    --stream-delivery-resources '{
      "resources": [
        {
          "kinesis": {
            "dataStreamArn": "arn:aws:kinesis:us-east-1:<account-B-id>:stream/memory-record-stream",
            "contentConfigurations": [
              {
                "type": "MEMORY_RECORDS",
                "level": "FULL_CONTENT"
              }
            ]
          }
        }
      ]
    }'

ベストプラクティス