# CodeQL を使用したコード スキャン

CodeQLを使用して、コード内の脆弱性とエラーを特定できます。 結果は、code scanningのGitHubアラートとして表示されます。

CodeQL は、セキュリティ チェックを自動化するために GitHub が開発した、コード分析エンジンです。 CodeQL を使用してコードを分析し、結果を code scanning アラートとして表示することができます。

CodeQLにcode scanning分析を使用するには、主に次の 3 つの方法があります。

* 既定のセットアップを使用して、リポジトリ上のCodeQLのcode scanning分析をすばやく構成します。 既定の設定では、分析する言語、実行するクエリ スイート、スキャンをトリガーするイベントが自動的に選択されます。 必要に応じて、実行するクエリ スイートと分析する言語を手動で選択できます。
  CodeQLを有効にすると、GitHub Actionsはワークフロー実行を実行してコードをスキャンします。 詳細については、「[コード スキャンの既定セットアップの構成](/ja/code-security/how-tos/find-and-fix-code-vulnerabilities/configure-code-scanning/configure-code-scanning)」を参照してください。

* 高度なセットアップを使用して、 CodeQL ワークフローをリポジトリに追加します。 これにより、 [github/codeql-action](https://github.com/github/codeql-action/) を使用して CodeQL CLIを実行するカスタマイズ可能なワークフロー ファイルが生成されます。 詳細については、「[コード スキャンの詳細設定を構成する](/ja/code-security/how-tos/find-and-fix-code-vulnerabilities/configure-code-scanning/configuring-advanced-setup-for-code-scanning#configuring-advanced-setup-for-code-scanning-with-codeql)」を参照してください。

* 外部 CI システムで CodeQL CLI を直接実行し、結果を GitHubにアップロードします。 詳細については、「[既存の CI システムでコード スキャンを使用する](/ja/code-security/how-tos/find-and-fix-code-vulnerabilities/integrate-with-existing-tools/use-with-existing-ci-system)」を参照してください。

code scanningアラートの詳細については、「[コード スキャンのアラート](/ja/code-security/concepts/code-scanning/code-scanning-alerts)」を参照してください。

## CodeQL の概要

CodeQL は、コードをデータのように扱うプログラミング言語および関連ツールです。 これは、コードの分析を容易にし、従来の静的アナライザーよりも信頼度の高いコード内の潜在的な脆弱性を見つけられるように、明示的に作成されました。

1. コードベースを表す CodeQL データベースを生成します。
2. 次に、そのデータベース CodeQL クエリを実行して、コードベースの問題を特定します。
3. code scanningでGitHubを使用すると、クエリ結果はCodeQLのcode scanningアラートとして表示されます。

CodeQL はコンパイル済み言語と解釈言語の両方をサポートし、サポートされている言語で記述されたコードで脆弱性やエラーを見つけることができます。

CodeQL では、次の言語がサポートされています。

<!-- If you update the list of supported languages for CodeQL, update docs-internal/content/get-started/learning-about-github/github-language-support.md to reflect the changes. -->

* C/C++
* C#
* Go
* Java/Kotlin
* JavaScript/TypeScript
* Python
* Ruby
* Rust
* Swift \* GitHub Actions ワークフロー

> \[!NOTE]
>
> * Java、Kotlin、またはその両方で記述されたコードを分析するには `java-kotlin` を使用します。
> * JavaScript、TypeScript、またはその両方で記述されたコードを分析するには `javascript-typescript` を使用します。

詳細については、CodeQL Web サイトのドキュメント「[サポートされている言語とフレームワーク](https://codeql.github.com/docs/codeql-overview/supported-languages-and-frameworks/)」を参照してください。

> \[!IMPORTANT]
> CodeQL では、上記に記載されていない言語はサポート **されていません** 。 これには、**PHP**、**Scala** などが含まれますが、これらに限定されません。 サポートされていない言語で CodeQL を使用しようとすると、アラートが生成されず、分析が不完全になる可能性があります。

## カスタム フレームワークまたはニッチ フレームワークをモデル化する

GitHub エキスパート、セキュリティ研究者、コミュニティ共同作成者は、一般的なフレームワークやライブラリのデータ フローをモデル化するためのライブラリを作成します。 モデル化されていないカスタム依存関係を使用する場合は、CodeQLのVisual Studio Code拡張機能を使用して、これらの依存関係のモデルを作成し、それらを使用して分析を拡張できます。 詳細については、「[CodeQL モデル エディターの使用](/ja/code-security/how-tos/find-and-fix-code-vulnerabilities/scan-from-vs-code/use-the-model-editor)」を参照してください。

## CodeQL クエリ

GitHubエキスパート、セキュリティ研究者、コミュニティ共同作成者は、CodeQLに使用される既定のcode scanning クエリを作成し、維持します。 クエリは、分析を改善し、誤検知の結果を減らすために定期的に更新されます。

### 独自のクエリを記述する

クエリはオープンソースであるため、[github/codeql](https://github.com/github/codeql) リポジトリ内のクエリを表示したり投稿したりできます。 詳細については、CodeQLドキュメントの[](https://codeql.github.com/docs/writing-codeql-queries/about-codeql-queries/)」を参照してください。

### 追加のクエリを実行する

詳細設定または外部 CI システムを使用してコードをスキャンする場合は、分析の一環として追加のクエリを実行できます。

これらのクエリは、パブリッシュされた CodeQL クエリ パックまたはリポジトリ内の CodeQL パックに属している必要があります。

* CodeQL クエリ パックがGitHubContainer registryに発行されると、クエリとコンパイル キャッシュに必要なすべての推移的な依存関係がパッケージに含まれます。 これにより、パフォーマンスが向上します。そして、パックまたは CLI の新しいバージョンにアップグレードするまでは、パックでクエリを実行するたびに確実に同じ結果が得られます。

* CodeQL クエリ パックは、複数の GitHub コンテナー レジストリからダウンロードできます。 詳細については、「[コード スキャンのワークフロー構成オプション](/ja/code-security/reference/code-scanning/workflow-configuration-options#downloading-codeql-packs-from-github-enterprise-server)」を参照してください。

詳細については、「[CodeQL パックを使った分析のカスタマイズ](/ja/code-security/tutorials/customize-code-scanning/customize-analysis)」を参照してください。