Codex Security プラグイン クイックスタート
Codex Security プラグイン クイックスタート
Codex Security プラグイン をインストールし、最初の読み取り専用スキャンを実行して、Codex で結果を確認します。
- ChatGPT デスクトップアプリ デスクトップでプロジェクト、ファイル、長時間のタスクを扱います。
- Codex CLI ターミナルで Codex を利用します。
Codex Security プラグインをインストールし、ローカルリポジトリの標準スキャンを実行して、検出事項を確認します。スキャンではソースは変更されず、証拠と修正のガイダンスを含むレポートが保存されます。
プラグインをインストールする
ChatGPT デスクトップアプリで Codex を開きます。
プラグイン を開いて Codex Security を検索するか、以下のボタンを使用します。
プラグインが有効になっていることを確認し、サイドバーの セキュリティ を開きます。
- ターミナルで、評価するリポジトリに移動して Codex を起動します。
codex/pluginsを入力し、Codex Security を検索して、プラグインをインストール を選択します。/newを入力して、リポジトリの新しいチャットを開始します。
最初のスキャンを実行する
最良のスキャン品質を得るには、gpt-5.6-sol を
xhigh の推論強度で使用してください。
スキャン設定を開く
サイドバーで Security を選択し、Scans を開いて + Scan を選択します。
コードベースとスキャン範囲を選択する
既存のリポジトリを選択するか、別のフォルダーを使用します。コードベース を選択し、 ディープスキャン はオフのままにして、リポジトリ全体または 1 つのフォルダーを選択します。ブランチとリビジョンが、スキャンする予定のコードを指していることを確認します。
セキュリティに関するコンテキストを追加する
モデルと推論の強度を選択します。攻撃経路、セキュリティ上重要な領域、またはレビューの指針となるリポジトリの詳細を説明する必要がある場合にのみ、 追加コンテキスト を開きます。
追加コンテキストをオンにして、攻撃経路、重点領域、関連するセキュリティガイダンスを記述します。 スキャンを開始する
スキャンを開始 を選択し、セキュリティワークベンチでスキャンの各段階を確認します。 アクティビティを表示 を選択すると、スキャンを実行する Codex タスクを確認できます。
結果を確認する
完了したスキャンを開き、検出事項、カバレッジ、利用可能なレポート成果物を確認します。検出事項 では複数のスキャンにわたる問題を確認でき、リポジトリ ではリポジトリのスキャン履歴を確認できます。
セキュリティワークベンチでスキャン結果、検出事項、カバレッジを確認します。
標準スキャンを依頼する
新しいチャットで次のプロンプトを送信します。
Run a Codex Security scan on this repository.スキャンの完了を待つ
Codex は設定用のワークスペースを開かずに、ターミナルでスキャンを実行します。 Codex が完了を報告するまで、タスクの実行を継続してください。Codex が設定上の制限を特定した場合は、その制限と提案された変更の具体的な内容を確認してから、設定の更新を承認してください。
結果を確認する
ターミナルで概要を確認してから、生成された
report.mdを開いて結果の全体を確認します。
結果を解釈する
まず対象とリビジョンを確認します。次に、レビューされた領域と保留された領域を確認します。完了したスキャンでも、カバレッジに不足がある場合があります。検出事項が報告されないレビューでも、すべての脆弱性が否定されたとは限りません。
検出事項を開き、根拠となるソースの証拠、攻撃者側の前提条件、検証内容、残っている不確実性を確認します。検証では、再現コードを実行せずにソース分析を使用する場合があります。記録された方法と証拠に基づいて、その問題が自分のシステムに該当するかを判断してください。
スキャンによって作成されるもの
デスクトップアプリでは、完了したスキャンは スキャン に保存されます。Codex CLI では、会話内で報告されたスキャンディレクトリを使用します。読みやすい形式の結果は report.md を開いて確認できます。findings/ 内の詳細な脆弱性レポートと、
hardening/ 内の設計案は、必要に応じてリクエストできる任意の出力です。
このディレクトリには、ツールや自動化向けの scan-manifest.json、findings.json、
coverage.json も含まれます。結果を共有またはアーカイブする際は、レポート内のリンクが引き続き機能するよう、ディレクトリの内容をまとめて保持してください。
次のワークフローを選択する
- 次のスキャンに向けてスコープとセキュリティコンテキストを設定するか、 コード変更をレビューします。
- 証拠を妥当と判断したら、検出事項を修正して検証するか、 Issue で追跡します。
その他のスキャンモードやワークフローについては、Codex Security の概要に戻ってください。