ホワイトボックス診断（都度）
本機能はベータ版です。ご利用を希望される場合は、弊社窓口までお問い合わせください。
概要
Takumi ホワイトボックス診断機能は、GitHub リポジトリの情報を受け取り、ソースコードを直接診断し、診断結果を Web 上でレポートとして出力する機能です。
Shisho Cloud byGMO の Web 画面から利用できます。ホワイトボックス診断（定期）とは異なり、Slack 連携は不要です。
Slack 経由で指 定した期間内のコミット差分を定期的に診断したい場合は、ホワイトボックス診断（定期）をご利用ください。
クレジット消費に関して
利用にはクレジットが必要です。クレジット消費量は、診断対象の特性やサイズに応じて変動します。
大規模なリポジトリ、または多数のリポジトリを診断対象とする場合、実行時間とクレジット消費量が増加するため、あらかじめご留意ください。
クレジット消費量が気になる場合は、後述する「一部だけ診断」モードも活用してください。
診断の開始方法
「診断」（Assessment）タブ内、画面右上の「新規診断」ボタンから、診断が開始できます。
基本設定
- 「診断名」には、この診断を識別するための一意の名前を入力します。
- 「レポート言語」には、診断レポートの言語を選択します（英語または日本語）。
- 「診断対象」は「ソースコード」を選択します。
診断タイプ
診断開始時は、2つのモードからいずれかをお選びいただけます。
- 「全体を診断」を選択すると、診断対象のコードベース全体をスキャンします。多くのクレジットを消費し、完了までに長い時間がかかる場合があります。
- 「一部だけ診断」を選択すると、最初に診断対象のコードベースから「機能」を列挙し、完了すると列挙された機能が表示されます。表示された機能から診断対象を選択して、診断を開始できます。 これにより、所要時間の短縮とクレジット消費の最小化に役立ちます。
ソースコード設定
GitHub リポジトリを1つ以上指定できます。「リポジトリを追加」ボタンから診断対象のリポジトリを追加します。
対象リポジトリのブランチを指定することができます。指定しない場合は、リポジトリのデフォルトブランチが診断対象となります。
大規模なリポジトリ、または多数のリポジトリを診断対象とする場合、実行時間とクレジット消費量が増加するため、あらかじめご留意ください。
クレジット消費量が気になる場合は、「一部だけ診断」モードも活用してください。
ファイルスコープ
診断対象とするファイルパスと除外するファイルパスを指定できます。
スコープを空にすると、コードベース全体が診断対象となります。
各ファイルパスには glob パターン（例：src/auth/**、backend/services/**）を使用できます。
診断範囲
- 「リポジトリ」には、対象となるリポジトリを選択します
- 「機能タイプ」（オプション）には、ヒントになるような機能のカテゴリを指定します（例：
authentication、payments、api） - 「ファイルパス」には、含めるファイルパスを指定します。glob パターンを使用できます
診断対象として指定された場合でも、Takumi の判断によりファイルパスが除外される場合があります。あらかじめご了承ください。
除外設定
指定されたファイルパスは診断対象から除外されます。
- 「リポジトリ」には、対象となるリポジトリを選択します
- 「理由」（オプション）には、これらのパスを除外する理由を記録します（例：「テストコード」「自動生成ファイル」）
- 「ファイルパス」には、除外するファイルパスを指定します。glob パターンを使用できます
想定される診断時間
診断もしくは機能列挙にかかる時間は、コードベースのサイズに応じて変動します。 数十分で完了する場合もありますが、数時間から2日ほどを要する場合もあります。あらかじめご了承ください。
診断結果を確認する
診断レポートは、およそ以下の画面のように、Web 上で閲覧いただけます。
フォーマットは、およそセキュリティベンダに診断を依頼した際のアウトプットに近いものです。
診断結果の各項目では、どの機能を、どのような観点で診断した結果、どのような深刻度・リスクの脆弱性があったか、が説明されています。ホワイトボックス診断のため、脆弱性が検出されたファイルパス等も含まれています。
