OpenAIがCodex Securityをオープンソース化
OpenAI just open-sourced Codex Security (github.com)
要約
OpenAIは、コードのセキュリティ問題を検出、検証、レビューするためのオープンソースCLIおよびTypeScript SDKであるCodex Securityを公開しました。このツールはNode.jsとPythonを必要とし、ユーザーはOpenAIアカウントまたはAPIキーで認証する必要があります。リポジトリの所有権やスキャン許可の確認、様々なスキャンオプション、エクスポート形式、プリコミットフックなどの機能を提供します。
全文翻訳
Codex Security
Codex Securityは、コード内の脆弱性を発見、調査、修正するのに役立ちます。Codexでのセキュリティワークフローを使用するか、@openai/codex-security CLIおよびTypeScript SDKで自動化してください。
- Codex内: セキュリティワークフローを選択。
- ターミナル内: CLIをインストールしてリポジトリをスキャン。
- 自動化: TypeScript SDKまたはGitHub Actionを使用します。
機能
- リポジトリ、選択したパス、またはGitの変更をスキャンします。ディープスキャンは、リポジトリおよび選択したパスで並列ディスカバリーワーカーを実行します。
- 候補となる発見事項を検証し、パッチを生成し、既存の修正を確認します。
SECURITY.mdポリシーのドラフトを作成し、脅威モデルを後でレビューするために保存します。- 保存されたスキャンと発見事項を閲覧し、重複を特定し、独自のルーブリックに対して重大度を評価し、ソースとGit履歴から担当者を提案します。
- GitHubのコードスキャンアラートをインポートし、SARIF、JSON、またはCSVをエクスポートし、Linearまたは発見サービスに発見事項を公開します。
- CIやコンテナ内を含む、リポジトリまたはプロジェクトコンポーネント全体でスキャンを自動化します。
Codexでの使用
Codex Securityプラグインを有効にしたCodexセッションでリポジトリを開き、次のように質問します。
このリポジトリでCodex Securityスキャンを実行し、認証と認可に焦点を当ててください。保存されたレポート、ソース証拠、およびカバレッジ制限を返してください。
完了したスキャンは、レポート、発見事項、カバレッジ、および利用可能な場合は脅威モデルを保存します。これらの結果を使用して、発見事項を調査したり、パッチをリクエストしたり、既存の修正を確認したりできます。プラグインの設定、タスクの選択、および必要なツールが利用できない場合のリカバリについては、エージェントワークフローガイドを参照してください。
クイックスタート
Node.js 22.13.0+ (22.x内)、またはNode.js 24.xまたは26.x、およびPython 3.10+が必要です。Python 3.10にはtomliも必要です。
CLIをグローバルにインストールしてサインインします。
npm install --global @openai/codex-security
cs login
csはcodex-securityの短いエイリアスです。どちらのコマンドも同じCLIを実行します。インストールにより、npmのグローバル実行可能ディレクトリに両方のコマンドが作成されます。これはPATHに含まれている必要があります。csが既に別のツールに解決される場合は、代わりにcodex-securityを使用してください。npmがcsのEEXISTエラーで停止した場合は、グローバルインストールなしでnpx @openai/codex-securityを使用してください。
リポジトリディレクトリからスキャンを実行します。
cs scan .
Daybreak Blueへのアクセスがある場合は、スキャンコマンドに--cyber-access-program daybreak_blueを追加します。それ以外の場合は、フラグを省略するか、--cyber-access-program standardを使用します。
CodexのDaybreakトグルを使用するには、--codex daybreak=trueを渡します。デフォルトではオフになっており、互換性のあるアクセスが必要です。SDKおよびプラグインの使用(ディープスキャンワーカーを含む)については、Daybreak設定を参照してください。
スキャンは既存のSECURITY.mdのガイダンスを使用します。定義または更新するには、オプションでポリシーをドラフトします。
cs policy .
ドラフトはリポジトリの外に保存されます。差分とメモを確認し、ドラフトを編集してから、SECURITY.mdのみをPolicy targetにコピーします。ポリシーを生成せずにスキャンできます。
グローバルインストールなしで実行するには、これらの例のcsをnpx @openai/codex-securityに置き換えてください。例:
npx @openai/codex-security scan .
CIの場合、スキャンプロセスの環境でOPENAI_API_KEYまたはCODEX_API_KEYを設定します。リモートまたはヘッドレスマシンでは、ワークスペースが許可する場合はlogin --device-authを使用するか、SSH経由でサインインしてください。
一部のサイバーセキュリティリクエストおよび保護された発見事項には、Trusted Access for Cyberの承認が必要です。
スキャンオプション
スコープとスキャンモードを選択します。
# 選択したパスをスキャンします。
cs scan . --path src --path tests
# ベースリビジョンからHEADまでのコミットされた変更をスキャンします。
cs scan . --diff origin/main
# リポジトリのディープスキャンを実行します。
cs scan . --mode deep
cs scan . --max-time 15を使用して、標準調査の推奨15分間を使用します。タイミングのセマンティクスとディープスキャンの制限については、調査時間を参照してください。
コマンド、またはcs scan --helpでスキャンオプション、コスト制限、スキャン後のパッチ適用について参照するには、cs --helpを使用します。
リポジトリ全体に広がるアプリケーションについては、リポジトリを横断したシステムレビューを参照してください。独立したリポジトリレビューを1つの再開可能なキャンペーンで実行するには、バルクスキャンを使用します。
スキャン後、スコープとフォローアップ作業を検査して、記録された除外事項を理解し、発見事項のレビュー、フォーカススキャンの実行、または中断された実行のリカバリを決定します。
TypeScript SDK
TypeScriptプロジェクトにパッケージをローカルにインストールします。
npm install @openai/codex-security
次にインポートします。
import { CodexSecurity } from "@openai/codex-security";
const security = new CodexSecurity();
try {
const result = await security.run("/path/to/repository");
console.log(result.reportPath);
} finally {
await security.close();
}
SDKガイドには、ディープスキャン設定、検証、重大度分類、担当者提案、および結果処理が含まれています。
既存のCloud発見事項の読み取り
Codex Security Cloudがアカウントで利用可能な場合、Securityプラグインの$cloud-findingsスキルは、CodexデスクトップまたはCodex CLIで発見事項、レポート、記録された割り当てと検証、およびスキャンステータスを読み取ることができます。Cloudはオプションの接続です。ローカルスキャンはそれなしでも機能します。
Cloud接続設定とCLI読み取りで、認証要件と読み取り専用の例を参照してください。
SECURITY.mdの生成
policyを使用して、新しいSECURITY.mdをドラフトするか、既存のものを更新します。--pathを使用してコンポーネントを選択します。
cs policy .
cs policy . --path services/api --knowledge-base architecture.md
コマンドはドラフトをリポジトリの外に保存し、既存のファイルは変更しません。差分とメモを確認し、ドラフトを編集してから、SECURITY.mdのみを表示されたPolicy targetにコピーします。保存されたアーキテクチャと脅威モデルのドキュメントはリポジトリの外に保管してください。
スキャンは既にルートおよびコンポーネントのSECURITY.mdファイルを使用しています。ポリシーに変更が必要ない場合は、現在のポリシーを保持してください。更新する場合は、脆弱性報告の手順を維持してください。コマンドがポリシーが既に最新であると表示した場合、コピーは不要です。
.github/SECURITY.mdまたはdocs/SECURITY.mdにあるファイルには、多くの場合、報告手順が含まれています。ポリシーをドラフトする際にそれらを保持してください。これらの場所はリポジトリ全体のスキャンガイダンスを自動的に提供しません。ポリシーガイドで、ポリシーの場所、未回答の質問、保存された成果物、およびSDKの使用方法を参照してください。
脅威モデルの保存とエクスポート
スキャンとポリシー生成は、結果とともに脅威モデルを保存します。別の分析を開始せずに保存されたモデルをエクスポートします。
cs export --scan SCAN_ID --artifact threat-model --output threatmodel.md
現在のリポジトリの最新のスキャン結果を使用するには、--scanを省略します。エクスポートガイドでは、発見事項、CI用のSARIF出力、およびオフラインTypeScript APIについても説明しています。
GitHub Actions
GitHub Actionを使用して、スケジュール済み、手動、またはプルリクエストのスキャンを実行します。週次のリポジトリスキャンの場合、OpenAI APIキーをリポジトリシークレットCODEX_SECURITY_API_KEYとして追加し、このワークフローを.github/workflows/codex-security.ymlに保存します。REPLACE_WITH_REVIEWED_COMMITをActionコミットの完全なSHAに置き換えてください。
このワークフローはDaybreak Blueを要求します。Blueが有効になっているプロジェクトのAPIキーを使用してください。Daybreakアクセスがない場合は、cyber-access-programを省略するか、standardに設定してください。
name: Codex Security
on:
workflow_dispatch:
schedule:
- cron: "23 7 * * 1" # Mondays at 07:23 UTC
permissions:
contents: read
jobs:
security:
runs-on: ubuntu-24.04
steps:
# Configure Bubblewrap and AppArmor so Codex Security can run safely in its sandbox.
- name: Set up the Ubuntu sandbox
run: |
sudo apt-get update
sudo apt-get install --yes bubblewrap apparmor-profiles
sudo apparmor_parser -r /usr/share/apparmor/extra-profiles/bwrap-userns-restrict
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
persist-credentials: false
- uses: openai/codex-security@REPLACE_WITH_REVIEWED_COMMIT
with:
model: gpt-5.6-sol
effort: high
cyber-access-program: daybreak_blue
env:
OPENAI_API_KEY: ${{ secrets.CODEX_SECURITY_API_KEY }}
発見事項はデフォルトでレポートのみです。重大度しきい値を設定して、それ以上の重大度の発見事項で失敗させます。スキャナーと必須の報告エラーはジョブを失敗させます。意図的なファイル除外と調査メモは失敗しません。Action設定と入力リファレンスで、PRスキャン、重大度しきい値、レポートアップロードを参照してください。
コンテナ化されたバルクスキャン
Docker Compose構成を使用してリポジトリのリストをスキャンします。これにより、実行間の結果と認証が維持されます。コンテナクイックスタートを参照してください。ワークフローランナーはコンテナ内で個々のCLIステージを実行し、別個にデプロイされた発見サービスに接続できます。
発見事項の保存と重複排除
発見事項ガイドでは、ローカル保存、重複排除、およびpublish scan --to customと明示的な--findings-urlを介した独立して運用されるエンドポイントとの互換性について説明しています。ローカルのserveコマンドとブラウザダッシュボードは削除されました。既存のデータベースとスキャン成果物は引き続き利用可能です。
その他のプロバイダー
スキャンは、OpenAI、Amazon Bedrock、OpenRouter、Fireworks AI、およびCheaper Inferenceをサポートしています。BedrockはAWS認証情報を使用し、個別のOpenAIログインは必要ありません。Bedrock設定でAWSプロファイル、リージョン、およびモデルアクセスを参照してください。
OpenRouter、Fireworks AI、およびCheaper Inferenceの場合、プロバイダーのAPIキーを設定し、サポートされているモデルを選択します。例については、プロバイダー設定を参照してください。
ドキュメント
脆弱性をプライベートに報告するには、セキュリティポリシーに従ってください。