Apigee Edge のドキュメントを表示しています。
Go to the
Apigee X のドキュメントに移動します。 info
リクエストをブロックしたり、API プロキシ内で特別な処理を行うようにフラグを立てたりするなどの操作を行って、不審なリクエストを阻止できます。特定 IP アドレスからのリクエストを明示的に許可するアクションを実行することもできます。
ユーザーの行動のカウント方法
Apigee Sense コンソールでは、特定のクライアントからのリクエストを明示的に許可、ブロック、報告するためのアクションを実行できます。Apigee Edge は、こうしたアクションを API プロキシが処理する前にリクエストに適用します。 通常、リクエストが望ましくない動作のパターンに準拠している、または（許可アクションの場合）特定のクライアントを既存の禁止アクションから除外する必要があることを理由として、アクションを実行します。
アクションを実行するリクエストを検出するには、検出レポート（[Apigee Sense コンソール]で [検出] メニューをクリックし、[レポート] をクリック）を使用して、ブロックまたはフラグを設定するリクエストの動作を特定します。たとえば、検出レポートに、一連のリクエストが Brute Guessor の動作を示していることが表示される場合があります。それらの IP アドレスからのリクエストをブロックするためのアクションを実行できます。
次のタイプのアクションを実行できます。
| アクション | 説明 | 優先順位 |
|---|---|---|
| 許可 | 選択したカテゴリのリクエストを処理できるようにします。許可アクションを実行して、IP アドレスに影響を与える可能性のある他のアクションに関係なく、特定のクライアント IP アドレスからのリクエストを明示的に許可できます。たとえば、内部クライアントまたはパートナー クライアントの IP のリクエストが「望ましくない」動作に準拠している場合でも、そのリクエストを許可できます。 | 1 |
| ブロック | 選択したカテゴリのリクエストをブロックします。リクエストを完全にブロックすることを選択すると、Apigee Edge は 403 ステータス コードでクライアントに応答します。 | 2 |
| フラグ | 選択したカテゴリのリクエストにフラグを立て、API プロキシコード内でリクエストを処理できるようにします。クライアントのリクエストにフラグを付けると、Apigee Edge は値が SENSE の X-SENSE-BOT-DETECTED ヘッダーをリクエストに追加します。API プロキシは、このヘッダーの存在に基づいて応答できます。たとえば、特定のレスポンスをクライアントに送信するなどです。 |
3 |
Apigee Sense アクションの優先順位
Apigee Sense は、許可、ブロック、フラグの順に優先順位を付けてアクションを適用します。たとえば、特定の IP アドレスに対して許可アクションとブロック アクションの両方が有効になっている場合、Apigee Sense は許可アクションを適用し、ブロック アクションを無視します。
Apigee Sense は、優先順位を適用します。これは、ユーザーが認識せずに複数のアクションを IP アドレスに適用できるためです。通常、これは、総当たり推測をブロックするなど、多くの IP アドレスが関連付けられている 動作に対してアクションを実行するためです。後で、許可するフレンドリー IP アドレスを特定するなど、単一の IP に対して別のアクションを実行すると、動作適用アクションと単一 IP 適用アクションの両方がその IP に対して有効になります。ただし、特定の IP アドレスからのリクエストに対しては、優先順位が最も高いアクションのみが適用されます。
したがって、その IP アドレスに対する 3 種類のアクションを有効にし、Allow アクションを Block や Flag よりも優先させます。
リクエストとクライアントを特定して対処する
Apigee Sense コンソールでは、不審なクライアントをその送信元と理由でフィルタリングし、グループ化できます。目的のグループを分離したら、ブロックするなどの操作をそのグループ内の IP に対して実行できます。
不審なクライアントを次のパーティションでフィルタリングできます。
| パーティション | 説明 |
|---|---|
| 単一の bot の理由 | リクエストが不審な理由。理由の詳細については以下を参照してください。 |
| bot の理由グループ | 1 つまたは複数の IP アドレスからなる単一セットに関連する一連の理由。たとえば、そのリクエストが 3 つの理由で基準に一致する 4 つの IP アドレスが分析によって特定される可能性があります。 |
| 国 | リクエスト送信元の国。 |
| 自律システム組織 | リクエストの送信元の AS 組織。 |
理由
Apigee Sense は、API リクエストを解析分析する際に、リクエスト動作が疑わしいかどうかを判断する基準を使用してリクエストを測定します。IP からのリクエストが不審なアクティビティであるとする理由の条件を満たす場合、Apigee Sense はコンソール内でこれを報告します。
次の表で、不審なリクエストであると特定される理由について説明します。ポータルでは、条件のリストを表示しています。これらの理由で不審とみなされるリクエストを作成したクライアントをフィルタリングできます。
API 使用のニーズに合わせて条件をカスタマイズすることもできます。詳細については、検出ルールのカスタマイズをご覧ください。
| 理由 | 検出された動作 |
|---|---|
| Brute Guessor | 過去 24 時間のレスポンス エラーの割合が大きい |
| Content Quota Exceeder | コンテンツの割り当てを超過したため発生した 403 エラーの後の追加リクエスト |
| Content Robber | 5 分間のウィンドウで僅かな OAuth セッションが大量のトラフィックを伴う |
| Content Scraper | 5 分間のウィンドウで呼び出される URI が多数である |
| Distinct OS | 5 分間のウィンドウで複数のオペレーティング システム ファミリーが使用される |
| Distinct User Agent Family | 5 分間のウィンドウで複数のユーザー エージェント ファミリーが使用される |
| Flooder | 5 分間のウィンドウで発生する IP からのトラフィックの割合が高い |
| Guessor | 5 分間のウィンドウでレスポンス エラーが多数発生する |
| Login Guessor | 5 分間のウィンドウで僅かな URI に対し大量のトラフィックがある |
| OAuth Abuser | 過去 24 時間に少数のユーザー エージェントにより多数の OAuth セッションが行われている |
| OAuth Collector | 過去 24 時間に少数のユーザー エージェント ファミリーにより多数の OAuth セッションが行われている |
| OAuth Harvestor | 5 分間のウィンドウで大量のトラフィックを伴う OAuth セッションが行われている |
| Robot Abuser | 過去 24 時間に 403 不承認エラーが多数ある |
| Short Session | 短い OAuth セッションが多数ある |
| Static Content Scraper | 5 分間のウィンドウで発生する IP からのレスポンス ペイロード サイズの割合が高い |
| ストーム | 5 分間のウィンドウでトラフィックが急増することが僅かにある |
| 竜巻 | 5 分間のウィンドウで 一貫してトラフィックが多い |
| Tor List Rule | IP が TOR プロジェクトに起因し、IP が他の bot ルールを 1 つ以上トリガーする |