# ペネトレーションテスト

## 概要 {#overview}

AI ペネトレーションテスト機能は、指定された目的の達成に向けて、Takumi が自律的に脆弱性の発見と攻撃を繰り返す機能です。

ユーザーは攻撃対象と達成したいゴール（例：「利用者データの取得」）を設定するだけで、Takumi が偵察・脆弱性の発見・攻撃の一連のプロセスを自動的に実行します。テスト完了後、攻撃の過程と結果をまとめたレポートが出力されます。テストの流れは次の図のとおりです。

![ペネトレーションテストの流れ](/docs/ja/_md-assets/72e9a87687-pentest-overview_ja.png)

Shisho Cloud byGMO の Web 画面から利用できます。

インターネットから到達できないシステムをテストする場合や、侵害を想定した端末を介してテストする場合は、[内部起点テスト](/docs/ja/t/assessment/features/pentest/gateway/index.md)をご覧ください。

## 通常の診断機能との違い {#comparison}

ペネトレーションテストは、ホワイトボックス診断・ブラックボックス診断・グレーボックス診断とは目的やアプローチが異なります。

|                  | ホワイトボックス / ブラックボックス / グレーボックス診断 | ペネトレーションテスト                                   |
| ---------------- | -------------------------------------------------------- | -------------------------------------------------------- |
| **目的**         | アプリケーション全体の脆弱性を網羅的に検出する           | 特定のゴール（例：機密情報の取得）が達成可能かを検証する |
| **アプローチ**   | 機能×観点のマトリクスに基づいて体系的にテストする        | ゴール達成に向けて、攻撃パスを自律的に探索する           |
| **テスト範囲**   | 検出されたすべての機能と観点の組み合わせ                 | ゴール達成に必要な経路に集中する                         |
| **出力**         | 脆弱性一覧とその詳細（観点ごとの検出結果）               | 攻撃過程の記録と結果をまとめたレポート                   |
| **適するケース** | 網羅的なセキュリティ診断を行いたいとき                   | 実際の攻撃者の視点で特定のリスクを検証したいとき         |

:::info
ペネトレーションテストは脆弱性の網羅的な検出を目的とした機能ではありません。「このゴールは達成可能か」という問いに対する回答を得るための機能です。網羅的な脆弱性検出が必要な場合は、[ホワイトボックス診断](/docs/ja/t/assessment/features/whitebox-assessment.md)・[ブラックボックス診断](/docs/ja/t/assessment/features/blackbox-assessment.md)・[グレーボックス診断](/docs/ja/t/assessment/features/graybox-assessment.md)をご利用ください。
:::

## 事前準備 {#prerequisites}

ペネトレーションテストを開始する前に、組織認証が必要です。詳細は「[診断前の組織認証あるいは所有権証明](/docs/ja/t/assessment/features/assessment-authentication.md)」を参照してください。

## ペネトレーションテストの作成 {#create}

サイドバーの「診断」をクリックし、画面上部の「ペネトレーションテスト」タブを選択すると、ペネトレーションテストの一覧画面が表示されます。「新規作成」ボタンを押すと、作成方法を選択するダイアログが表示されます。

- **新規作成**：空の設定から新しいテストを作成する
- **既存のテストから作成**：過去のテストの設定を引き継いで作成する。同じ対象に対する再テストや、設定を一部変更して実行する際に利用する

いずれかを選択すると、設定画面に遷移します。

### 設定 {#settings}

基本設定の項目は以下のとおりです。

- **テスト名**：このテストを識別するための名前を入力する
- **レポート言語**：レポートの言語を選択する（日本語または英語）
- **クレジット上限**：テストで消費するクレジットの上限を設定する。30 以上の値を指定する必要がある

### スコープ {#scope}

テストの対象範囲と対象外を定義します。Takumi はスコープの定義に基づいて、テスト対象のシステムを判別します。

**対象範囲**には、テスト対象として許可するシステムを 1 つ以上登録してください。**対象外**には、テスト中にアクセスしてはならないシステムを登録します。たとえば、対象範囲に登録したシステムと関連するインフラや外部サービス（同一ドメイン上の管理画面、連携先の API、同一アカウント内の他のクラウドリソースなど）のうち、テストに含めたくないものがある場合は、対象外として明示的に登録してください。対象外のスコープが明確に定義されていない場合、Takumi が攻撃パスの探索中にそれらのシステムへアクセスする可能性があります。

Takumi はスコープを遵守するよう制御されていますが、自律的に攻撃パスを探索する性質上、テストの過程でスコープ外のシステムへアクセスする可能性を完全には排除できません。万が一そのような事象が発生した場合は、テスト中の操作記録をもとに事後確認が可能です。詳しくは[テストデータと認証情報の取り扱い](#pentest-data-handling)を参照してください。

各エントリには以下の種別を指定できます。

| 種別         | 説明                        | 入力例                                 |
| ------------ | --------------------------- | -------------------------------------- |
| URL          | Web アプリケーションの URL  | `https://example.com`                  |
| IP アドレス  | IP アドレスまたは CIDR      | `192.168.1.0/24`                       |
| AWS          | AWS アカウント ID           | `123456789012`                         |
| Google Cloud | GCP プロジェクト ID         | `my-project-id`                        |
| Azure        | Azure サブスクリプション ID | `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx` |
| その他       | 上記に当てはまらない対象    | `S3 bucket s3://company-data`          |

各エントリには任意で補足情報を追加できます。

### 目的 {#objective}

テストの目的を定義します。以下の 3 つの要素から構成されます。

- **最終的な攻撃対象**：攻撃の起点となる URL やシステムを指定する。スコープの対象範囲に含まれるエントリから選択するか、「カスタム」を選択して自由に入力できる
- **ゴール**：達成したい目標を選択する。以下の 4 つのプリセットから選択できる
  - 利用者データの取得
  - 個人情報の取得
  - 機密情報の取得
  - システムへの侵入（任意コード実行）
- **補足情報**（任意）：ゴールの詳細や、対象データの定義、制約条件などを記述できる

### 破壊的な操作 {#destructive}

テスト中に、データ破壊や大規模な設定変更など、対象システムに重大な影響を与える操作を Takumi にどの程度許可するかを選択できます。

以下の選択肢が利用できます。

- **避ける**：データ破壊や大規模な設定変更を避ける。これらの操作が唯一の手段であっても、ゴールを達成せずに終了する
- **最小限**：まず非破壊的な手段を尽くし、データ破壊や大規模な設定変更は他に方法がない場合の最終手段として必要な最小限にとどめる
- **許可**：全選択肢に共通する禁止操作を除き、データ破壊や大規模な設定変更を含む操作を許可する

アプリケーション上の通常のデータ作成やテスト中に作成したデータの編集は、データ破壊や大規模な設定変更を伴わなければ、いずれの選択肢でも許可されます。

ただし、次の操作は「許可」を含むすべての選択肢で抑止するよう制御されています。

- 全利用者の管理者化や認証・多要素認証の全体無効化など、既存利用者全体の認証・認可に影響するクリティカルな操作
- サービス停止や過大な負荷につながる操作
- 提供された認証情報に対応するアカウントやテスト中に作成したアカウント以外へのログイン試行
- テストで管理していないメールアドレスへのパスワード再設定などの操作
- 対象や影響を確認できない操作

これらの禁止操作に該当しないシステム全体の設定変更は、選択したポリシーに従って扱われます。

:::info
対象システムの状態や構成によっては想定外の挙動が生じうるため、「避ける」を選択しても、対象が予期せぬ破壊的な影響を受けないことを完全に保証するものではありません。
:::

### 認証情報 {#credentials}

対象システムにログインが必要な場合、認証情報を設定します。認証情報は複数設定でき、それぞれに以下の項目を指定します。

- **認証方式**：「パスワード」または「その他」を選択する
  - パスワード認証の場合、ユーザー名とパスワードを入力する
  - その他の場合、認証手順の説明を入力する
- **ロール / アカウント種別**（任意）：管理者、一般ユーザーなどのアカウントの役割を記述する
- **利用対象**（任意）：この認証情報を使用する対象を、スコープのエントリから選択する
- **アカウントのメールアドレス**：アカウントがご自身のアドレスでサインインするか、「Takumi 管理メール」でサインインするかを選択する。診断対象がサインイン時にワンタイムコードをメールで送信する場合は、「Takumi 管理メール」を選択する（設定手順は[メールのワンタイムコードを用いたサインイン](/docs/ja/t/assessment/features/blackbox-assessment.md#disposable-mailbox)を参照）

:::info
対応している認証方式は ID / パスワード認証のみです。TOTP を利用する場合は、認証方式で「その他」を選択し、手順を記述してください。SMS へのコード送信など、メール以外のアウトオブバンド通信が必要な認証方式には対応していません。
:::

### 参考ファイル {#reference-files}

テスト中に Takumi が参照できるファイルをアップロードできます。API 仕様書やアーキテクチャ図など、テストの手がかりとなる資料がある場合に活用してください。

- 最大 5 ファイルまでアップロード可能
- 各ファイルのサイズ上限は 10 MB

### コマンド実行時のルール {#tool-approval}

Takumi が攻撃用のコマンドを実行する際に遵守させたいルールを定義できます。

Takumi はコマンドを実行する直前に、その内容がここで定義したルールや[スコープ](#scope)・[破壊的な操作](#destructive)のポリシーに違反していないかを自動で確認し、違反する場合は実行を止めます。ルールを指定しなかった場合は、スコープ・破壊的な操作のポリシーに基づいて判定します。

## 開始前の確認事項 {#disclaimer}

ペネトレーションテストは、実際の攻撃者と同じように対象システムへ能動的に攻撃を行う機能です。開始前に、以下の事項を必ずご確認ください。テスト開始時の確認ダイアログでも、これらへの同意を求めています。

- **対象システムの所有権または承諾**：テスト対象のシステムは、ご自身が管理者であるか、管理者から明示的な承諾を得たものに限ります。承諾のない第三者のシステムへテストを行い損害が生じた場合、利用規約に従い利用者が責任を負うことになります。
- **対象システムへの影響**：テストの過程で、対象システムやデータに対して変更・破壊を伴う操作が行われる可能性があります。[破壊的な操作](#destructive)のポリシーを「避ける」に設定した場合でも、その影響を完全には排除できません。
- **テスト中に作成されるリソース**：テストの過程で、検証用のアカウントやリソースが対象システム上に作成されることがあります。Takumi はテストの終了時にこれらを可能な限り削除するよう制御されていますが、すべてが確実に削除されることを保証するものではありません。攻撃の足がかりとして残存しうるため、テスト終了後は対象環境を確認し、不要なものを削除してください。
- **スコープ外へのアクセス**：スコープ外の対象へのアクセスは監視・抑止していますが、Takumi が自律的に攻撃パスを探索する性質上、完全には防止できません。詳しくは[スコープ](#scope)を参照してください。

## テストの開始 {#start}

すべての設定が完了したら、「ペネトレーションテストを開始」ボタンをクリックします。確認ダイアログが表示されるので、[開始前の確認事項](#disclaimer)に同意したうえで開始してください。

テストが開始されると、ステータスが「実行中」に変わります。

## 進捗の確認 {#monitoring}

テスト実行中は、対象テストのページから「進行状況を確認する」ボタンをクリックすると、リアルタイムの進捗画面を確認できます。ペネトレーションテストは通常、数時間〜1日程度で完了します。

進捗画面では、攻撃の到達点を時系列で示す**タイムライン**と、攻撃経路を視覚的に示す**侵入マップ**を確認できます。進捗画面はテスト完了後も引き続き閲覧可能です。

![進捗画面](/docs/ja/_md-assets/a0b608e5d4-progress.png)

:::info
実行中のテストは、テスト一覧画面のメニューからキャンセルすることもできます。
:::

## 結果の確認 {#results}

テストが完了すると、Takumi が生成したレポートを Web 上で閲覧できます。レポートには、攻撃の過程で実施した操作と、ゴールの達成結果が記載されます。

テスト詳細ページの「進行状況を確認する」ボタンから、タイムラインと侵入マップも引き続き確認できます。

### PDF レポートのエクスポート {#pdf-report}

レポートを PDF としてダウンロードできます。レポートページの **「PDFレポートを発行」** ボタンから、表紙の言語（英語または日本語）を選んで発行します。発行が完了すると、ログイン中のアカウントに紐づいたメールアドレスに対して、ダウンロードリンクが送付されます。

ダウンロードリンクの有効期限は 15 分ですが、再度ダウンロードボタンをクリックすることで新しいリンクを取得できます。発行した PDF は 30 日後に削除されるため、必要に応じて保存してください。

## テストの再開 {#resume}

ペネトレーションテストが目的を達成できないまま完了した場合、ステータスが「**再開待ち**」に移行します。その際、レポートを確認したうえで、再開分のクレジット上限を設定し、必要に応じて追加の指示を添えて Takumi にテストを再開させることができます。

本機能では、最初に設定したスコープ・認証情報・参考ファイルがそのまま引き継がれるほか、Takumi は前回のレポートを参考にしたうえでテストを再開するため、より効率的に追加のテストを行わせることが可能です。

再開も対象システムへ改めて攻撃を行う操作であるため、開始時と同じく[開始前の確認事項](#disclaimer)への同意を求めるダイアログが表示されます。

:::info
再開せずに、現在の結果のままテストを完了することもできます。テスト詳細ページの「現在の結果で完了する」ボタンを押すと、ステータスが「実行済」になります。完了したテストは再開できません。
:::

## 結果の引き継ぎ {#follow-up}

ブラックボックス診断・グレーボックス診断・ペネトレーションテストの結果から、新しいペネトレーションテストを開始できます。各診断のレポートページのメニューに表示される「ペネトレーションテスト」ボタンを押し、目的とクレジット上限を設定してください。

本機能では、元の診断やテストのスコープと認証情報がそのまま引き継がれます。また、Takumi は元の診断やテストで判明した対象システムの情報を参考にテストを進めるため、検証済みの箇所を調べ直さずに、新たな脆弱性や攻撃経路の調査を進めることができます。

## テストデータと認証情報の取り扱い {#pentest-data-handling}

テストデータ（設定した認証情報を含むテスト設定と、進捗やレポートなどの実行結果）は、テストを作成した組織に所属し、かつ以下のいずれかのロールを持つユーザーのみが閲覧できます。

- オーナー（`organization/owner`）
- Takumi管理者（`organization/takumi_manager`）
- Takumi利用者（`organization/takumi_user`）

テストの作成と実行も、これらのロールを持つユーザーが行えます。

また、[テストの削除](#deleting-a-pentest)は、このうち「オーナー」または「Takumi管理者」のロールを持つユーザーのみが実行できます。

設定した認証情報は、テスト中に対象システムへログインするため、また既存のテストから設定を引き継ぐために、テスト設定の一部として保持されます。対象システムへのログインには、テスト用に用意したアカウントを利用することを推奨します。

テスト中に Takumi が実行した操作の記録は、最低 30 日間サーバー側で保持されます。意図しない操作が行われた可能性がある場合は、事後に確認が可能ですので、サポートまでお問い合わせください。

## テストの削除 {#deleting-a-pentest}

実行が終了したテストは削除できます。テスト一覧画面で対象のテストの行の右側にあるメニューアイコンをクリックし、「削除」を選択してください。表示される確認ダイアログで承認すると削除が実行されます。

なお、テストを削除すると、設定した認証情報を含むテスト設定や、レポートなどの関連データもあわせて削除されます。削除は元に戻せない操作であり、削除したテストやそのデータを後から復元することはできません。

## クレジット消費について {#credits}

ペネトレーションテストの利用にはクレジットが必要です。

テスト開始時に**クレジット上限**を設定する必要があります。最低値は **30 クレジット**で、デフォルト値も 30 クレジットです。Takumi は設定された上限の範囲内でテストを実行します。上限に達した場合、実行中のアクションが完了した後にテストが停止します。

ペネトレーションテストは、ゴールの難易度や対象システムの規模に応じて消費クレジットが大きく変動します。複雑なゴールや広いスコープを設定した場合は、より多くのクレジットが消費される傾向があります。

なお、テストの実行中は、指定したクレジット上限分があらかじめ残高から確保されるため、表示されるクレジット残高は確保分を差し引いた値となります。詳細は [診断実行中のクレジット確保](/docs/ja/t/assessment/billing/pricing.md#credit-reservation) を参照してください。

:::info
実際の消費クレジットが設定した上限を超過した場合でも、超過分のクレジットは請求されません。
:::
