{
  "format": "agent-article-v0",
  "article_id": "EA-260",
  "canonical_url": "/tools/ea-260-api-management-agent-tool",
  "page_type": "reference",
  "claim_ids": [],
  "evidence_ids": [
    "EA-260-CURRENT-APPROVAL",
    "EA-260-CURRENT-BODY-READBACK"
  ],
  "unknown_ids": [
    "EA-260-UNKNOWN-01"
  ],
  "operational_object_ids": [],
  "provider": [],
  "models": [],
  "plans": [],
  "surfaces": [],
  "regions": [],
  "current_status": "CURRENT",
  "observation_status": "SPEC_ONLY",
  "freshness": "CURRENT",
  "last_verified": "2026-10-06",
  "supersedes": [],
  "superseded_by": [],
  "provenance": [
    "V23-CANDIDATE-EA260-FIRST-20261015-C3",
    "BODY-SHA256:fd8b74761787c485af5edc9441aa1bed6b7e8bfa731779da9ed9826bbe223490"
  ],
  "article_sources": [
    {
      "id": "EA-260-CURRENT-APPROVAL",
      "evidence_class": "RESEARCH",
      "title": "現行本文の監査・revision対応",
      "supports": [
        "現行台帳のAUDIT_PASSと候補・revision・本文ハッシュの対応を確認しています。"
      ],
      "limit": "監査状態と来歴の記録です。外部根拠の最新性や本文の全主張を追加保証しません。",
      "origin_class": "AUDITED_CANONICAL_RESEARCH_PACKET",
      "source_or_experiment_ids": [
        "V23-CANDIDATE-EA260-FIRST-20261015-C3"
      ],
      "supporting_locators": [
        "1KqhJtiSb2S84rWmeYVwKcT_76dBwZ_B0ZZuAWQqH0rQ/EA_REVISION_LEDGER!A61:U61",
        "EA_REVISION_LEDGER!A61:U61",
        "EA-260-FIRST-20261006"
      ],
      "provenance_status": "CURRENT_CANONICAL_APPROVAL_READBACK"
    },
    {
      "id": "EA-260-CURRENT-BODY-READBACK",
      "evidence_class": "IMPL",
      "title": "現行本文の収録照合",
      "supports": [
        "公開生成入力の本文SHA-256が、監査済み候補に結び付いたハッシュと一致しています。"
      ],
      "limit": "本文の同一性の検査です。外部システムの挙動や全主張の真偽を実証したものではありません。",
      "checked_at": "2026-10-17",
      "origin_class": "IMPLEMENTATION_READBACK",
      "source_or_experiment_ids": [
        "BODY-SHA256:fd8b74761787c485af5edc9441aa1bed6b7e8bfa731779da9ed9826bbe223490"
      ],
      "supporting_locators": [
        "content/staging/EA-260.md",
        "fd8b74761787c485af5edc9441aa1bed6b7e8bfa731779da9ed9826bbe223490",
        "EA-260-FIRST-20261006"
      ],
      "provenance_status": "CURRENT_APPROVED_BODY_HASH_MATCH"
    }
  ],
  "research_sections": [
    {
      "heading": "PUBLIC_CLAIM",
      "text": "Agentからtool APIへ到達する経路にAPI Management/API Gatewayを置くと、認証、公開route/tool、rate/quota、protocol/schema、監査を集中しやすくなります。\n\n\nただしgatewayを通過したことだけを、tool actionの安全性、backend authorization、hard cost capの証明にはしません。"
    },
    {
      "heading": "AUTHENTICATION_AND_AUTHORIZATION",
      "text": "gatewayでcaller/workload identityを検証し、backendでも実行可能なaction/resourceを最小権限にします。\n\n\nAPI keyは必ずしもauthentication/authorization credentialではありません。project identificationやusage-plan用途とauthorizationを分離します。\n\n\ngateway authenticationとbackend/tool authorizationの双方を通過しなければside effectを許可しない構成を採ります。"
    },
    {
      "heading": "TOOL_AND_ROUTE_ALLOWLIST",
      "text": "Agentへ公開するroute/toolをinventoryし、必要なoperationだけを明示的に公開します。\n\n\nwildcard route、汎用proxy、過剰なMCP tool exposureを避け、tool追加・schema変更をpolicy changeとして扱います。\n\n\nschema-valid requestであってもbusiness-safe actionとは限らないため、resource/action authorizationとapproval gateを別途維持します。"
    },
    {
      "heading": "RATE_QUOTA_AND_COST",
      "text": "rate limit、burst、quota、concurrencyをretry amplificationとnoisy-neighbor対策に使用します。\n\n\nただしproviderのquota/throttlingがbest effortの場合、hard cost capとして扱いません。AWS API Gatewayはusage-plan quota/throttlingをhard limitやcost-controlとして依存しないよう明記しています。\n\n\nbudget alert、provider spending control、backend quota等は別controlとして確認します。"
    },
    {
      "heading": "MCP_BOUNDARY",
      "text": "MCP trafficはgateway製品ごとの対応範囲を固定します。\n\n\nAzure API ManagementはMCP toolsを管理できますが、現行documented scopeではMCP resources/promptsをサポートしません。\n\n\nKong AI GatewayではMCP trafficにAPI-level authentication、rate limiting、logging等を適用できますが、LLM prompt/response向けAI policyはMCP trafficへ同じようには適用されません。\n\n\n「AI gateway対応」を全MCP primitive・全policyへの対応と読み替えません。"
    },
    {
      "heading": "PROTOCOL_AND_STREAMING",
      "text": "HTTP request-responseだけでなく、SSE、WebSocket、gRPC、MCP revision、長時間connectionを個別に確認します。\n\n\npayload/header size、timeout、connection lifetime、retry、transcodingの制約はprotocolごとに異なり得ます。\n\n\nrequest count中心のrate policyが長時間streaming connectionを同じ粒度で制御するとは仮定しません。"
    },
    {
      "heading": "BYPASS_CONTROL",
      "text": "backendへgatewayを経由しないdirect public/private pathが残る場合、gatewayは完全なenforcement pointではありません。\n\n\nDNS、private endpoint、service mesh、security group/firewall等を含め、Agent runtimeからbackend direct accessをnegative-testします。\n\n\nbreak-glass bypassを設ける場合はowner、理由、expiry、監査を必須にします。"
    },
    {
      "heading": "CONFIG_AND_SCHEMA_LIFECYCLE",
      "text": "OpenAPI/gRPC/MCP tool definitionとgateway policyをversion管理し、active config間の互換性を確認します。\n\n\nquota metric、route、auth、backend mappingの変更はavailability/security双方のchangeとして扱います。\n\n\nconfig deploy成功だけでなく、realized route/auth/quota stateをreadbackします。"
    },
    {
      "heading": "OBSERVABILITY",
      "text": "少なくともcaller identity、tool/route、status、latency、auth decision、rate/quota decision、backend errorを観測します。\n\n\nAuthorization header、API key、token、prompt、tool arguments、PIIはログからredactします。\n\n\ndirect-backend access、401/403/429増加、wildcard route追加、policy driftを監視します。"
    },
    {
      "heading": "VERIFICATION",
      "text": "Agent runtimeから次を検証します。\n- 許可されたtool/routeへのpositive test\n- 未許可tool/routeへのnegative test\n- direct backend pathへのnegative test\n- expired/revoked identity\n- rate/burst/quota超過\n- backend action authorization denial\n- schema-invalid request\n- oversized request/header\n- streaming/WebSocket/gRPC/MCP経路\n- policy/config readback\n- failover regionでのpolicy一致\n\n\n許可経路の成功だけでgateway controlを検証完了としません。"
    },
    {
      "heading": "FAILURE_ENVELOPE",
      "text": "direct bypass、wildcard exposure、stale JWT/JWKS、API keyとauthの混同、best-effort quota overshoot、retry storm、streaming/WebSocket差異、gRPC transcoding mismatch、MCP revision mismatch、resources/prompts非対応、LLM policyのMCP非適用、schema drift、config rollout incompatibility、backend credential overreach、auth-context mapping error、secret-bearing logs、gateway outage、multi-region drift、break-glass残置を想定します。"
    },
    {
      "heading": "IMPLEMENTATION_STATE",
      "text": "本項は2026-10-06時点のAzure API Management MCP/AI gateway、AWS API Gateway、Google Cloud API Gateway、Kong AI Gateway公開資料に基づきます。organization gateway、Agent runtime、MCP server、backend APIへのlive mutation/testは未実施です。"
    },
    {
      "heading": "SAFE_WORDING",
      "text": "API ManagementをAgent Tool層の制御点に置く場合、認証、公開tool/route、rate/quota、protocol/schema、監査をgatewayで集中できます。ただしAPI keyやquotaをauthorization・hard cost capとみなさず、backend側の最小権限とdirect-path遮断を別途確認します。MCP/streaming等はgateway製品・versionごとの対応範囲を固定し、許可経路の成功と未許可経路の拒否をAgent runtimeからreadbackします。"
    },
    {
      "heading": "OPEN_UNKNOWN",
      "text": "organization gateway/provider/tier、actual Agent tools/MCP revision、direct backend paths、backend IAM/OAuth、hard-budget mechanism、quota scope、streaming/WebSocket/gRPC、schema lifecycle、multi-region failover、JWKS/revocation SLO、logging/redaction、pricing、tenant-specific policy behaviorは未確認です。"
    }
  ],
  "human_url": "/tools/ea-260-api-management-agent-tool",
  "markdown_url": "/agent/article.md?path=%2Ftools%2Fea-260-api-management-agent-tool",
  "json_url": "/agent/article.json?path=%2Ftools%2Fea-260-api-management-agent-tool"
}