> For the complete documentation index, see [llms.txt](https://help.aikido.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.aikido.dev/docs/docs-ja/dast-sfesu/api-scanning/graphql-api-scanning.md).

# GraphQL API スキャン

{% hint style="warning" %}
**Agentic Scan は GraphQL API をテストするための推奨オプションです。** GraphQL スキャナーでは見つけられない、ファジング形式のチェックに加えて、ビジネスロジックの欠陥、IDOR、テナント間データ漏えいもカバーします。参照 [Aikido Pentest](/docs/docs-ja/penetorshontesuto/aikido-pentest.md).
{% endhint %}

Aikido は、GraphQL に特有のエンドポイント脆弱性を明らかにするために、GraphQL API エンドポイントをスキャンできます。私たちが使用する手法の一つは API ファジングで、これは要するに、API の各フィールドに対して危険なペイロードを大量に送信することを含みます。

{% hint style="danger" %}
本番環境では絶対に実行せず、潜在的なダウンタイムを避けるため常にステージング環境で実行してください
{% endhint %}

### 主なユースケース <a href="#main-use-cases" id="main-use-cases"></a>

すべてのチェックは次で確認できます [Aikido アプリはこちら](https://app.aikido.dev/domains/checks?scanner=graphql).

### GraphQL API スキャンの設定 <a href="#setting-up-graphql-api-scanning" id="setting-up-graphql-api-scanning"></a>

**ステップ 1:** クリック **ドメインを追加** を [ドメイン概要](https://app.aikido.dev/domains)、展開 **Advanced** スキャンタイプの選択画面で展開し、次を選択 **GraphQL**

![詳細セクションが展開され、REST API と GraphQL のオプションが表示されたスキャンタイプ選択モーダル。](/files/6ca4eb8c65aaeeb20f08098f7b4d644c350cd53e)

**手順 2。** 次のドメイン名を入力してください **ステージング環境**。これは GraphQL API のベース URL であることを確認してください（例： `https://example.io/graphql`)

![GraphQL エンドポイントのドメイン名を入力するための入力欄。](/files/3c4cc401174b301a9af55ccc395883ef4572817e)

**ステップ 3:** 保存をクリックすると、Aikido が GraphQL API のスキャンを開始します。

**ステップ 4. 認証:** API と通信するために必要であれば、認証情報を追加することもできます。ドメイン上の三点リーダーのアクションメニューをクリックし、次に「**ドメインを認証**'

![スキャン、設定、認証、削除のオプションを提供するドメインのアクションメニュー。](/files/617f7757c32c747f24a5bda0223c1c0368df9526)

これにより、認証情報を入力できるモーダルが表示されます。サポートされている認証方式の全一覧は、次を参照してください [REST/GraphQL の認証付き API スキャン](/docs/docs-ja/dast-sfesu/api-scanning/authenticated-api-scanning-for-rest-graphql.md).

![フォームベースのログイン資格情報を有効にするためのドメイン認証設定フォーム。](/files/9717cdffdf9e148e1515a86729a1cc2fdb5a648c)

### Aikido のトラフィックを識別する

Aikido の REST および GraphQL スキャンから送信されるすべてのリクエストには、次が含まれます:

* その `User-Agent` に設定され `aikido-scan-agent/1.0`
* 次のヘッダー `aikido-api-test` 値に設定されます `1` リクエスト内で
* [は、ここに記載されている IP アドレスから送信されます](/docs/docs-ja/dast-sfesu/allowing-ip-addresses-for-dast-surface-monitoring.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.aikido.dev/docs/docs-ja/dast-sfesu/api-scanning/graphql-api-scanning.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
