For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
メインナビゲーション
Theme

おすすめ

権限

Codex Security

サイバー安全対策

API ダッシュボード
ChatGPT を試す

Codex Security プラグインのクイックスタート

Codex Security プラグインをインストールし、初回の読み取り専用スキャンを実行して、Codex で結果を確認します。

Codex Security プラグインをインストールし、ローカルリポジトリで標準スキャンを実行して、検出事項を確認します。スキャンではソースコードを変更せず、検出の根拠と修正方法をまとめたレポートを保存します。

このページでは、デスクトップアプリまたは Codex CLI で Codex Security プラグインを使う方法を説明します。Codex Cloud で接続済みの GitHub リポジトリをスキャンするには、プラグインマーケットプレイスから別のプラグイン Codex Security Cloud をインストールしてください。詳しくはクラウドのセットアップを参照してください。

プラグインのインストール

  1. ChatGPT デスクトップアプリで Codex を開きます。

  2. プラグインを開いて Codex Security を検索するか、以下のボタンを使います。

    Codex Security プラグインをインストール

  3. プラグインが有効になっていることを確認してから、サイドバーのセキュリティを開きます。

管理対象のワークスペースでプラグインのインストール時に「管理者によって無効化されています」と表示された場合は、ワークスペースのオーナーにプラグインのアクセス設定の確認を依頼してください。 個人アカウントをお使いの場合は、プラグインとアプリのトラブルシューティングを参照してください。

デスクトップアプリのサイドバーにセキュリティが表示されない場合は、Codex が選択され、プラグインが有効になっていることを確認してください。必要に応じてアプリとプラグインを更新し、ワークスペースの管理者がこのプラグインの使用を許可しているか確認してください。

バージョンと更新の確認

時間のかかるスキャンを始める前に、プラグインの変更履歴を確認してください。インストール済みのプラグインは、デスクトップアプリではプラグイン、Codex CLI では /plugins で管理できます。詳しくはプラグインガイドを参照してください。プラグインの更新後は、新しいチャットを開始してスキルとツールを読み込みます。Codex CLI では /new を入力します。

Codex と Codex Security プラグインのバージョンは別々に管理されています。Codex CLI では、次のコマンドでホストとインストール済みプラグインのバージョンを確認できます。

codex --version
codex plugin list --json

installed の一覧から Codex Security を探します。スキャンの開始時にホストとプラグインの両方のバージョンを記録しておくと、障害を報告する際に記載できます。

スタンドアロンの @openai/codex-security パッケージには、専用のプラグインが同梱されています。このパッケージを更新しても、Codex で使用するマーケットプレイスのプラグインは更新されません。パッケージのインストール方法とバージョンの確認方法は、CLI クイックスタートを参照してください。

Amazon Bedrock を使用する場合は、Codex の Amazon Bedrock ガイドに従って Codex ホストを設定してください。スタンドアロンパッケージでは、別途 Security CLI のプロバイダー設定を使用します。

初回スキャンの実行

スキャンの品質を最大限に高めるには、gpt-5.6-sol を使用し、推論強度を xhigh に設定してください。

新しいセキュリティスキャンを開始する前に、リポジトリを選択してスキャンを設定します。

  1. スキャン設定画面の表示

    サイドバーでセキュリティを選択し、スキャンを開いて、+ スキャンを選択します。

  2. コードベースとスキャン範囲の選択

    既存のリポジトリを選択するか、別のフォルダーを指定します。コードベースを選択し、ディープスキャンはオフのまま、リポジトリ全体または 1 つのフォルダーを選択します。ブランチとリビジョンが、スキャンしたいコードを指していることを確認します。

  3. セキュリティコンテキストの追加

    モデルと推論強度を選択します。レビューで考慮すべき攻撃経路、セキュリティ上注意が必要な箇所、リポジトリ固有の情報を伝える必要がある場合にのみ、追加のコンテキストを開きます。

    追加のコンテキストを有効にすると、攻撃経路、重点的に確認する箇所、関連するセキュリティ上の指針を記入できます。

  4. スキャンの開始

    スキャンを開始を選択し、セキュリティワークベンチで各段階の進行状況を確認します。アクティビティを表示を選択すると、スキャンを実行している Codex タスクを確認できます。

  5. 結果の確認

    完了したスキャンを開き、検出事項、レビューした範囲、生成されたレポートファイルを確認します。検出事項では複数のスキャンで見つかった問題をまとめて確認できます。リポジトリではリポジトリごとのスキャン履歴を確認できます。

    セキュリティワークベンチでスキャン結果、検出事項、レビューした範囲を確認します。

結果の読み方

まず、スキャン対象とリビジョンを確認します。次に、どの範囲がレビューされ、どの範囲が見送られたかを確認します。スキャンが完了しても、レビューが及んでいない箇所が残る場合があります。検出事項がなくても、脆弱性が一切ないとは断定できません。

検出事項を開き、根拠となるソースコード、攻撃が成立するための前提条件、検証内容、まだ確かめられていない点を確認します。再現用コードを実行せず、ソースコードの分析で検証する場合もあります。記録された検証方法と根拠をもとに、その問題がご自身のシステムにも当てはまるかを判断してください。

スキャンの出力

デスクトップアプリでは、完了したスキャンはスキャンに保存されます。Codex CLI では、チャットに表示されたスキャンディレクトリを開きます。結果をレポート形式で読むには、report.md を開いてください。必要に応じて、findings/ に脆弱性の詳細レポートを、hardening/ にセキュリティを強化するための設計案を出力するよう依頼できます。

このディレクトリには、ツールや自動化で使用する scan-manifest.json、findings.json、coverage.json も含まれます。結果を共有またはアーカイブするときは、レポート内のリンクが引き続き機能するよう、ディレクトリごと扱ってください。

次のワークフローの選択

その他のスキャンモードやワークフローについては、Codex Security の概要に戻って確認してください。