翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

認証とセキュリティ

MCP エンドポイントと A2A エンドポイントの両方で 2 つの認証方法を使用できます。

アクセストークンを作成する

前提条件

アクセストークンを有効にする

トークンを作成する

トークンを作成すると、ウェブアプリケーションにクライアントに直接コピーできる設定例が表示されます。

SigV4 認証を使用する

SigV4 認証は、アクセストークンの代わりに AWS 認証情報を使用します。Kiro power および Claude Code プラグインには、ローカル AWS 認証情報を使用してリクエストに署名するmcp-proxy-for-aws、 を介した組み込み SigV4 サポートが含まれています。

SigV4 を使用する場合

前提条件

設定例

アクセストークンの代わりに SigV4 を使用するように MCP クライアントを設定するには、 を介してサーバーを実行しますmcp-proxy-for-aws。をエージェントスペースのリージョン ( などus-east-1) {region}に置き換えます。

{
  "mcpServers": {
    "aws-devops-agent": {
      "command": "uvx",
      "timeout": 120000,
      "args": [
        "mcp-proxy-for-aws@latest",
        "https://connect.aidevops.{region}.api.aws/mcp",
        "--service", "aidevops",
        "--region", "{region}"
      ]
    }
  }
}

プロキシはローカル AWS 認証情報を使用して各リクエストに署名するため、アクセストークンは必要ありません。

Multi-Agent-Spaceルーティング

SigV4 モードでは、各ツール呼び出しagent_space_idを渡して、使用するエージェントスペースを指定します。これにより、1 つのクライアントから複数のエージェントスペースにルーティングできます。

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

トークンスコープ

IP 許可リスト

アクセストークンを作成するときは、オプションで IP 許可リストを指定できます。設定すると、トークンは指定された IP アドレスまたは CIDR 範囲からのみ使用できます。他の IPsは、アクセス拒否エラーで拒否されます。

トークンのローテーションと取り消し

チャット履歴とトークンのローテーション

各トークンには独自のチャット履歴があります。トークンをローテーションすると、 AWS DevOps Agent は新しいトークン値を新しい ID として扱います。前のトークンで作成したチャットは、リモートサーバーに表示されなくなります。

侵害されたトークンへの対応

トークンが侵害された疑いがある場合は、次の手順に従います。

プログラムによるトークンの取り消し

を使用してプログラムでトークンを取り消すこともできますawscurl。次のコマンドは SigV4 認証を使用します。リージョン (us-east-1) を、エージェントスペースが作成されたリージョンに置き換えます。

ステップ 1: エージェントスペースを一覧表示する

aws aidevops list-agent-spaces --region us-east-1

ステップ 2: エージェントスペースのアクセストークンを一覧表示する

awscurl --service aidevops --region us-east-1 \
  -H "Accept: application/json" \
  "https://cp.aidevops.us-east-1.api.aws/v1/agentspaces/{agentSpaceId}/access-tokens"

ステップ 3: トークンを取り消す

awscurl --service aidevops --region us-east-1 -X POST \
  -H "Accept: application/json" \
  "https://cp.aidevops.us-east-1.api.aws/v1/agentspaces/{agentSpaceId}/access-tokens/{accessTokenId}/revoke"

{agentSpaceId} と を前のレスポンスの値{accessTokenId}に置き換えます。

トレーサビリティ

AWS DevOps Agent は AWS CloudTrail にリモートサーバーアクティビティを記録します。これらのレコードを使用して、リモートサーバーを呼び出したユーザーと、その結果エージェントが何をしたかをトレースします。 AWS DevOps エージェントは、エージェントスペースをホストする AWS アカウントに CloudTrail イベントを配信します。

アクセストークン認証イベント

AWS DevOps エージェントが MCP または A2A エンドポイントのアクセストークンを認証するたびに、CloudTrail にAuthenticateAccessTokenイベントを発行します。 AWS DevOps エージェントは、成功した認証と失敗した認証の両方を記録します。これらのレコードを使用して、正当な使用を監査し、拒否された試行を検出します。例としては、期限切れまたは取り消されたトークン、IP 許可リストによってブロックされたリクエストなどがあります。

イベントには次の特性があります。

イベントには、次のキーフィールドが含まれます。

ダウンストリームアクションイベント

アクセストークンを使用すると、 AWS DevOps Agent はユーザーに代わってアクションを実行するロールを引き受けます。 AWS DevOps Agent は、トークンと発信者を識別するセッションタグを使用して CloudTrail でこのAssumeRole呼び出しを記録します。

エージェントがユーザーに代わって実行する各アクションには、CloudTrail がログに記録する対応するダウンストリーム AWS API コールがあります。ロールセッション名は 形式を使用しますtoken_{spaceId}_{timestamp}_{tokenName}。このセッション名は、AuthenticateAccessTokenイベントの と一致しroleSessionNameます。これを使用して、認証からそれに従った特定のアクションをトレースします。

SigV4 呼び出し

アクセストークンの代わりに AWS SigV4 認証を使用する呼び出しでは、AuthenticateAccessTokenイベントは生成されません。 AWS DevOps Agent は、SigV4 リクエストを AWS Identity and Access Management (IAM) ID に属性付けします。エージェントがトリガーするダウンストリーム AWS API コールを通じて実行するアクションを追跡できます。

VPC エンドポイントポリシーの制限

リモートサーバーエンドポイントは VPC エンドポイントポリシーをサポートしていません。アクセストークンまたは SigV4 認証のいずれかを使用した呼び出しは、VPC エンドポイントポリシーでは制限できません。

アクセストークンの無効化

アクセストークン機能はデフォルトでオフになっています。有効にした後で無効にするには:

を無効にすると、すべてのトークンベースのアクセスがすぐにブロックされます。既存のトークンは削除されませんが、機能を再度有効にするまで使用できません。

組織内のユーザーがアクセストークンを有効にできないようにするには、アクセストークン API アクションと UpdateAgentSpaceアクション (アクセストークンの切り替えを制御する) を拒否するサービスコントロールポリシー (SCP) を作成します。

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "DenyAccessTokenOperations",
      "Effect": "Deny",
      "Action": [
        "aidevops:UpdateAgentSpace",
        "aidevops:CreateAccessToken",
        "aidevops:GetAccessToken",
        "aidevops:ListAccessTokens",
        "aidevops:RotateAccessToken",
        "aidevops:RevokeAccessToken"
      ],
      "Resource": "*"
    }
  ]
}

トラブルシューティング