Amazon Bedrock AgentCore のサービスにリンクされたロールの使用

Amazon Bedrock AgentCore は、 AWS Identity and Access Management (IAM) サービスにリンクされたロールを使用します。サービスにリンクされたロールは、AgentCore に直接リンクされた一意のタイプの IAM ロールです。サービスにリンクされたロールは AgentCore によって事前定義されており、サービスがユーザーに代わって他の AWS サービスを呼び出すために必要なすべてのアクセス許可が含まれています。

サービスにリンクされたロールを使用すると、必要なアクセス許可を手動で追加する必要がなくなるため、AgentCore の使用が簡単になります。AgentCore は、サービスにリンクされたロールのアクセス許可を定義します。特に定義されている場合を除き、AgentCore のみがそのロールを引き受けることができます。定義されたアクセス許可には、信頼ポリシーとアクセス許可ポリシーが含まれ、そのアクセス許可ポリシーを他の IAM エンティティにアタッチすることはできません。

ロールを削除するには、まず関連リソースを削除します。これにより、リソースへのアクセス許可が誤って削除されないため、AgentCore リソースが保護されます。

AgentCore は、次のサービスにリンクされたロールを使用します。

AgentCore サービスにリンクされたロールのアクセス許可

ネットワークサービスにリンクされたロール

AgentCore は、 という名前のサービスにリンクされたロールAWSServiceRoleForBedrockAgentCoreNetworkを使用して、ユーザーに代わって AgentCore が VPC でネットワークインターフェイスを作成および管理できるようにします。

AWSServiceRoleForBedrockAgentCoreNetwork サービスリンクロールは、以下のサービスを信頼してロールを引き受けます。

ロールのアクセス許可ポリシーにより、AgentCore は指定されたリソースに対して次のアクションを実行できます。

BedrockAgentCoreNetworkServiceRolePolicy でポリシー全体を表示できます。

{
"Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "AllowCreateEniInAnySubnet",
            "Effect": "Allow",
            "Action": "ec2:CreateNetworkInterface",
            "Resource": "arn:aws:ec2:*:*:subnet/*"
        },
        {
            "Sid": "AllowCreateEniWithSecurityGroups",
            "Effect": "Allow",
            "Action": "ec2:CreateNetworkInterface",
            "Resource": "arn:aws:ec2:*:*:security-group/*"
        },
        {
            "Sid": "AllowCreateEniWithBedrockManagedRequestTag",
            "Effect": "Allow",
            "Action": "ec2:CreateNetworkInterface",
            "Resource": "arn:aws:ec2:*:*:network-interface/*",
            "Condition": {
                "ForAllValues:StringEquals": {
                    "aws:TagKeys": [
                        "AmazonBedrockAgentCoreManaged"
                    ]
                },
                "StringEquals": {
                    "aws:RequestTag/AmazonBedrockAgentCoreManaged": "true"
                }
            }
        },
        {
            "Sid": "AllowTagEniOnCreate",
            "Effect": "Allow",
            "Action": "ec2:CreateTags",
            "Resource": "arn:aws:ec2:*:*:network-interface/*",
            "Condition": {
                "StringEquals": {
                    "ec2:CreateAction": "CreateNetworkInterface"
                }
            }
        },
        {
            "Sid": "AllowManageEniWhenBedrockManaged",
            "Effect": "Allow",
            "Action": [
                "ec2:DeleteNetworkInterface",
                "ec2:AssignPrivateIpAddresses",
                "ec2:UnassignPrivateIpAddresses",
                "ec2:CreateNetworkInterfacePermission"
            ],
            "Resource": "arn:aws:ec2:*:*:network-interface/*",
            "Condition": {
                "StringEquals": {
                    "aws:ResourceTag/AmazonBedrockAgentCoreManaged": "true"
                }
            }
        },
        {
            "Sid": "AllowGetSecurityGroupsForVpc",
            "Effect": "Allow",
            "Action": [
                "ec2:GetSecurityGroupsForVPC"
            ],
            "Resource": "arn:aws:ec2:*:*:vpc/*"
        },
        {
            "Sid": "AllowDescribeNetworkingResources",
            "Effect": "Allow",
            "Action": [
                "ec2:DescribeNetworkInterfaces",
                "ec2:DescribeSecurityGroups",
                "ec2:DescribeSubnets",
                "ec2:DescribeVpcs"
            ],
            "Resource": "*"
        }
    ]
}

ID サービスにリンクされたロール

AgentCore は、 という名前のサービスにリンクされたロールAWSServiceRoleForBedrockAgentCoreRuntimeIdentityを使用して、ユーザーに代わって AgentCore がワークロード ID アクセストークンと OAuth 認証情報を管理できるようにします。

AWSServiceRoleForBedrockAgentCoreRuntimeIdentity サービスリンクロールは、以下のサービスを信頼してロールを引き受けます。

ロールのアクセス許可ポリシーにより、AgentCore は指定されたリソースに対してこれらのアクションを実行できます。

BedrockAgentCoreRuntimeIdentityServiceRolePolicy でポリシー全体を表示できます。

{
"Version": "2012-10-17",
    "Statement": {
        "Sid": "AllowWorkloadIdentityAccess",
        "Effect": "Allow",
        "Action": [
            "bedrock-agentcore:GetWorkloadAccessToken",
            "bedrock-agentcore:GetWorkloadAccessTokenForJWT",
            "bedrock-agentcore:GetWorkloadAccessTokenForUserId"
        ],
        "Resource": [
            "arn:aws:bedrock-agentcore:*:*:workload-identity-directory/default",
            "arn:aws:bedrock-agentcore:*:*:workload-identity-directory/default/workload-identity/*"
        ]
    }
}

このポリシーの変更については、AgentCore updates to AWS managed policies」を参照してください。

ID 機能について

サービスにリンクされたロールは、AgentCore ランタイムリソースの OAuth 認証と JWT ベアラートークン機能をサポートするために使用されます。この機能を使用すると、エージェントのランタイムはワークロード ID を安全に管理し、ユーザーに代わって外部 OAuth プロバイダーにアクセスできます。

ID 管理の主な利点

ID 管理の仕組み

OAuth 認証または JWT ベアラートークンを使用して AgentCore ランタイムを呼び出す場合:

レガシーアプローチからの移行

サービスにリンクされたロールにより、AgentCore はエージェントのランタイムに明示的に関連付けられているワークロード ID リソースにのみアクセスでき、安全な分離と明確なリソース属性を維持できます。

実装の詳細については、「インバウンド認証とアウトバウンド認証による認証と認可」を参照してください。

ゲートウェイサービスにリンクされたロール

AgentCore は、 という名前のサービスにリンクされたロールAWSServiceRoleForBedrockAgentCoreGatewayNetworkを使用して、AgentCore Gateway がユーザーに代わってアカウントで Amazon VPC Lattice リソースを作成および管理できるようにします。このロールは、マネージドプライベートエンドポイントを使用してゲートウェイターゲットを設定するときに使用され、AgentCore Gateway が VPC 内のリソースへのプライベート接続に必要な VPC Lattice リソースゲートウェイをセットアップできるようにします。

AWSServiceRoleForBedrockAgentCoreGatewayNetwork サービスリンクロールは、以下のサービスを信頼してロールを引き受けます。

ロールのアクセス許可ポリシーにより、AgentCore は指定されたリソースに対して次のアクションを実行できます。

BedrockAgentCoreGatewayNetworkServiceRolePolicy でポリシー全体を表示できます。

{
"Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "AllowSLRActionsForLattice",
            "Effect": "Allow",
            "Action": [
                "iam:CreateServiceLinkedRole"
            ],
            "Resource": [
                "arn:aws:iam::*:role/aws-service-role/vpc-lattice.amazonaws.com/AWSServiceRoleForVpcLattice"
            ],
            "Condition": {
                "StringEquals": {
                    "iam:AWSServiceName": "vpc-lattice.amazonaws.com"
                }
            }
        },
        {
            "Sid": "AllowResourceGatewayCreate",
            "Effect": "Allow",
            "Action": [
                "vpc-lattice:CreateResourceGateway",
                "vpc-lattice:TagResource"
            ],
            "Resource": [
                "arn:aws:vpc-lattice:*:*:resourcegateway/*"
            ],
            "Condition": {
                "StringEquals": {
                    "aws:RequestTag/BedrockAgentCoreGatewayManaged": "true",
                    "aws:ResourceTag/BedrockAgentCoreGatewayManaged": "true"
                }
            }
        },
        {
            "Sid": "AllowEC2PermissionsForResourceGatewayCreate",
            "Effect": "Allow",
            "Action": [
                "ec2:DescribeSubnets",
                "ec2:DescribeVpcs",
                "ec2:DescribeSecurityGroups"
            ],
            "Resource": [
                "*"
            ]
        },
        {
            "Sid": "AllowResourceGatewayDelete",
            "Effect": "Allow",
            "Action": [
                "vpc-lattice:DeleteResourceGateway",
                "vpc-lattice:GetResourceGateway"
            ],
            "Resource": [
                "*"
            ],
            "Condition": {
                "StringEquals": {
                    "aws:ResourceTag/BedrockAgentCoreGatewayManaged": "true"
                }
            }
        }
    ]
}

Gateway Managed Lattice 機能について

サービスにリンクされたロールは、AgentCore Gateway ターゲットのマネージドプライベートエンドポイント機能をサポートするために使用されます。マネージドプライベートエンドポイントを使用してゲートウェイターゲットを作成すると、AgentCore はこのロールを使用して、ユーザーに代わってアカウントで VPC Lattice リソースゲートウェイを作成および管理します。これらのマネージドリソースゲートウェイは、VPC Lattice リソースを手動で設定することなく、AgentCore Gateway と VPC 内のリソース間のプライベート接続を可能にします。

マネージド Lattice リソースの主な利点

マネージド Lattice リソースの仕組み

マネージドプライベートエンドポイントを使用してゲートウェイターゲットを作成する場合:

Identity Network サービスにリンクされたロール

AgentCore は、 という名前のサービスにリンクされたロールAWSServiceRoleForBedrockAgentCoreIdentityを使用して、AgentCore Identity がユーザーに代わってアカウントで Amazon VPC Lattice リソースを作成および管理できるようにします。このロールは、プライベート ID プロバイダーのプライベートエンドポイントを設定するときに使用され、AgentCore Identity が VPC 内の ID プロバイダーへのプライベート接続に必要な VPC Lattice リソースゲートウェイをセットアップできるようにします。

AWSServiceRoleForBedrockAgentCoreIdentity サービスリンクロールは、以下のサービスを信頼してロールを引き受けます。

ロールのアクセス許可ポリシーにより、AgentCore は指定されたリソースに対して次のアクションを実行できます。

完全なポリシーは、AWSBedrockAgentCoreIdentityNetworkServiceRolePolicy で確認できます。

{
  "Version" : "2012-10-17",
  "Statement" : [
    {
      "Sid" : "AllowSLRActionsForLattice",
      "Effect" : "Allow",
      "Action" : [
        "iam:CreateServiceLinkedRole"
      ],
      "Resource" : [
        "arn:aws:iam::*:role/aws-service-role/vpc-lattice.amazonaws.com/AWSServiceRoleForVpcLattice"
      ],
      "Condition" : {
        "StringEquals" : {
          "iam:AWSServiceName" : "vpc-lattice.amazonaws.com"
        }
      }
    },
    {
      "Sid" : "AllowResourceGatewayCreate",
      "Effect" : "Allow",
      "Action" : [
        "vpc-lattice:CreateResourceGateway",
        "vpc-lattice:TagResource"
      ],
      "Resource" : [
        "arn:aws:vpc-lattice:*:*:resourcegateway/*"
      ],
      "Condition" : {
        "StringEquals" : {
          "aws:RequestTag/BedrockAgentCoreIdentityManaged" : "true",
          "aws:ResourceTag/BedrockAgentCoreIdentityManaged" : "true"
        }
      }
    },
    {
      "Sid" : "AllowEC2PermissionsForResourceGatewayCreate",
      "Effect" : "Allow",
      "Action" : [
        "ec2:DescribeSubnets",
        "ec2:DescribeVpcs",
        "ec2:DescribeSecurityGroups"
      ],
      "Resource" : [
        "*"
      ]
    },
    {
      "Sid" : "AllowResourceGatewayDelete",
      "Effect" : "Allow",
      "Action" : [
        "vpc-lattice:DeleteResourceGateway",
        "vpc-lattice:GetResourceGateway"
      ],
      "Resource" : [
        "*"
      ],
      "Condition" : {
        "StringEquals" : {
          "aws:ResourceTag/BedrockAgentCoreIdentityManaged" : "true"
        }
      }
    }
  ]
}

ID ネットワーク機能について

サービスにリンクされたロールは、AgentCore Identity のマネージドプライベートエンドポイント機能をサポートするために使用されます。プライベート ID プロバイダーのプライベートエンドポイントを設定すると、AgentCore はこのロールを使用して、ユーザーに代わってアカウントで VPC Lattice リソースゲートウェイを作成および管理します。これらのマネージドリソースゲートウェイは、セルフホスト型 Keycloak、PingFederate、またはその他の OIDC 準拠の認可サーバーなど、VPC 内の AgentCore Identity と ID プロバイダー間のプライベート接続を可能にします。VPC Lattice リソースを手動で設定する必要はありません。

マネージド Lattice リソースが ID に対してどのように機能するか

プライベート ID プロバイダーのプライベートエンドポイントを設定する場合:

プライベート ID プロバイダーの設定の詳細については、「VPC のプライベート ID プロバイダーに接続する」を参照してください。

AgentCore のサービスにリンクされたロールの作成

サービスにリンクされたロールを手動で作成する必要はありません。AgentCore は、必要に応じてそれらを自動的に作成します。

サービスにリンクされたロールを削除し、再度作成する必要がある場合は、同じプロセスを使用してアカウントでロールを再作成できます。適切な AgentCore リソースを作成すると、AgentCore はサービスにリンクされたロールを再度作成します。

サービスリンクロールの作成に必要な許可

サービスリンクロールの作成、編集、削除を IAM エンティティ (ユーザー、グループ、ロールなど) に許可するにはアクセス許可を設定する必要があります。IAM エンティティには、次のアクセス許可が必要です。

ネットワークサービスにリンクされたロールの場合

{
    "Action": "iam:CreateServiceLinkedRole",
    "Effect": "Allow",
    "Resource": "arn:aws:iam::*:role/aws-service-role/network.bedrock-agentcore.amazonaws.com/AWSServiceRoleForBedrockAgentCoreNetwork",
    "Condition": {
        "StringLike": {
            "iam:AWSServiceName": "network.bedrock-agentcore.amazonaws.com"
        }
    }
}

ID サービスにリンクされたロールの場合

{
    "Sid": "CreateBedrockAgentCoreRuntimeIdentityServiceLinkedRolePermissions",
    "Effect": "Allow",
    "Action": "iam:CreateServiceLinkedRole",
    "Resource": "arn:aws:iam::*:role/aws-service-role/runtime-identity.bedrock-agentcore.amazonaws.com/AWSServiceRoleForBedrockAgentCoreRuntimeIdentity",
    "Condition": {
        "StringEquals": {
            "iam:AWSServiceName": "runtime-identity.bedrock-agentcore.amazonaws.com"
        }
    }
}

Gateway サービスにリンクされたロールの場合

{
    "Effect": "Allow",
    "Action": "iam:CreateServiceLinkedRole",
    "Resource": "arn:aws:iam::*:role/aws-service-role/bedrock-agentcore.amazonaws.com/AWSServiceRoleForBedrockAgentCoreGatewayNetwork",
    "Condition": {
        "StringEquals": {
            "iam:AWSServiceName": "bedrock-agentcore.amazonaws.com"
        }
    }
}

Identity Network サービスにリンクされたロールの場合

{
    "Effect": "Allow",
    "Action": "iam:CreateServiceLinkedRole",
    "Resource": "arn:aws:iam::*:role/aws-service-role/identity-network.bedrock-agentcore.amazonaws.com/AWSServiceRoleForBedrockAgentCoreIdentity",
    "Condition": {
        "StringEquals": {
            "iam:AWSServiceName": "identity-network.bedrock-agentcore.amazonaws.com"
        }
    }
}

これらのアクセス許可は、 AWS 管理ポリシー BedrockAgentCoreFullAccess にすでに含まれています。

AgentCore のサービスにリンクされたロールの編集

AgentCore では、AWSServiceRoleForBedrockAgentCoreNetwork、、AWSServiceRoleForBedrockAgentCoreRuntimeIdentityAWSServiceRoleForBedrockAgentCoreGatewayNetwork、またはAWSServiceRoleForBedrockAgentCoreIdentityサービスにリンクされたロールを編集することはできません。サービスリンクロールの作成後は、さまざまなエンティティがロールを参照する可能性があるため、ロール名を変更することはできません。ただし、IAM を使用してロールの説明を編集することはできます。詳細については、「サービスにリンクされたロールの編集」を参照してください。

AgentCore のサービスにリンクされたロールの削除

サービスリンクロールを必要とする機能やサービスが不要になった場合は、ロールを削除することをお勧めします。そうすることで、モニタリングや保守が積極的に行われていない未使用のエンティティを排除できます。ただし、ロールを削除する前に、サービスにリンクされたロールを使用するすべての AgentCore リソースを削除する必要があります。

サービスにリンクされたロールのクリーンアップ

IAM を使用してサービスにリンクされたロールを削除するには、まずそのロールにアクティブなセッションがないことを確認し、そのロールで使用されているリソースをすべて削除する必要があります。

サービスにリンクされたロールに IAM コンソールでアクティブなセッションがあるかどうかを確認するには

サービスにリンクされたロールを削除する場合は、まず適切な AgentCore リソースを削除する必要があります。

サービスリンク役割の手動による削除

IAM コンソール、 CLI、または IAM API AWS を使用して、サービスにリンクされたロールを削除します。詳細については、「サービスにリンクされたロールの削除」を参照してください。