{"meta":{"title":"コードスキャンアラートを解決する","intro":"セキュリティビューでは、プロジェクトのコード内の潜在的な脆弱性やエラーに関するアラートを表示、修正、または無視できます。","product":"セキュリティとコードの品質","breadcrumbs":[{"href":"/ja/code-security","title":"セキュリティとコードの品質"},{"href":"/ja/code-security/how-tos","title":"やり方"},{"href":"/ja/code-security/how-tos/manage-security-alerts","title":"セキュリティアラートの管理"},{"href":"/ja/code-security/how-tos/manage-security-alerts/manage-code-scanning-alerts","title":"コードスキャンのアラート"},{"href":"/ja/code-security/how-tos/manage-security-alerts/manage-code-scanning-alerts/resolving-code-scanning-alerts","title":"アラートを解決する"}],"documentType":"article"},"body":"# コードスキャンアラートを解決する\n\nセキュリティビューでは、プロジェクトのコード内の潜在的な脆弱性やエラーに関するアラートを表示、修正、または無視できます。\n\n##\n\n```\n code scanningアラートの修正候補の生成\n\n GitHub Copilotの自動修正機能では、 code scanning 分析によって識別されたアラートの修正プログラムを生成できます。ほとんどの CodeQL アラートの種類がサポートされています。「[AUTOTITLE](/code-security/concepts/code-scanning/copilot-autofix-for-code-scanning)」を参照してください。\n```\n\n> \\[!NOTE]\n> GitHub Copilot の使用には、GitHub Copilotの自動修正機能のサブスクリプションは不要です。 Copilot の自動修正は、GitHub.com のすべてのパブリックリポジトリだけでなく、GitHub Code Security のライセンスを持つ organization や Enterprise が所有する内部またはプライベートリポジトリでも使用できます。\n\n1. GitHub で、リポジトリのメインページに移動します。\n2. リポジトリ名の下にある \\[ ** Security and quality** ] タブをクリックします。\\[ Security and quality] タブが表示されない場合は、 **** ドロップダウンメニューを選択し、\\[ ** Security and quality**] をクリックします。\n3. 左側のサイドバーで、** \\[Code scanning]** をクリックします。\n4. アラートの名前をクリックします。\n5. 修正をCopilot の自動修正提案できる場合は、ページの上部にある \\[**修正プログラムの生成**] をクリックします。\n6. 修正候補が生成されたら、ページの下部にある **\\[修正プログラムを含む PR を作成]** をクリックして修正ピログラムを含むプルリクエストを自動的に生成できます。\n 既定のブランチから新しいブランチが作成され、生成された修正プログラムがコミットされ、ドラフトのプルリクエストが作成されます。その他の修正プログラムと同様に、提供産された修正プログラムはテスト、編集できます。\n\n履歴アラートエンドポイントで Autofix API を使用すると、提案された修正プログラムを生成、取得、コミットすることもできます。\n\n* [コードスキャンアラートの自動修正を作成する](/ja/rest/code-scanning/code-scanning#create-an-autofix-for-a-code-scanning-alert)\n* [コードスキャンアラートの自動修正の状態を取得する](/ja/rest/code-scanning/code-scanning#get-the-status-of-an-autofix-for-a-code-scanning-alert)\n* [コードスキャンアラートの自動修正をコミットする](/ja/rest/code-scanning/code-scanning#commit-an-autofix-for-a-code-scanning-alert)\n\n ```\n Copilot の自動修正\n code scanningアラートでは、あらゆる状況のすべてのアラートに対して修正プログラムを生成することはできません。この機能はベストエフォートベースで動作し、常に成功する保証はありません。自動的に生成されるフィックスの制限については、「[提案の制限事項](/code-security/code-scanning/managing-code-scanning-alerts/about-autofix-for-codeql-code-scanning#limitations-of-suggestions)」を参照してください。\n ```\n\n##\n\n```\n Copilot クラウドエージェントへのアラートの割り当て\n```\n\n> \\[!NOTE] このオプションは現在パブリックプレビュー段階であり、変更される可能性があります。\n> Copilot クラウドエージェントはリポジトリで使用できる必要があります。\n\n```\n Copilotを割り当てて自動修正を適用できます。 \n Copilot は、コードスキャンアラートを分析し、修復計画を作成し、必要なコード変更をプル要求に実装します。\n```\n\n1. GitHub で、リポジトリのメインページに移動します。\n2. リポジトリ名の下にある \\[ ** Security and quality** ] タブをクリックします。\\[ Security and quality] タブが表示されない場合は、 **** ドロップダウンメニューを選択し、\\[ ** Security and quality**] をクリックします。\n3. 左側のサイドバーで、** \\[Code scanning]** をクリックします。\n4. アラートの名前をクリックします。\n5. 自動修正が生成されておらず、修正プログラムCopilot の自動修正提案できる場合は、ページの上部にある \\[修正プログラムの**生成] ** クリックします。\n6. 右側のメニューで、\\[ **担当者**] をクリックします。\n7. \\[Copilot] を選択します。\n\n30 秒以内に、 Copilot はアラートに対処するためのプル要求を開き、修正の概要と加えられた変更の詳細が含まれます。作成されると、pull request が \\[開発] セクションに表示されます。\n\n## アラート手動で修正する\n\nリポジトリへの書き込み権限があるユーザなら誰でも、コードに修正をコミットしてアラートを解決できます。リポジトリがプルリクエストに対して実行されるようにスケジュールcode scanningされている場合は、あなたの修正を反映したプルリクエストを提出することをお勧めします。これにより、変更の code scanning 分析がトリガーされ、修正によって新しい問題が発生しないことをテストできます。詳しくは、「[Pull RequestでCode scanningアラートをトリアージする](/ja/code-security/code-scanning/managing-code-scanning-alerts/triaging-code-scanning-alerts-in-pull-requests)」をご覧ください。\n\n```\n GitHubを離れることなくチームのワークフローで修復作業を追跡するには、アラートを問題にリンクできます。「[AUTOTITLE](/code-security/how-tos/manage-security-alerts/manage-code-scanning-alerts/linking-code-scanning-alerts-to-github-issues)」を参照してください。\n```\n\n自由テキスト検索またはフィルターを使ってアラートの一部を表示し、一致するすべてのアラートをクローズ済みとマークすることができます。\n\nあるブランチでは解決されたアラートが、別のブランチでは解決されていないことがあります。アラートの概要で \"\\[ブランチ]\" フィルターを使用すると、特定のブランチでアラートが修正されているかどうかを確認できます。\n\n![ブランチオプションが展開されたアラートビューのスクリーンショット。 \\[ブランチ\\] フィルターに濃いオレンジ色の下線が表示されます。](/assets/images/help/repository/code-scanning-branch-filter.png)\n\n既定ではないブランチでフィルター処理したのと同じアラートが、既定のブランチに存在する場合、そのアラートのアラートページには、その状態が既定ではないブランチでの状態と競合する場合でも、既定のブランチのアラートの状態のみが反映されることに注意してください。たとえば、アラートの概要の `branch-x` の \\[Open]\\(オープン) リストに表示されるアラートは、そのアラートが既定のブランチで既に修正されている場合、アラートページに \"Fixed\"(修正済み) の状態で表示される場合があります。フィルター処理したブランチのアラートの状態は、アラートページの右側の **\\[Affected branches]\\(影響を受けるブランチ)** セクションで確認できます。\n\n> \\[!NOTE]\n> 複数の構成を使用して code scanning を実行すると、複数の構成によって同じアラートが生成されることがあります。すべての構成を定期的に実行する場合を除いて、ある構成では解決されており、別の構成では解決されていないアラートが表示される可能性があります。これらの古い構成とアラートは、ブランチから削除できます。詳細については、[「ブランチから以前の構成とアラートを削除する」](#removing-stale-configurations-and-alerts-from-a-branch)を参照してください。\n\n## アラートを無視する\n\nアラートをクローズする方法は2つあります。コード中の問題を修正するか、アラートを却下できます。\n\nアラートを無視することは、修正する必要がないと思われるアラートを閉じる方法です。\nたとえば、テストで使われるだけのコードのエラーや、エラーを修正するための労力がコードを改善することによる潜在的な利点よりも大きい場合です。アラートは、コード内の code scanning 注釈から、または \\[ ** Security and quality** ] タブ内の概要リストから無視できます。\n\nアラートを却下すると:\n\n* それはすべてのブランチで却下されます。\n* アラートはプロジェクトの現在のアラート数から除外されます。\n* アラートはアラートのサマリの\"Closed\"リストに移動されます。必要な場合は、そこからアラートを再オープンできます。\n* アラートを閉じた理由がログに記録されます。\n* 必要に応じて、無視した理由をコメントに残し、アラートを無視したコンテキストを記録することもできます。\n* 次回 code scanning 実行しても、同じコードでアラートは生成されません。\n\nアラートを無視する:\n\n1. GitHub で、リポジトリのメインページに移動します。\n2. リポジトリ名の下にある \\[ ** Security and quality** ] タブをクリックします。\\[ Security and quality] タブが表示されない場合は、 **** ドロップダウンメニューを選択し、\\[ ** Security and quality**] をクリックします。\n3. 左側のサイドバーで、** \\[Code scanning]** をクリックします。\n4. アラートを却下したい場合、そのアラートをまず調べて、却下する正しい理由を選択できるようにすることが重要です。調べたいアラートをクリックしてください。\n5. アラートを確認してから **[Dismiss alert](アラートの却下)** をクリックし、アラートをクローズする理由を選ぶか入力します。\n\n ```\n ![アラートチェックエラーのスクリーンショット。 [アラートを無視] ボタンが、濃いオレンジ色で強調表示され、[閉じる] ドロップダウンが表示されます。 ](/assets/images/help/repository/code-scanning-alert-dropdown-reason.png)\n ```\n\nクエリが将来の分析に含まれ続けるかに影響することがあるので、ドロップダウンメニューから適切な理由を選択することは重要です。必要に応じて、却下についてコメントを残し、アラートを却下したコンテキストを記録することもできます。無視のコメントはアラートタイムラインに追加され、監査と報告の間に正当な理由として使用できます。コードスキャン REST API を使用して、コメントを取得または設定できます。コメントは、`dismissed_comment` エンドポイントの `alerts/{alert_number}` に含まれます。詳しくは、「[コードスキャン用の REST API エンドポイント](/ja/rest/code-scanning/code-scanning#update-a-code-scanning-alert)」をご覧ください。\n\nたとえばコードがサポートされていないサニタイズライブラリを使っているといった理由で、CodeQL のアラートを擬陽性の結果として却下する場合、CodeQL に貢献して分析を改善することを検討してください。 CodeQL の詳細については、「[CodeQL に貢献する](https://github.com/github/codeql/blob/main/CONTRIBUTING.md)」を参照してください。\n\n### 複数のアラートを一度に却下する\n\n同じ理由で却下したい複数のアラートがプロジェクトにあるなら、アラートのサマリからそれらをまとめて却下できます。通常は、リストをフィルタしてマッチするアラートをすべて却下することになるでしょう。たとえば、プロジェクト中で特定の共通脆弱性タイプ (CWE)の脆弱性がタグ付けされた現在のアラートをすべて却下したいことがあるでしょう。\n\n## 無視されたアラートを再び開く\n\nアラートを無視した後、アラートを修正する必要があることがわかった場合は、アラートを再度開いて、コードで問題を修正できます。閉じたアラートの一覧を表示し、アラートを検索して表示し、再度開きます。その後、他のアラートと同じ方法でアラートを修正します。\n\n## ブランチから古い構成とアラートを削除する\n\n1 つのリポジトリに複数のコードスキャン構成が含まれる場合があります。実行すると、複数の構成で同じアラートが生成されることがあります。さらに、構成を異なるスケジュールで実行した場合、頻度の低い構成または古い構成ではアラートの状態が古くなる可能性があります。複数構成からのアラートの詳細については、[「AUTOTITLE」](/ja/code-security/code-scanning/managing-code-scanning-alerts/about-code-scanning-alerts#about-alerts-from-multiple-configurations)を参照してください。\n\n1. GitHub で、リポジトリのメインページに移動します。\n\n2. リポジトリ名の下にある \\[ ** Security and quality** ] タブをクリックします。\\[ Security and quality] タブが表示されない場合は、 **** ドロップダウンメニューを選択し、\\[ ** Security and quality**] をクリックします。\n\n3. 左側のサイドバーで、** \\[Code scanning]** をクリックします。\n\n4. \\[Code scanning] でcode scanningアラートをクリックします。\n\n5. サイドバーの \\[影響を受けるブランチ] セクションで、目的のブランチをクリックします。\n\n6. \\[構成の分析] ダイアログで、選択したブランチでこのアラートを報告した構成の詳細を確認します。目的のブランチの不要な構成を削除するには、\\[ ] をクリックします。\n\n 誤って構成を削除した場合は、 **\\[キャンセル]** をクリックして変更を適用しないようにします。\n\n ![\\[構成の分析\\] モーダルのスクリーンショット。 \\[構成の削除\\] アイコンが濃いオレンジ色で囲まれています。](/assets/images/help/repository/code-scanning-remove-configuration.png)\n\n7. 不要な構成を削除し、期待される構成が表示されていることを確認したら、 **\\[変更の保存]** をクリックします。\n\n 誤って構成を削除した後で変更を保存した場合は、構成をもう一度実行してアラートを更新します。\n GitHub Actionsを使用する構成の再実行の詳細については、[ワークフローとジョブの再実行](/ja/actions/managing-workflow-runs/re-running-workflows-and-jobs#re-running-all-the-jobs-in-a-workflow) を参照してください。\n\n> \\[!NOTE]\n>\n> * リポジトリの既定のブランチのすべての code scanning 構成を削除した場合、既定のブランチは \"影響を受けるブランチ\" サイドバーに残りますが、どの構成でも分析されません。\n> * リポジトリの既定のブランチ以外のブランチのすべての code scanning 構成を削除すると、そのブランチは \"影響を受けるブランチ\" サイドバーから削除されます。\n\n## 詳細については、次を参照してください。\n\n* [Pull RequestでCode scanningアラートをトリアージする](/ja/code-security/code-scanning/managing-code-scanning-alerts/triaging-code-scanning-alerts-in-pull-requests)\n* [コードスキャンの既定セットアップの構成](/ja/code-security/code-scanning/enabling-code-scanning/configuring-default-setup-for-code-scanning)\n* [Code scanningとのインテグレーションについて](/ja/code-security/code-scanning/integrating-with-code-scanning/about-integration-with-code-scanning)"}