APIセキュリティテストは、少々厄介な質問から始まります。あなたのアプリケーションは現在、いくつのエンドポイントを公開していますか?OpenAPI仕様に記載されているエンドポイントではなく、あなたのコードが実際に提供しているエンドポイントのことです。
ほとんどのチームにとって、この2つの数字は一致しません。仕様書は数ヶ月前に作成され、コードはその後も変更され続け、その過程で内部ルート、エクスポートエンドポイント、そして誰も文書化していない古いバージョンが生まれてきました。これらはシャドウAPIであり、存在を知らないものをテストすることはできません。
TL; DR
APIセキュリティテストは2つのレイヤーで実施されます:コードからのインベントリ、実行時の検証。
自分が持っていることを知らないAPIを保護することはできません。APIセキュリティテストは、信頼できるインベントリを作成することから始まります。そして、最も信頼できる情報源は仕様書ではなく、コードそのものです。
- 在庫変動: コードと仕様を比較すると、存在するが文書化されていないエンドポイント(シャドウ API)と、文書化されているがもはや何の役にも立たない操作(孤立した API)が明らかになる。 OWASP API9:2023.
- ハンドラーの欠陥: APIの欠陥の多くは、インジェクションバグではありません。所有権チェック(BOLA)の欠如、ロールチェックのない管理者ルート、あるいは本来よりも多くのフィールドを返すレスポンスなどが挙げられます。これらの欠陥は、ハンドラーを読み込むことで最もよく確認できます。
- 実行時証明: 実行時テストは、コードが示唆する内容、つまり認証なしで応答するエンドポイント、ゲートウェイが既に補償している箇所、デプロイされたアプリケーションで悪用可能な箇所などを確認します。
- 問題ごとに1つの発見: これら2つのレイヤーを組み合わせることで、問題ごとに1つの発見結果が得られ、それが明らかにするデータ(個人情報、支払い情報、健康情報、認証情報)に基づいてランク付けされます。
最初のステップ: コードからAPIインベントリを作成し、それをOpenAPI仕様と比較した後、実行時テストを文書化された部分だけでなく、カタログ全体に対して行うようにします。
一般的なAPIセキュリティテストが不十分な理由
ほとんどのチームは、APIを保護するために3つの要素を使用しています。エッジで認証を強制するゲートウェイ、仕様を走査するスキャナー、そして年に1~2回実施する手動のペネトレーションテストです。これら3つはすべて役立ちますが、共通の盲点があります。
これらはすべて、どのエンドポイントが存在するかを知っている人がいることを前提としています。スキャナーは仕様書に記載されている内容のみをテストします。ペネトレーションテストは、与えられた範囲のみを対象とします。また、ゲートウェイはエッジで認証を強制しますが、ハンドラーが注文番号4512が要求したユーザーのものであるかどうかをチェックしていないことを認識することはできません。
だからこそ、 OWASP API セキュリティ トップ 10 不適切な在庫管理に特化したカテゴリーを設けている(API9:2023)、そして最大の危険がオブジェクトレベル認証の破損 (API1) である理由: シグネチャもインジェクションパターンもない論理的な欠陥。
レイヤー1:コードから構築されたAPIインベントリ
信頼性の高いAPIセキュリティテストは、変化しない唯一の情報源であるコードから構築されたインベントリから始まります。 Xygeni APIセキュリティ 依存関係マニフェストを検査し、使用しているWebフレームワークを検出し、複数のファイルにわたって宣言されているルートを含むすべてのエンドポイントを抽出します。
Spring Boot、ASP.NET Core、Django、FastAPI、Express、Laravelなど、主要なサーバーサイド言語の人気のあるWebフレームワークを読み取ります。 OpenAPI 3.x そしてSwagger 2.x仕様に準拠しています。その結果、サービス、モジュール、エンドポイント、およびそれらのメソッド、パラメータ、リクエストボディ、レスポンス構造を網羅したカタログが作成されます。
コードと仕様を並べて比較すると、乖離が明らかになる。
- シャドウAPI: コードが提供するエンドポイントだが、仕様書には記載されていない。
- 孤立したAPI: どのハンドラも対応していない仕様操作。
検出機能を有効にする準備ができていない場合は、ディスカバリーモードが自動的にカタログとその欠落部分を構築します。これは、初日から余計な情報を追加することなく、開発チームとの対話を開始する良い方法です。
ハンドラーを読むことで、どのような欠陥が見つかるか
多くのAPIの脆弱性は、インジェクション攻撃によるバグではなく、チェック漏れによるものです。Xygeniはルート、ハンドラー、スペックをまとめて読み込むため、パターンベースのスキャナーでは検出できない脆弱性を表現できます。検出された脆弱性はすべて、OWASP API Security Top 10 (2023)のカテゴリとCWEにマッピングされます。
コードを読むことで発見できるAPIの欠陥
各欠陥は、 OWASP API セキュリティ トップ 10つまり、調査結果は監査担当者やペネトレーションテスターと同じ言語で話せるということです。
| 欠陥 | コード内で何を探すか | OWASPカテゴリ |
|---|---|---|
| 壊れたオブジェクトレベルの認証BOLA / IDOR | リクエストからIDに基づいてオブジェクトを読み込むエンドポイントは、それがユーザーに属するかどうかを確認せずに読み込む。 | API1 |
| 過剰なデータ露出 | 必要以上のフィールドを返すレスポンス | API3 |
| 機能レベル認証の不具合 | ロールチェックなしの管理者ルート | API5 |
| 認証されていないエンドポイントと一括割り当て | ルートを開放し、受け入れるべきではないフィールドを受け入れるリクエストボディ | API2とAPI3 |
| シャドウAPIと孤立API | コードと仕様の違い | API9 |
BOLAでは、言語ごとの分析で所有権チェック、リポジトリスコープ、IDバインディングがチェックされます。また、フレームワーク設定で一元的に宣言された認可ルールも解決され、独自の所有権チェック関数名を追加することで、さらにノイズを削減できます。GraphQL APIには、独自のチェックが適用されます。
優先順位を変える重要な要素は、すべてのフィールドに個人情報、支払い情報、健康情報、認証情報、暗号化データのいずれかがタグ付けされることです。認証されていないエンドポイントから個人データが返された場合、それは重大な問題として扱われ、何百件もの些細な問題の後ろに埋もれてしまうことはありません。
レイヤー2:ランタイムテスト
コードは起こりうる事態を示し、実行時テストは実際に起こる事態を示します。完全なAPIセキュリティテストには両方の視点が必要であり、Xygeniは3つのレベルで同じエンドポイントインベントリを介してこれらを連携させます。
- APIセキュリティのリアルタイムチェック。 認証結果を確認または否定するために、候補エンドポイントごとに非破壊的なリクエストを1つ送信します。環境が401または403を返した場合、その結果は否定済みとしてマークされます。これは、ゲートウェイが既にその場所で補償を行っていることの証明となります。
- Xygeni DAST. このツールは、署名済みのDockerイメージからWebアプリケーションとAPIを実行し、それを独自のCIランナーまたは内部ネットワークで実行します。本番環境に対しては、攻撃ペイロードを送信しないパッシブな強度を使用します。アクティブなテストには、テストアカウントを備えたステージング環境の使用をお勧めします。
- AIペネトレーションテスト. AIエージェントは、OWASP APIセキュリティトップ10にマッピングされた、悪用可能な脆弱性を検証するために、認可されたターゲットに対して非破壊的な攻撃を計画および実行します。
問題が1つ、発見が1つ
インベントリとランタイムテストを組み合わせることのメリットは、アラートが増えることではなく、アラートの数が減り、質が向上することです。 AI SAST ハンドラーでの発見、実行中のエンドポイントでの DAST の発見、および API の欠陥は相関関係にあります。 ASPM リスクグラフ(感度タグ付き)。
コードからのAPIインベントリとランタイムテストとの比較
どちらのレイヤーも他方を置き換えるものではありません。完全なAPIセキュリティテストでは、両方のレイヤーが同じエンドポイントインベントリを介して接続され、使用されます。
| 次元 | コードからのAPIインベントリ | ランタイムテスト |
|---|---|---|
| 実行時 | 展開前に、 pull request | デプロイ済みのアプリケーション(ステージング環境、または本番環境でのパッシブ環境)に対して |
| 最もよく見えるもの | シャドウAPI、BOLA、役割チェックの欠落、データ漏洩 | 実際に答えているのは、環境構成、悪用可能性です。 |
| 他の層に与えるもの | テスト対象エンドポイントの全カタログ | 法典が示唆する内容の確認または反証 |
ハンドラーの欠陥と、それにアクセスする公開エンドポイントは、同一の問題であり、責任も同一です。また、既に別のDASTツールを実行している場合、Xygeniはツールの置き換えを求めることなく、その結果を同じリスクビューにインポートします。
両方のレイヤーが連携して動作する様子をご覧になりたいですか? 私たちのセッションをご覧ください コードからランタイムへ:なぜ SAST + DAST はどちらも現代のアプリケーションセキュリティに不可欠ですここでは、コード上の発見事項と実行時テストがどのように互いを裏付けるのかを詳しく解説します。
APIセキュリティテストを開発ライフサイクルに組み込む方法
中規模チームに最適なパターンはシンプルです。
- すべてに pull request: 変更されたコードに対するCIにおけるAPIセキュリティに加え、増分DASTスキャンも実施する。
- 作業前 commit: として pre-commit ステージングされたファイルに対するゲート。
- 毎晩またはマージ時: 完全なDASTスキャン。
- 各メジャーリリース前に: ステージング環境に対するAIペネトレーションテストを実施し、バックログを検証するとともに、各修正によって脆弱性が解消されたことを確認します。
APIセキュリティスキャナーは、エアギャップ環境を含むあらゆる場所で実行され、Xygeni SaaSまたはお客様のシステムにレポートします。 on-premise プラットフォーム。結果はJSON形式で出力されます。 サリフ2.1.0CSVとMarkdown pull request コメント。
APIセキュリティテストとコンプライアンス
銀行、保険、公共部門のチームにとって、APIセキュリティテストは証拠にもなります。すべての発見にはコンプライアンスタグが付けられます。 GDPR第32条, PCI DSS 4.0 (要件3.4、6.4.3、7.1、7.2、8)および NIST SP 800-53 (AC-3、AC-6、IA-2、IA-5)は、プラットフォーム上およびJSONとSARIF出力で確認できます。
あなたの組織が以下のいずれかに該当する場合 DORA or NIS2ランタイムテストは、規制当局が依然として要求する手動の侵入テストの間に、継続的な証拠を提供します。
実際に実行するAPIをテストしてください。ドキュメントに記載したAPIをテストしてはいけません。
仕様書を読むだけのAPIセキュリティテストでは、実際に実行するAPIではなく、想定しているAPIしかテストできません。まずはコードからインベントリを作成し、実行時テストで確認し、エンドポイントが公開するデータに基づいて各脆弱性をランク付けしましょう。
コードが公開するすべてのエンドポイントを確認したいですか?エンジニアとのセッションを予約して、リポジトリのAPIインベントリを作成し、その結果を確認しましょう。または、今すぐ無料でコードと依存関係のスキャンを開始してください!
よくあるご質問
既にAPIゲートウェイを導入している場合でも、APIセキュリティテストは必要ですか?
はい。ゲートウェイはエッジで認証を強制しますが、ハンドラー内の所有権チェックの欠落や、フィールドが多すぎるレスポンスを検出することはできません。Xygeniのライブチェックでは、ゲートウェイが既に補正を行っている箇所も表示され、それらの検出結果を反証済みとしてマークします。
非公開APIや非公式APIを見つけるにはどうすればよいですか?
コードが提供している機能と仕様書の内容を比較してください。Xygeni API Security はこれを自動的に行います。ソースコードからエンドポイントを検出し、OpenAPI または Swagger 仕様書に記載されていないエンドポイントをシャドウ API としてフラグ付けし、ハンドラーのない仕様操作を孤立した操作としてフラグ付けします。
本番環境に対してランタイムテストを実行しても安全でしょうか?
Xygeni DASTのパッシブな強度であれば、攻撃ペイロードは送信されず、リクエストレートを制限でき、トラフィックにはX-Xygeni-DASTヘッダーが付加されるため、問題ありません。アクティブテストやAIペネトレーションテストの場合は、テストアカウントを備えたステージング環境の使用をお勧めします。







