AWS WAF によるゲートウェイの保護

Amazon Bedrock AgentCore Gateway で AWS WAF を使用すると、ウェブエクスプロイト、ボットトラフィック、ボリューメトリック攻撃からゲートウェイを保護できます。 AWS WAF は、ターゲットに到達する前にすべてのインバウンドリクエストを評価するインラインセキュリティレイヤーを提供します。

AWS WAF ウェブアクセスコントロールリスト (ウェブ ACL) をゲートウェイに関連付けると、 AWS WAF はすべてのインバウンドリクエストを検査し、設定したルールを適用します。ブロックルールに一致するリクエストは、ターゲットに到達する前に拒否されます。ゲートウェイレベルでウェブ ACL をゲートウェイごとに 1 つのウェブ ACL に関連付けます。

AWS WAF とゲートウェイの連携方法

ウェブ ACL をゲートウェイに関連付けると、次のリクエストフローが発生します。

AWS WAF は、すべてのインバウンドリクエストをインラインで評価します。ウェブ ACL がゲートウェイに関連付けられていない場合、オーバーヘッドはゼロになり、 AWS WAF 評価は行われません。

前提条件

ウェブ ACL をゲートウェイに関連付ける前に、次の要件を満たしていることを確認してください。

ウェブ ACL とゲートウェイの関連付け

AWS WAF コンソールまたは CLI を使用して、ウェブ ACL AWS をゲートウェイに関連付けることができます。1 つのゲートウェイは、最大 1 つのウェブ ACL を持つことができます。ただし、1 つのウェブ ACL を複数のゲートウェイに関連付けることができます。ゲートウェイに関連付けられたウェブ ACL を変更するには、新しいウェブ ACL を関連付けます。新しい関連付けは、既存の関連付けを置き換えます。

CLI を使用してウェブ ACL AWS をゲートウェイに関連付けるには、次のコマンドを実行します。

aws wafv2 associate-web-acl \
    --web-acl-arn arn:aws:wafv2:us-east-1:123456789012:regional/webacl/my-web-acl/a1b2c3d4-5678-90ab-cdef-example11111 \
    --resource-arn arn:aws:bedrock-agentcore:us-east-1:123456789012:gateway/my-gateway-id

ARN 値をウェブ ACL ARN とゲートウェイ ARN に置き換えます。

ゲートウェイからウェブ ACL の関連付けを解除する

ゲートウェイから AWS WAF 保護を削除するには、ウェブ ACL の関連付けを解除します。ゲートウェイを削除する前に、ゲートウェイからウェブ ACL の関連付けを解除する必要があります。

CLI を使用してゲートウェイからウェブ ACL AWS の関連付けを解除するには、次のコマンドを実行します。

aws wafv2 disassociate-web-acl \
    --resource-arn arn:aws:bedrock-agentcore:us-east-1:123456789012:gateway/my-gateway-id

ARN 値をゲートウェイ ARN に置き換えます。

AWS WAF 失敗モードの設定

AWS WAF に到達できない場合、またはリクエストの評価中にタイムアウトした場合、ゲートウェイは設定された障害モードを使用してリクエストをブロックするか許可するかを決定します。

失敗モードを設定するには、 wafConfigurationパラメータで UpdateGateway API を使用します。

aws bedrock-agentcore-control update-gateway \
    --gateway-identifier my-gateway-id \
    --name my-gateway \
    --role-arn arn:aws:iam::123456789012:role/my-gateway-service-role \
    --authorizer-type CUSTOM_JWT \
    --authorizer-configuration '{
      "customJWTAuthorizer": {
        "discoveryUrl": "https://cognito-idp.us-east-1.amazonaws.com/my-user-pool/.well-known/openid-configuration",
        "allowedClients": ["clientId"]
      }
    }' \
    --waf-configuration '{"failureMode": "FAIL_OPEN"}'

AWS WAF レスポンスの処理

AWS WAF がリクエストをブロックする場合、エラーレスポンスはターゲットタイプによって異なります。

AWS WAF が FAIL_CLOSE でタイムアウトした場合、ゲートウェイはブロックされたリクエストと同じエラーを返します。 AWS WAF が 5xx エラーを返した場合、MCP ターゲットはコード -32603とメッセージ を含む JSON-RPC エラーを受け取ります"Internal error - Server error"。

AWS WAF アクティビティのモニタリング

Amazon CloudWatch メトリクスを使用して、ゲートウェイの AWS WAF アクティビティをモニタリングできます。

AWS/Bedrock-AgentCore 名前空間では、次のメトリクスを使用できます。

ブロックされたリクエストに関するルールレベルの詳細を取得するには、WAF AWS ログ記録を使用します。ゲートウェイログのリクエスト ID を AWS WAF ログに関連付けることができます。

クォータと制限事項

ゲートウェイとの AWS WAF 統合には、次のクォータと制限が適用されます。

ベストプラクティス

ゲートウェイで AWS WAF を使用する場合は、次のプラクティスをお勧めします。