<ph type="x-smartling-placeholder"></ph>
現在、Apigee Edge のドキュメントが表示されています。
Apigee X のドキュメント。 詳細
不要な可能性のある API リクエストのリストで通知するように Apigee Sense を構成できます。通知を設定すると、Apigee Sense は指定した WebHook URI に 5 分ごとにレポートを送信します。
Webhook URI を使用して、Apigee Sense は JSON 形式の文字列を送信します（文字列を JSON に解析するコードが必要です）。次の簡単なレポートの例は、読みやすくするために文字列から JSON にフォーマットされています。
{
"text": {
"metadata": {
"org": "my-org",
"env": "prod",
"reportTimestamp": "2018-10-09T17:25:12Z",
"messageId": "1539105912220"
},
"totalNumberOfBots": 1,
"bots": [
{
"ipAddress": "11.111.111.11",
"botDetectedLast": "2018-10-0917:04:48Z",
"ipIsp": "Their ISP",
"ipCountry": "United States",
"botReason": [
"Flooder",
"Content Robber"
],
"callCount": "274529",
"topUrl": "/v1/my/url",
"ipCity": "Los Angeles"
}
]
}
}
このレポートには、API に対する望ましくない攻撃に関する次の情報が含まれます。
- 報告されたリクエストが収集された Apigee 組織と環境。
- レポートのタイムスタンプ。
- レポート メッセージの ID。
- 望ましくないリクエストを行う IP アドレスの数。
潜在的に望ましくないリクエスト（ボットなど）を引き起こす IP アドレスのクライアント データの配列。各クライアントについて、レポートには以下が含まれます。
クライアントの特徴 説明 ipAddress クライアントの IP アドレス。 botDetectedLast クライアントからの最新のリクエストのタイムスタンプ。 ipIsp リクエストを行っているクライアントの ISP。 ipCountry クライアントからのリクエストが発生した国。 botReason この IP アドレスからのリクエストが一致した Apigee Sense 検出ルール。 callCount この IP アドレスからのリクエストの数。 topUrl クライアント IP が要求する最も一般的な URL。これはクライアントが要求した API です。 ipCity リクエストを受信した都市。
通知を設定するには
- New Edge エクスペリエンスを開きます。
- New Edge エクスペリエンスで、[Analyze] メニューをクリックし、[Sense] をクリックします。
- [設定] メニューをクリックします。
[Settings] ページで、値を入力して通知を構成します。
設定 説明 通知 この通知を有効または無効にする場合にクリックします。 URI Apigee Sense が通知を送信する際に使用する URI。これは通常、入ってくる Web フックを受け入れるモニタリング システムです。Apigee Sense からのレポートはこの URI に送られます。 API キー名 省略可。システムで認証するときに Apigee Sense が使用するキー名。API キーを使用してセキュリティを強化します。 API キー値 省略可。キー値 Apigee Sense は、システムで認証するときに使用する必要があります。セキュリティを強化するには、API キーを使用します。 IP の最大数 レポートに含めるクライアント IP アドレスの最大数（1 ～ 300）。Apigee Sense には、リクエストの数が多い順に、ここで指定した IP の数まで、疑わしいリクエストの数の順に IP アドレスが含まれます。