managed-pentesting-with-strix

Strix Cloud（マネージド、ローカルインフラ不要）

Strix の自律型ペネトレーションテストを、Docker や LLM を自分で実行せずに利用したい場合に使用します。スキャンは Strix のインフラ上で実行され、結果はチームダッシュボードで追跡されます。サンドボックス化された環境やホスト型エージェントの環境、CI 環境での利用、チームでの利用、スケジュール実行や継続的なテストには、この方法が適しています（ダウンロード可能な PDF／DOCX レポートは Enterprise プランの機能です）。完全ローカル、無料、エアギャップ環境、または BYO-LLM で実行する場合は、代わりに penetration-testing-with-strix スキルのオープンソース CLI を使用してください。どちらも同じエンジンと SARIF 出力を使用しているため、併用できます。

同等のインターフェースが 2 つあります。CLI の使用をおすすめします。

• strix cloud CLI — すべての REST 操作に、strix cloud <resource> <verb> 形式のコマンドがあります。curl -sSL https://strix.ai/install | bash でインストールします。strix cloud を実行するとすべてのリソースが一覧表示され、strix cloud <resource> help（または -h）を実行すると、リソースの操作が一覧表示されます。安全な読み取り操作がデフォルトのリソースをそのまま実行すると、ドキュメントに記載されたデフォルトの操作が実行されます。
• REST API — ベース URL は https://app.strix.ai/api/v1 です。すべてのリクエストに Authorization: Bearer <token> を指定します。完全なリファレンス：docs.app.strix.ai · エージェント向けインデックス：https://docs.app.strix.ai/llms.txt · OpenAPI：https://docs.app.strix.ai/openapi.json。

CLI はエージェントにも人にも同じように使用できます。stdout が端末でない場合、または --json を指定した場合は、完全な JSON が出力されます。端末のテーブルでは、名前、ブランチ、ライフサイクルの状態、番号付きセレクターが優先して表示されます。人向けの一覧には、後続コマンドで必要となるセレクターが残されますが、内部の組織 ID／ユーザー ID は省略されます。コンパクトなテーブルに収まらない長さのセレクターは、コピー可能なブロックに省略せず再表示されます。ページ分割された一覧では、次の --page または --offset が表示されます。詳細表示では、安全な端末表示の上限内で有用な説明文が保持されます。完全なレコードを確認するには --json を使用してください。トークン一覧では、認証情報に有効、期限切れ、取り消し済みのラベルが付けられます。例外はバイナリのダウンロードです。生バイトを意図的にリダイレクトするか、--output FILE --json を使ってファイルに書き込み、構造化メタデータを受け取ってください。stdin が端末でない場合、対話型プロンプトは表示されません。終了コード：0 成功、1 リクエスト／実行時エラー、2 使用法が無効、4 認証またはプラン上限、5 支払いが必要です。

安全な読み取り操作があるリソースグループには、それぞれ有用なデフォルトアクションがあります。操作を確認するには、常に -h または help を使用できます。ネイティブのタブ補完では、リソース、操作、フラグ、ワークスペースコマンド、ローカルパスが補完されます。

source <(strix completions zsh)       # current zsh session
source <(strix completions bash)      # current bash session
strix completions fish | source       # current fish session

書き込みコマンドでは、リクエストフィールドをフラグとして指定します。すべての書き込みコマンドでは、--data を使って JSON オブジェクトを 1 つ指定することもできます。フラグのないフィールドを送信する場合は、この方法を使用します。

strix cloud scans start --data '{"engagement_type":"code_review"}'   # literal JSON
strix cloud scans start --data @request.json                         # read a file
cat request.json | strix cloud scans start --data -                  # read standard input

プラットフォームではプランとロールの上限が適用され、CLI はプラットフォームのメッセージをそのまま渡します。レポートのダウンロードには Enterprise プランが必要です。スケジュール機能には Pro プランが必要です。課金関連の書き込みには管理者トークンが必要です。ブロックされたコマンドはコード 4 で終了します。

セットアップ：サインイン

デバイスサインインを実行します。初回実行時にユーザーのアカウントとワークスペースが作成され、個人用 API トークンが ~/.strix/platform-auth.json に保存されます。

strix cloud login
# Non-interactive least-privilege example:
strix cloud login --scopes scans:read scans:write uploads:write billing:read vulnerabilities:read assets:read assets:write
# Or use a stable named profile:
strix cloud login --scope-profile recommended

ユーザーはブラウザーでサインインを承認します。--scopes（および任意の --workspace <name-or-id>）を指定すると、ターミナルでのプロンプトが表示されないため、非対話型のエージェントシェルからコマンドを実行できます。対話型ターミナルでフラグを指定せずに実行すると、CLI にワークスペース選択画面とスコープのプリセット（推奨、フルアクセス、最小、カスタム）が表示されます。推奨設定では、通常のスキャン、ソースのアップロード、ワークスペースの切り替え、ユーザー承認によるクレジットのチャージに対応します。認証情報の管理に必要な場合に明示的に要求する tokens:write は含まれません。より限定された自動化トークンを使用する場合は、スコープを明示的に指定してください。

• strix cloud whoami は、ローカルの状態をすばやく確認できます。strix cloud session --json はリモートのデバイスセッションを検証し、strix cloud session scopes は有効なアクセス権と変更できないログイン時の上限の両方を表示します。

• strix cloud logout は、ローカルトークンを削除する前にリモートセッションを失効させます。ネットワークまたはサーバーの障害が発生した場合、ユーザーが再試行できるようトークンを保持します。--local-only を指定すると、意図的に失効処理をスキップします。

• その他の strix cloud コマンドは、保存済みのトークンを自動的に使用します。--token <token> または STRIX_API_TOKEN は、コマンドごとに使用するステートレスな上書き設定であり、保存済みアカウントを上書きすることはありません。上書きに CLI セッションのトークンを使用する場合は、--workspace-id も指定するか、STRIX_WORKSPACE_ID を設定してください。

• トークンをハードコード、ログ出力、コミットしないでください。環境変数または CI のシークレットストアに保存してください。

• スコープ（最小権限）： インテグレーションに必要な権限のみを割り当て、定期的にローテーションしてください。

  スコープ	許可される操作
  scans:read / scans:write	スキャンの一覧表示／読み取り／レポート · スキャンの作成／再実行／キャンセル
  vulnerabilities:read / :write	検出結果の読み取り · ステータスとメモの更新
  assets:read / :write	ドメイン／リポジトリの読み取り · 登録／更新
  schedules:read / :write	スケジュールの読み取り · 定期スキャンの作成／実行
  pr_reviews:write	PR のセキュリティレビューの実行
  webhooks:read / :write	Webhook サブスクリプションの管理
  uploads:write	スキャン用のローカルソースまたはドキュメントのアップロード
  organizations:read	組織の詳細の読み取り（サインイン中のユーザーのワークスペースの一覧表示／切り替えに API スコープは不要です）
  organizations:write	ワークスペースの作成／更新（管理者）
  tokens:write	通常の API トークンの作成／失効（現在の CLI セッションの管理には不要です）
  knowledge:read / :write	組織のナレッジの読み取り／更新
  audit:read	Enterprise 監査ログの読み取り／エクスポート
  billing:read / billing:write	クレジット残高と自動チャージ設定の確認 · クレジットの購入（管理者）

HTTP エラーはメッセージと終了コードに対応します：401 トークンが無効または期限切れ（終了コード 4）、402 クレジット不足（終了コード 5）、403 スコープまたはプランの上限（終了コード 4）、422 検証エラー（終了コード 1）。

有効期限付きの自動化トークンは strix cloud tokens create で作成します。--rbac-scopes を使用して、対象 ID、タグ、または事業部門に制限できます。値は { "type": "target|tag|business_unit", "value": "..." } オブジェクトの JSON 配列です。

strix cloud tokens create --type service --name staging-ci \
  --expires-at 2026-12-31T23:59:59Z \
  --scopes scans:read scans:write \
  --rbac-scopes '[{"type":"tag","value":"staging"}]'

トークンシークレットは一度だけ返されます。シークレットマネージャーに直接保存し、表示またはコミットしないでください。--expires-at と --expires-in-days は同時に指定できません。

0. クレジットとチャージ

Enterprise 以外のスキャンでは、組織のクレジットを消費します。Enterprise の契約はプランに含まれており、ウォレットから引き落とされません。スキャンの前に残高を確認してください（billing:read）。

strix cloud credits

残高が不足している場合は、strix cloud billing topup を使ってクレジットを購入してください（billing:write、管理者トークンが必要です）。サーバーは最初のリクエストに HTTP 402 と機械決済チャレンジ（Stripe Machine Payments Protocol）で応答します。Node.js が利用可能な場合、CLI は Stripe Link ウォレットクライアントでチャレンジを支払い、ユーザーは Link アプリで支出を承認します。応答にはレシート（credits_granted、duplicate、reference）と新しい残高が含まれます。

デフォルトティアのソースコードのみのコードレビューは、現在 60 クレジットから開始します。ソースのアップロードは無料ではありません。通常の code_review を開始し、同じ決定論的なスコープ推定器を使用します。サービスは開始前に残高全額を確認し、検証の成功後にのみクレジットをアトミックに予約します。却下されたスキャンは作成も課金もされません。再テストと Enterprise スキャンは対象外です。

strix cloud billing topup --credits 20 --yes   # explicit approval; skips the TTY prompt
strix cloud billing topup --credits 20 --no-pay   # print the 402 challenge without paying

デフォルトの支払い方法は Stripe Link ウォレットです。ウォレットが接続されていない場合、対話型の strix cloud billing topup はユーザーの Link サインインを開始し、認証リンクを表示します。ユーザーは Link アプリで一度だけ接続を承認し、その後は各支払いを同アプリで承認します。キーや変数は不要です。非対話型プロセスではコマンドは停止し、ユーザーに link.com/agents でウォレットを接続するか、ホスト型チェックアウトリンクを使用するよう案内します。

非対話型のエージェントまたは CI プロセスでは、コマンドに --yes が指定されない限り、支払いは実行されません。チャレンジまたは推定支出額をユーザーに提示し、追加前に承認を得てください。--no-pay を指定すると、チャレンジを表示した後、必ず停止します。

ユーザーがウォレットを希望しない場合は、strix cloud billing subscribe --plan strix_top_up でホスト型チェックアウトリンクを作成し、ユーザーにリンクを渡してください。ユーザーはブラウザーで支払います。

自動チャージ（管理者）：strix cloud billing auto-topup で設定を確認できます。次のコマンドで有効にします。

strix cloud billing auto-topup update --enabled --topup-credits 20 --monthly-cap-credits 200

--monthly-cap-credits を省略すると、保存済みの上限が維持されます。上限を解除するには --no-monthly-cap を渡してください。

ワークスペースとアカウントの設定

strix cloud login で取得した個人用トークンを使って、ワークスペースを管理します。

strix cloud workspaces list                    # numbered name/role/current list
strix cloud workspaces create --name "My Team"  # admin + organizations:write
strix cloud workspaces use 2                   # displayed number, exact name, or ID
strix cloud workspace use "My Team"            # singular `workspace` alias also works
strix cloud session scopes                     # effective scopes + consent ceiling
strix cloud session scopes set minimal         # narrow the session
strix cloud org members invite --email [email protected] --role analyst

workspaces use は、現在の個人用トークンの接続先を、ユーザーがすでに所属しているワークスペースに変更し、更新したワークスペースのメタデータを保存します。ベアラーシークレットと有効期限は変わりません。通常の切り替えでは再度プロンプトを表示しません。サーバーは選択したプロファイルを維持し、変更できないログイン時の上限を適用して、実効スコープを対象ロールの範囲内に制限します。上限の範囲内でさらに制限するには --scope-profile または --scopes を使用してください。より広い同意が必要な場合は、strix cloud login を再度実行してください。CLI は各プロセスの開始時のワークスペースに固定されるため、同時に実行しているシェルは、組織を暗黙にまたぐのではなく、復旧可能な競合エラーになります。

人が完了させる必要がある引き継ぎ

ユーザーが完了させる必要がある手順は4つあります。コマンドはリンクまたはレコードを作成して表示します。Strix がブラウザーを開くのは、対話型ターミナルの場合のみです。URL のみを表示するには --no-browser を渡してください。

strix cloud billing subscribe --plan strix_cloud # hosted checkout page for the Cloud plan
strix cloud billing portal                       # billing portal for the card and the plan
strix cloud integrations install github          # GitHub App or Slack installation page
strix cloud domains verify <domain-id>           # DNS record to add, then run it again

表示された URL または DNS レコードをユーザーに渡し、完了を待ってください。支払い、インストール、DNS の変更が完了したと断言しないでください。その後、strix cloud credits、strix cloud integrations list、または strix cloud domains list で結果を確認してください。domains verify は assets:write が必要ですが、それ以外の3つのコマンドには管理者トークンが必要です。

組織のナレッジ

エージェントは、ダッシュボードを使わずに組織のナレッジベースを管理できます（knowledge:read / knowledge:write）。

strix cloud knowledge list --search authentication
strix cloud knowledge add --title "Authentication" --content "Staging uses SSO."
strix cloud knowledge update <document-id> --content "Staging uses SSO and TOTP."
strix cloud knowledge delete <document-id>
strix cloud knowledge policies add --key staging-only --content "Never test production."
strix cloud knowledge policies delete staging-only
strix cloud knowledge repos entries usestrix/strix

ナレッジポリシーの書き込みには管理者トークンが必要です。リポジトリ名は通常の owner/name 値として渡してください。URL エンコードは CLI が処理します。costs コマンドと llm-settings コマンドはオンプレミスのインストールを対象とし、app.strix.ai では 404 を返します。

1. 対象をアセットとして登録する

スキャンは、生の URL ではなく、登録済みのアセットに対して実行されます。最初に一度登録し、返された UUID を再利用してください。

# Domain (black-box / live target). Requires domain verification before external scanning.
# --asset-type must be one of: web_app | api | attack_surface.
strix cloud domains add --domain staging.example.com --asset-type web_app

# Repository (white-box / code review). `full_name` is "owner/name".
strix cloud repos add --data '{"full_name":"org/app","provider":"github"}'

アセットを再登録するのではなく、既存のアセットを確認してください：strix cloud domains list、strix cloud repos list（どちらも assets:read）。

2. スキャンを開始する

strix cloud scans start（scans:write）。--domain-ids、--repository-ids、または --internal-targets を使って、少なくとも 1 つの対象を指定してください（内部インフラにはネットワークコネクターが必要です。ドキュメントを参照してください）。

strix cloud scans start \
  --engagement-type live_test \
  --domain-ids <domain-uuid> \
  --focus "IDOR, auth bypass, SSRF" \
  --context "Staging. Test account creds are configured as a test user." \
  --notify-on-completion

便利なフラグ（それぞれ CreateScanRequest のフィールドに対応します）：

フラグ	用途
--engagement-type	live_test（デフォルト）、code_review、internal_infra、compliance_pentest
--domain-ids / --repository-ids / --internal-targets	対象（少なくとも 1 つ）
--domain-paths / --repository-branches	特定のパス／ブランチに絞り込みます（JSON マップ）
--credentials	認証スキャン。mfa_method（totp／email_otp／…）と totp_secret（JSON リスト）を含みます
--headers	JSON 配列のヘッダーオブジェクトとして、対象に追加する HTTP ヘッダーを指定します
--focus / --concerns / --context	エージェントの動作を導く自由形式の文字列
--upload-ids	ホワイトボックスのコンテキスト用に、アップロード済みのソース／ドキュメントアーカイブを添付します
--notify-on-completion / --notification-emails	完了時にメールで通知します

--source を指定しない場合、レスポンスは status が pending の { scan_id, title, status } です。 ローカルソースを指定して成功すると、プラットフォームのレスポンスは { source, upload_id, scan: { scan_id, title, status } } の形式でラップされるため、自動化処理で、正確な承認済みマニフェストとステージング済みアップロード ID を作成されたスキャンと併せて保持できます。

クラウドでローカルのワークスペースをスキャンする

エージェントまたは CI ワークフローでは、レビューした正確なソーススナップショットに承認を紐付けます。使用するソース選択フラグを指定してドライランを実行し、マニフェストと選択されたパスを確認して、source.archive_sha256 を記録します。その後、同じ --source、すべての --exclude、および使用した --include-hidden、--include-sensitive、--include-archives フラグを指定し、--approve-sha256 を付けて再度実行します。

strix cloud scans start --source . --exclude 'private/' --dry-run --show-files --json
# After reviewing the output, capture its source.archive_sha256 value:
SOURCE_SHA256="<reviewed source.archive_sha256>"
# Repeat every source-selection flag unchanged; a source-only scan infers code_review.
strix cloud scans start --source . --exclude 'private/' \
  --approve-sha256 "$SOURCE_SHA256" --wait

CLI はアーカイブを再構築し、その SHA-256 が一致しない場合はアップロードを拒否します。--yes の意味は意図的により限定されています。このフラグが承認するのは、その 1 回の実行中に構築されたスナップショットのみです。人間による意図的な承認や 1 回限りの承認には使用できますが、ダイジェストに紐付いたエージェント／CI のレビューの 2 段階目としては使用しないでください。TTY がない場合、ソースのアップロードには一致する --approve-sha256 による承認、または --yes のいずれかが必要です。対話型ターミナルでは、代わりに概要、--show-files が設定されている場合は選択されたファイル名、および現在のスナップショットに対する [y/N] の確認を表示できます。

デフォルトの選択はプライバシーに配慮しています。Git ワークツリーでは、追跡対象のファイルに加え、無視対象でない未追跡ファイルが含まれます。.gitignore に従い、隠しパス要素をすべて除外し、.git、シンボリックリンク、依存関係／ビルド出力、秘密情報を含む可能性のあるファイル名、ネストされたアーカイブを常に除外します。プロジェクト固有の除外は .strixignore（1 行に除外用 glob を 1 つ）に追加するか、--exclude GLOB を繰り返し指定してください。private/ のように末尾にスラッシュを付けると、そのディレクトリと配下が除外されます。

クライアントは、ファイル数が 20,000 を超える場合、25 MiB を超えるファイルがある場合、展開後のサイズが 250 MiB を超える場合、または ZIP が 50 MiB を超える場合に処理を拒否します。その後、サービスは ZIP をストリーム展開し、不正または未対応のエントリ、安全でないパス、エントリ数の超過、エントリサイズの超過、展開データ量の超過、圧縮入力サイズの超過を独自に拒否します。これにより、信頼できないクライアントがメタデータを偽造して ZIP 爆弾対策を回避することはできません。

--include-hidden、--include-sensitive、--include-archives は、ドライランのマニフェストでスキャンに必要だと確認できた場合にのみ使用してください。隠しファイルと機密ファイルの追加は別々のオプトインです。たとえば .env を含めるには、--include-hidden と --include-sensitive の両方が必要です。

CLI は各実行後に、ローカルの非公開な一時アーカイブを削除します。リモートへのアップロードがステージングされた後、スキャンで明確に拒否された場合は、CLI がそのアップロードを削除します。ネットワーク障害、5xx 応答、不正な成功応答、またはスキャンの起動開始後の中断は、プラットフォームがスキャンを受け付けている可能性があるため、結果が不明確です。この場合、CLI はアップロードを保持し、launch_outcome_unknown: true とともにその upload_id を返します。自動削除を試みても完了を確認できない場合は、代わりに保持された upload_id と cleanup_unknown: true を返します。再試行する前に strix cloud scans list を実行し、重複スキャンや二重請求を避けてください。保持されたアップロードに紐付くスキャンがない場合は、strix cloud uploads delete UPLOAD_ID で削除できます。スキャンに紐付いたアップロードは削除できません。

タイプを明示しない場合、ソースのみを指定すると code_review が推定されます。ドメインのターゲットを指定するとそちらが優先され、live_test が推定されます。そのため、ソースとデプロイ済みドメインを組み合わせるのが、通常のホワイトボックス・ライブテストのワークフローです。推定結果を上書きする必要がある場合は、--engagement-type を指定してください。

3. 完了を待つ

scans start に --wait を渡すと、スキャンが最終状態に達するまでポーリングします。または、strix cloud scans get <scan-id>（scans:read）を使って自分でポーリングしてください。--wait-timeout SECONDS で自動化の待機時間に上限を設定できます。タイムアウトしても、リモートスキャンはキャンセルされず、正常に終了します。ステータスの遷移：pending → running → completed（または failed ／ cancelled）。スキャンには数分から数時間かかるため、間隔を空けてポーリングし、無期限に処理をブロックしないでください。

4. 検出結果を読む

スキャン詳細のレスポンスには、executive_summary、methodology、recommendations、重要度別に集計された findings、および vulnerabilities[] 配列が含まれます。各脆弱性には、title, severity, status, cvss, cwe, endpoint, method, impact, technical_analysis, poc_description, poc_script_code と、コードに関する検出結果の場合は code_file／code_diff／code_before／code_after が含まれます。

strix cloud scans get <scan-id> --json \
  | jq '["critical","high","medium","low","info"] as $order
       | .vulnerabilities
       | sort_by(.severity as $s | $order | index($s))
       | .[] | {title, severity, endpoint, cwe}'

Cloud の重要度は critical | high | medium | low、ステータスは open | in_progress | snoozed | fixed | ignored | not_affected です。sort_by(.severity) はアルファベット順（critical、high、low、medium）に並べ替えるため、明示的に重要度の順序を指定して並べ替えてください。

複数のスキャンにまたがる組織全体のトリアージには、strix cloud vulns list --severity critical を使用します（vulnerabilities:read が必要です。また、--status、--scan-id などでもフィルタリングできます）。strix cloud vulns update <id> --status fixed でトリアージの状態を更新できます。修正するには、fix-security-vulnerabilities-with-strix スキルに引き継いでください。

5. エクスポートとレポート

# SARIF 2.1.0 for GitHub code scanning / ASPM ingestion
strix cloud scans sarif <scan-id> --output findings.sarif

# Report. Formats: technical (default) | retest | attestation | executive_summary
# Types: pdf (default) | docx
# Any report download requires the Enterprise plan. Formats beyond `technical`,
# DOCX, and white-label branding are Enterprise-only too. Scan must be completed.
strix cloud scans report <scan-id> --format technical --type pdf --output strix-report.pdf

ダウンロード時に --force を明示しない限り、既存ファイルは上書きされません。Enterprise の監査ログは、本文を JSON としてデコードせずに JSON 形式でストリーミングまたはエクスポートできます。

strix cloud audit list --format csv --all --output audit.csv
strix cloud audit list --format ndjson --all --output audit.ndjson

6. PR レビュー

プルリクエストの自動セキュリティレビューを開始します（pr_reviews:write）。strix cloud repos list でリポジトリの provider と installation_id を確認します。どちらもインストール済みのソース管理連携を識別する情報です。結果は PR のコメントとダッシュボードに表示されます。

strix cloud pr-reviews start \
  --provider github \
  --installation-id <installation-id> \
  --repository-full-name org/app \
  --pr-number 123

strix cloud pr-reviews list と strix cloud pr-reviews get <id> で一覧表示・詳細確認できます。リポジトリ単位の PR レビュー動作は、strix cloud pr-reviews settings で設定します。

7. 継続的テスト（スケジュールと Webhook）

• スケジュール（schedules:write、Pro プラン）：strix cloud schedules create で定期スキャンを作成し、strix cloud schedules trigger <id> でオンデマンドに実行します。これは、cron で駆動する CLI ループをマネージド環境で実行するものです。
• Webhook（webhooks:write）：strix cloud webhooks create で、scan.completed や vulnerability.created などのペンテスト／脆弱性のライフサイクルイベントを購読し、ポーリングの代わりに結果を Slack、チケット管理システム、自社のパイプラインへ送信します。

ペイロードについては、docs.app.strix.ai のスケジュールと Webhook のセクションを参照してください。

ネットワークコネクターは Enterprise 専用です。strix cloud connectors create は、認証情報を含む一度限りの登録コマンドを返す場合があります。このコマンドをログに貼り付けないでください。また、ユーザーがインストールする準備ができた場合に限り、--include-command を指定して取得してください。ブラウザーでのチェックアウト、ソース管理連携のインストール、DNS 検証、コネクターのインストール、チャットでの共有、外部プロバイダーへの SARIF の公開は、ユーザーへの引き継ぎ、または明示的な外部変更にあたります。コマンド／リンクを準備したうえで、完了する前に適切な承認を得てください。

安全性

ユーザーの組織が所有する、またはテストを許可されているアセットのみをスキャンしてください。外部ドメインのスキャンには、プラットフォームによって強制される検証（DNS／ファイル／メタタグ）が必要です。これを回避しようとしないでください。