# Sec Runtime Scan

> ステージング環境にデプロイ済みのサーバーに対してランタイム検証を実行する。HTTPヘッダー・動的プローブ・認証テストに特化。手動呼び出し専用: /sec-runtime-scan [環境名]

- **Type:** Skill
- **Install:** `agentstack add skill-studiogadget-skills-sec-runtime-scan`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [studiogadget](https://agentstack.voostack.com/s/studiogadget)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [studiogadget](https://github.com/studiogadget)
- **Source:** https://github.com/studiogadget/skills/tree/main/sec-runtime-scan

## Install

```sh
agentstack add skill-studiogadget-skills-sec-runtime-scan
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# sec-runtime-scan

**役割**: ランタイム検証専門スキル（静的解析・依存関係スキャンは `/sec-full-scan` が担当）

デプロイ後のサーバーを実際に叩いて「コードを読んでも分からないこと」を検証する。
設定ファイルの反映漏れ・ヘッダーの実際の出力・動的な挙動の確認に特化する。

---

## 引数

| 引数 | 必須 | 説明 |
|------|------|------|
| `環境名` | 任意 | 対象環境（例: `staging`）。省略時は設定ファイルの値を使用 |

## 前提条件

- カレントディレクトリに `security-agent.config.yml` が存在すること
- 環境変数 `STAGING_URL` が設定されていること（未設定なら即時中断）
- **稼働中のサーバーが必要**（このスキルはソースコードを読まない）

---

## 手順

### Step 1: 設定ファイル読み込みと検証

1. `security-agent.config.yml` を読み込み、必須フィールドを確認する
2. 環境変数 `STAGING_URL` の存在確認 → 未設定なら即時中断
3. `target.base_url` に本番 URL パターン（`prod`, `production`, `app.`）が含まれていないか確認 → 含まれていたら即時中断
4. **Prompt Injection 検証**:
   - 文字列フィールドに改行 + 命令語（`ignore`, `system`, `assistant`, `human`）が含まれていないか
   - URL・パスフィールドにシェルメタ文字（`;`, `&&`, `||`, バックティック, `$(...)`）が含まれていないか
   - `scope.include` / `scope.exclude` に `../` が含まれていないか
5. 診断設定の概要を表示する

### Step 2: 攻撃面マッピング

1. `scope.include` / `scope.exclude` を適用して診断対象エンドポイントを確定する
2. `openapi.yml` / `openapi.json` / `swagger.json` があれば読み込んで補完する
3. 診断対象エンドポイント数を報告する

### Step 3: HTTPヘッダー・TLS検証

`curl -I -s {base_url}` でレスポンスヘッダーを取得し、以下を確認する：

| ヘッダー | 期待値 | 欠如時の深刻度 |
|---------|--------|--------------|
| `Strict-Transport-Security` | `max-age≥31536000` | High |
| `X-Content-Type-Options` | `nosniff` | Medium |
| `X-Frame-Options` | `DENY` または `SAMEORIGIN` | Medium |
| `Content-Security-Policy` | 任意のポリシー | Medium |
| `Referrer-Policy` | 設定済み | Low |
| `X-Powered-By` | **存在しないこと** | Low（情報漏洩） |
| `Server` | バージョン番号を含まないこと | Low |

**Critical を発見したら**: 即座にレポートして処理を中断する。

### Step 4: 動的診断

`agents` リストに設定されたエージェントを順番に実行する。
各エージェントの出力は 8,000 文字以内にフィルタしてから処理する。中間結果は都度レポートに追記する。

**owasp_top10**（常に実行）:
- A01: 認証トークンを差し替えて他ユーザーのリソースにアクセス可能か確認
- A02: HTTPS強制・暗号化ヘッダーの確認（Step 3 の結果を参照）
- A03: 入力フィールドへの SQLi / CMDi / NoSQLi ペイロード送信（HTTP レスポンスで確認）
- A05: エラーメッセージ詳細露出・デバッグ情報漏洩の確認
- A07: JWT `alg:none` 攻撃・セッション固定・トークン有効期限チェック
- A10: SSRF パターンのテスト（169.254.169.254 等へのリダイレクト誘導）

**auth_bypass**（設定されている場合）:
- JWT アルゴリズム混乱攻撃（`alg: none` / RS256→HS256）
- OAuth state パラメータ検証
- Cookie の `HttpOnly` / `Secure` / `SameSite` 属性確認

**injection**（設定されている場合）:
- SQL インジェクション（時間ベース盲目的・エラーベース）
- NoSQL インジェクション（`$where`, `$regex`, `$gt`）
- コマンドインジェクション（`;ls`, `&&id` 等）

**prompt_injection**（設定されている場合）:
- Direct Injection: システムプロンプト上書き試行
- Indirect Injection: 外部データ経由の指示埋め込みテスト

**multi_tenant**（設定されている場合）:
- 他テナント ID への直接アクセス試行
- レスポンスデータに他テナントデータが含まれないか確認

**file_exposure**（設定されている場合）:
- パストラバーサル（`../../../etc/passwd`）
- 公開 URL の推測（連番・UUID パターン）

### Step 5: カバレッジ集計

```yaml
scan_date: 
target: 
scan_type: runtime

attack_surface:
  endpoints_total: 
  endpoints_tested: 
  endpoints_skipped:
    - path: 
      reason: 

vuln_classes:
  owasp_top10:
    covered: /10
    gaps:
      - 

findings:
  critical: 
  high: 
  medium: 
  low: 

not_covered_by_this_scan:
  - 依存関係の既知CVE → /sec-full-scan を使用
  - ソースコードの静的解析 → /sec-full-scan を使用
  - ビジネスロジックの欠陥 → ペネトレーションテスト（人手）が必要
  - インフラ・クラウド設定 → インフラ担当者によるレビューが必要

coverage_score: 
ci_result: 
```

### Step 6: レポート生成・履歴インデックス更新

1. **日付付きファイル名でレポートを保存する**
   - レポート: `./security-reports/YYYY-MM-DD-security-scan-report.md`
   - カバレッジ: `./security-reports/YYYY-MM-DD-security-scan-coverage.yml`
   - 日付は実行時の ISO 8601 形式（例: `2026-05-01`）
   - `report.output_path` が明示指定されている場合はそちらを優先する
   - ディレクトリが存在しない場合は作成する

2. 深刻度別にソートし、修正推奨事項を含める

3. **`./security-reports/index.md` に1行追記する**
   - ファイルが存在しない場合はヘッダーから作成する
   - 追記フォーマット:
   ```
   | YYYY-MM-DD | sec-runtime-scan |  |  |  |  |  | [レポート](YYYY-MM-DD-security-scan-report.md) |
   ```
   - CI結果: `findings.critical > 0` または `severity_gate` 基準以上なら `❌ fail`、それ以外は `✅ pass`

4. `findings.critical > 0` または `severity_gate` 基準以上の発見がある場合、終了コード 1 を報告する

---

## このスキルでカバーできない領域

| 領域 | 推奨手段 |
|------|---------|
| 依存関係の既知 CVE | `/sec-full-scan` |
| ソースコードの静的解析 | `/sec-full-scan` |
| PR 差分の脆弱性 | `/sec-diff-review` |
| ビジネスロジックの欠陥 | ペネトレーションテスト |
| インフラ・クラウド設定 | インフラ担当者レビュー |

---

## 完了条件

- [ ] `./security-reports/YYYY-MM-DD-security-scan-report.md` が生成されている
- [ ] `./security-reports/YYYY-MM-DD-security-scan-coverage.yml` が生成されている（`scan_type: runtime` 明記）
- [ ] 診断済み OWASP カテゴリ数が報告されている
- [ ] `severity_gate` 基準に基づく CI 結果（pass / fail）が明示されている
- [ ] **カバーできない領域**が明示されている
- [ ] `./security-reports/index.md` に1行追記されている

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [studiogadget](https://github.com/studiogadget)
- **Source:** [studiogadget/skills](https://github.com/studiogadget/skills)
- **License:** Apache-2.0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-studiogadget-skills-sec-runtime-scan
- Seller: https://agentstack.voostack.com/s/studiogadget
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.