Deepsec
要約
Deepsecは、自社インフラで実行できるエージェント駆動型の脆弱性スキャナーです。大規模な既存リポジトリの全コードをオンデマンドでレビューするように最適化されており、長年潜んでいる発見困難な問題を表面化させます。高レベルなモデルを使用するため、大規模コードベースではスキャンコストが高くなることがありますが、迅速な脆弱性パッチ適用に繋がるため、顧客は費用対効果を評価しています。大規模コードベースでは、作業は複数のワーカーマシンに並列分散され、中断やエラーが発生した場合でも、同じコマンドを再実行すれば中断箇所から処理を再開できます。
全文翻訳
deepsec(https://deepsec.sh/)は、自社インフラで実行できるエージェント搭載の脆弱性スキャナーで、既存の大規模リポジトリの全コードをオンデマンドでレビューするように最適化されています。
deepsecは、アプリケーションに長らく潜んでいる発見困難な問題を表面化させるために設計されています。最高のモデルを最大限の思考レベルで使用するように設定されており(--thinking-levelで調整可能、モデル参照)、大規模コードベースではスキャンに数千ドル、あるいは数万ドルかかることもあります。お客様からは、本来なら修正されずに放置されていた脆弱性を迅速にパッチできたことに対して、そのコストは十分に見合う価値があると評価されています。
大規模コードベースでは、作業はワーカーマシン間で並列処理されます。実行が中断されたり、途中でエラーが発生したりした場合でも、同じコマンドを再実行するだけで、deepsecは中断した箇所から処理を再開し、既に分析したファイルをスキップして残りの部分のみを調査します。
[画像: Vercel Labs Product] [画像: npm version: deepsec] [画像: License: Apache-2.0] [画像: npm downloads per month: deepsec]
開始方法
スキャンしたいリポジトリのルートから、以下を実行します。
npx deepsec init
このコマンドは、すべてをガイドしてくれます。AIモデル(比較用のベンチマークスコアと価格付き)の選択、モデル使用料の支払い方法(自身のOpenAI/Anthropic APIキー、またはVercel AI Gateway)を尋ねられ、その後は自動で処理が進みます。コードベースを解析し、スキャンを実行し、AIレビューを行います。リポジトリに追加されるのは、状態と検出結果がすべて格納される.deepsec/フォルダのみです。
実行が何らかの理由で中断した場合(Ctrl-C、接続喪失、支出制限など)、再度npx deepsec initを実行すると、中断した箇所から処理が再開されます。実行の支出額や所要時間を制限するには、以下のようにします。
npx deepsec init --max-cost-usd 100 --max-duration 2h
スキャンが完了したら、読みやすいレポートを取得します。
cd .deepsec
pnpm deepsec export --format md-dir --out ./findings
後続のスキャンの場合、.deepsec/内から作業します。
pnpm deepsec scan # 高速なパターンマッチングスキャン、無料
pnpm deepsec process # 新規候補のAIレビュー
pnpm deepsec revalidate # オプション、偽陽性率を削減
pnpm deepsec export --format md-dir --out ./findings
開始ガイドでは、自身のOpenAIまたはAnthropic APIキーの使用、CIまたはコーディングエージェントからの実行方法を含め、これらすべてをより詳細にカバーしています。
ドキュメント
初期化後、エージェントはインストールされているCLIに一致する正確なドキュメントを.deepsec/node_modules/deepsec/SKILL.mdおよび.deepsec/node_modules/deepsec/dist/docs/で読み取ることができます。セットアップエラーが発生した場合、これらは絶対的な機械可読パスとして表示されます。
- 開始方法 — セットアップと最初のスキャンの実行
- 変更のレビュー —
process --diffとCIゲーティング - サポートされているテクノロジー — 内蔵カバレッジ
- 生成されたおよび手動作成されたマッチャー
- 設定
- プラグイン
- モデル
- プロジェクトリンクと認証情報
- アーキテクチャ
- データレイアウト
- FAQ
- サンプル
- 貢献
AIプロバイダー
デフォルトでは、deepsecはモデル呼び出しをVercel AI Gateway経由でルーティングします。これにより、プロバイダー固有のキーなしで、すべての主要モデルにアクセスできます。代わりに、initコマンドに--model-auth directと--ai-provider、--ai-api-key-envを渡すことで、自身のキー(OpenAI、Anthropic、またはカスタムHTTPSプロバイダー)を持ち込むことができます。このモードではVercelアカウントは不要です。Deepsecは、キーを保持する環境変数の名前のみを保存し、キー自体は決して保存しません。完全なリファレンスについては、プロジェクトリンクと認証情報を参照してください。
processまたはrevalidateの実行が、アップストリームの認証情報がクォータまたはクレジットを使い果たしたために停止した場合、deepsecは正常に停止し、どこを補充すればよいかを示します。その後、同じコマンドを再実行すると、中断した箇所から処理が再開されます。
分散実行(オプション)
大規模なモノレポは、Vercel SandboxマイクロVM間で作業を分散させることができます。
pnpm deepsec sandbox process --project-id my-app --sandboxes 10 --concurrency 4
セットアップで既にVercel接続が検証されているため、追加のオンボーディングは不要です。ローカルのワーキングツリーはtarball化されてアップロードされ、.gitは除外されます。モデルの認証情報はホスト側に残り、選択されたエグレスホストでのみ注入されます。
Deepsec自体のセキュリティモデル
deepsecは、実行されている環境で完全なシェルアクセスを持つコーディングエージェントとして扱ってください。信頼できる入力(ソースコード)で実行するように設計されていますが、外部依存関係やバンドルされたコードのためにプロンプトインジェクションを懸念する場合があります。
サンドボックス(上記参照)で実行すると、潜在的な露出を大幅に制限できます。
- コーディングエージェントのAPIキーはサンドボックスの外側に注入されるため、漏洩されることはありません。
- ワーカーサンドボックスの場合、サンドボックスからのネットワークエグレスはコーディングエージェントホストに限定されます(ブートストラッププロセス中はエグレスが許可されますが、これはコーディングエージェントを実行しません)。
ワークフローリファレンス
| コマンド | 実行内容 |
|---|---|
scan | 正規表現マッチャーで候補サイトを検出(高速、AIなし) |
process | AIによる調査;検出結果と推奨事項を出力 |
process --diff | PRモード:差分で変更されたファイルのみをスキャン・調査 |
triage | 軽量なP0/P1/P2分類(より安価なモデル) |
revalidate | 既存の検出結果を再チェック;修正のためにgit履歴をチェック |
enrich | gitコミッター情報と(プラグイン使用で)所有権データを追加 |
report | 1つのプロジェクトに対するMarkdown + JSONサマリー |
export | 検出結果ごとのJSONまたはMarkdownファイルディレクトリ |
metrics | プロジェクト横断カウント:深刻度、タイプ別脆弱性、TP(偽陽性) |
status | プロジェクトミラーのスナップショット |
sandbox <cmd> | 上記のいずれかのコマンドをVercel SandboxマイクロVMで実行 |