メインコンテンツまでスキップ

自動修正

概要​

自動修正機能は、セキュリティ診断で検出された脆弱性に対して、Takumi が自動的に修正のためのパッチを生成し、Pull Request を作成する機能です。修正の流れは次の図のとおりです。

自動修正の流れ

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

前提条件​

自動修正機能を利用するには、修正したいコードが含まれるリポジトリに対するアクセス権限を持つ Write 用の GitHub App を連携させる必要があります。詳細は GitHub 連携 を参照してください。

既に Write 用の GitHub App をインストール済みの場合

本機能のリリースに伴い、GitHub App の「Contents」権限が Read から Read and Write に変更されました。すでに GitHub App をインストール済みの組織については、GitHub から権限更新のリクエストがメールで送信されます。自動修正機能を利用する際には、事前にこのリクエストを承認してください。

使い方​

自動修正機能では、修正対象の脆弱性ごとに「修正タスク」を作成し、そのタスクを単位として自動修正を実施します。タスクを作成すると、自動修正がすぐに始まります。

1. タスクを作成して自動修正を実行する​

タスクの作成方法は次の 2 通りです。

1-A: 診断結果から作成する (推奨)​

診断結果ページで「脆弱性を修正」ボタンを押すと、修正する脆弱性を選ぶダイアログが開きます。修正したい脆弱性にチェックを入れ、「タスク作成に進む」ボタンをクリックしてください。複数の脆弱性を選んだ場合は、脆弱性ごとに 1 件ずつタスクが作成されます。

info

過去に実施した診断結果については、「脆弱性を修正」ボタンが利用できない場合があります。その場合は、「1-B: 自動修正タブから直接作成する」の方法をお試しください。

修正する脆弱性を選択

その後、表示されるタスク作成画面で、以下の情報を入力・確認します。

  • タスク名:脆弱性のタイトルが自動入力される
  • 出力言語:レポートの出力言語 (日本語/英語) を選択する
  • リポジトリ:修正対象のコードが含まれる GitHub リポジトリを選択する
  • ブランチ / タグ / コミット:修正のベースとなるブランチなどを指定する。空欄の場合はデフォルトブランチを使う
  • 修正対象の脆弱性:脆弱性のレポートが自動入力される
  • 追加の指示 (任意):修正の方針など、Takumi に伝えたいことを入力する

入力が終わったら「自動修正を実行」ボタンをクリックしてください。タスクが作成され、自動修正が始まります。

タスク作成画面

1-B: 自動修正タブから直接作成する​

「診断」ページ内の「自動修正」タブを開き、「タスクを作成」ボタンをクリックします。表示されるダイアログで以下の情報を入力し、「自動修正を実行」ボタンをクリックしてください。

  • タスク名:識別しやすい名前を入力する
  • 出力言語:レポートの出力言語 (日本語/英語) を選択する
  • リポジトリ:修正対象の GitHub リポジトリを選択する
  • ブランチ / タグ / コミット:修正のベースとなるブランチなどを指定する
  • 修正対象の脆弱性:修正対象の脆弱性の詳細を、診断レポートからコピーして入力する
  • 追加の指示 (任意):Takumi に伝えたいことを入力する

2. 自動修正の実行中​

タスクを作成すると、タスクのステータスは「実行中」になり、Takumi は以下の処理を自動的に行います。

  • リポジトリのクローン
  • 脆弱性の分析
  • 修正コードの作成
  • 修正内容の正当性を保証するためのユニットテストの作成
  • 修正内容に関するレポートの作成

処理には数分から数十分程度かかる場合があります。

3. 結果の確認​

処理が完了するとタスクのステータスが「レビュー中」に変わります。タスク一覧でタスク名をクリックすると、詳細ダイアログが開きます。

タスク一覧の上部の切り替えで、タスクをステータスで絞り込めます。「要対応」には保留中・レビュー中・失敗、「完了」には完了・クローズ済みのタスクが表示されます。

結果の確認

詳細ダイアログでは、以下の内容を確認できます。

  • 「修正案」:生成された修正内容を確認できる
    • レポート:脆弱性の分析結果と修正内容の説明
    • 差分:生成された修正コードの差分
  • 「修正対象の脆弱性」:入力した脆弱性情報を確認できる
  • 「エラー」:タスクが失敗した場合に、その原因と対処方法を確認できる
tip

修正を複数回実行した場合、バージョンごとに修正案が保存されます。左側のバージョン一覧から任意のバージョンを選択して確認できます。

4. Pull Request の作成​

修正内容を確認し、問題がなければ Pull Request の作成ボタンをクリックします。選択中のバージョンの修正内容で、GitHub リポジトリに Pull Request が自動的に作成されます。

PR 作成後、タスクのステータスは「完了」に変わり、一覧からも PR へのリンクが表示されます。

PR の作成をもって自動修正のタスクは完了となり、Takumi が修正後のコードを自動で検証することはありません。修正が反映されたことを確認するには、脆弱性検証で対象の指摘事項を個別に確認してください。

5. 再実行・クローズ・削除​

タスクのメニューから、以下の操作を行えます。

  • 再実行:「自動修正を再実行」を選択し、「追加の指示」を入力して再度修正を実行する。新しい修正案が生成され、バージョンとして追加される
  • クローズ:「クローズ」を選択し、タスクを終了する。ステータスが「クローズ済み」に変わる
  • 削除:「削除」を選択し、タスクを完全に削除する

再�実行・クローズ・削除

タスクのステータス​

各ステータスの意味は次のとおりです。

ステータス説明
保留中 (Pending)タスクは作成されたが、自動修正の開始に失敗した状態。メニューから実行できる
実行中 (Running)Takumi が修正処理を実行中
レビュー中 (Reviewing)修正が完了し、ユーザーの確認待ち
失敗 (Failed)修正処理中にエラーが発生した (再実行またはクローズ可)
完了 (Completed)Pull Request が作成され、タスクが完了
クローズ済み (Dismissed)ユーザーによりタスクがクローズされた

注意事項​

  • 生成された修正コードは、必ず人間による確認を行ってから本番環境に適用する
  • AI による修正は完璧ではない場合がある。テストの実行やコードレビューを推奨する
  • 大規模なリポジトリや複雑な脆弱性の場合、処理に時間がかかることがある

クレジット消費に関して​

利用にはクレジットが必要です。クレジット消費量は、修正対象の脆弱性の複雑さやリポジトリのサイズに応じて変動します。

おおよその目安として、修正タスク 1 件の実行に対して 1〜10 クレジット程度が消費されます。ただし、実際の消費量は修正対象の規模や、修正案の生成にあたって Takumi が行った調査の量によっても変動するため、上記の範囲に収まらない場合もあります。