開始する前に

ここに表示されているのは Apigee Edge のドキュメントです。
Go to the Apigee X のドキュメントに移動します
info

Apigee Sense を使用すると、API プロキシに対する不要なリクエストを防ぐことができます。ただし、不要に見えても、実際には不要でないアクティビティもあります。結果的に問題のないトラフィックを誤ってブロックしてしまうこともあります。

Apigee Sense を使い始める前に、このトピックの手順を行ってください。特に、望ましくない動作のクライアントをブロックする前に、問題のないクライアントの IP アドレスからのアクセスを許可してください

検出結果の分析

Apigee Sense コンソールで最初に検出結果を確認するときに、時間をかけて分析を行いましょう。アクションを実行する前に、表示されている内容を理解してください。

検出レポートを調べるときに、次のことを確認しましょう。

  • 表示されている IP アドレスの中に、リクエストを受け入れるクライアント (パートナーなど)の IP アドレスはありますか。問題のないクライアントのアクティビティであれば、検出結果に表示されていてもブロックする必要はないでしょう。クライアントが問題のないクライアントであるかどうかは、次の方法で判断できます。

    • 本番環境で API を使用していることがわかっているパートナーの IP アドレスである。
    • API に対してテストを実行しているユーザーの IP アドレスである。

    問題のないリクエストに対応する方法については、以下の必要なクライアントからのリクエストへの対応をご覧ください。

  • 問題のないクライアントを特定したら、他のクライアントについて次のことを確認します。該当する場合は、協調的な攻撃を受けている可能性があります。

    • 検出ルールのパターンに一致したリクエストが広範囲から送信されているが、自律システム組織の数は比較的少ない。
    • 少数のユーザー エージェントから大量のリクエストが送信されている。

検出レポートでクライアントの詳細を確認するには

  1. Apigee Sense コンソールで [Detection] をクリックして、[Report] をクリックします。
  2. ボット数とボット トラフィックが最も多い検出ルールから確認します。各ルールで [View] ボタンをクリックします。 [List View] に、検出ルールのパターンに一致するリクエストの IP アドレスが表示されます。
  3. クライアントに関する情報は、次の方法で確認できます。
    • リストの行の値(地理的位置など)を確認する。
    • IP アドレスをクリックして、リクエストの詳細(ユーザー エージェントなど)を表示する。

必要なクライアントからのリクエストへの対応

検出結果を見ていると、疑わしいものはすべてブロックしたり、フラグを立てたりしたくなるかもしれません。しかし、大量のアクティビティが発生していても、その中にはリクエストを受信する必要があるクライアントからのアクティビティが含まれている可能性があります。

クライアント IP アドレスのアクセスを許可するには

検出パターンに一致するリクエストを行う可能性があるパートナーやクライアントのアクセスを許可できます。これは、Apigee Sense の最初の段階で行う重要な作業です。これにより、不要なクライアントをブロックする際に、誤って問題のないクライアントをブロックすることを防ぐことができます。なお、これにより、検出ルール レポートに IP アドレスが表示されなくなるわけではありません。

クライアント IP アドレスへのアクセスを許可するには、そのアドレスに対して [許可] アクションを実行します。

  1. Apigee Sense コンソールで [Detection] メニューをクリックして、[Report] をクリックします。
  2. IP アドレスのリストで、アクセスを許可するクライアントのアドレスを見つけます。
  3. その IP アドレスの行の [ACT] 列で、プルダウンをクリックして [Allow] をクリックします。

検出ルールを無効にするには

検出ルールを無効にすると、そのルールは検出レポートに表示されるルールセットから除外されます。このルールが問題のないクライアントのみ(または主に)を検出していると思われる場合に便利です。

  1. Apigee Sense コンソールで [Detection] メニューをクリックして、[Rules] をクリックします。
  2. [Detection Rules] リストで、無効にするルールを見つけます。
  3. リスト内のルールの行にカーソルを合わせ、行の右端にある [Disabled] をクリックします。

    1 時間後に、検出レポートの分析結果を調べて、変更によって、必要な結果がもたらされたかどうかを評価します。

Apigee の可用性をモニタリングする

サービスの停止など、Apigee Sense システムに関する情報を受け取るには登録が必要です。

Apigee Sense の最新情報を取得するには

  1. ウェブブラウザで Apigee Sense Disruption ページに移動します。
  2. [Subscribe to Updates] ボタンをクリックします。

サポートへのお問い合わせ

Apigee Sense に関連するサポートが必要な場合は、Apigee Edge Support Portal としてサポートケースを登録してください。