> For the complete documentation index see https://domscan.net/llms.txt. Markdown versions of every docs page are available by appending .md to the page URL.

Source: https://domscan.net/ja/docs/vulnerabilities

# 脆弱性インテリジェンス

DomScan APIで公開ページを1つ確認して、ソフトウェアやセキュリティ設定に関する情報を調べ、対応するバージョン情報のあるコンポーネントをパッケージの勧告や悪用データと照合します。

公開ページを1つ確認して、ソフトウェアやセキュリティ設定に関する情報を調べ、対応するバージョン情報のあるコンポーネントをパッケージの勧告や悪用データと照合します。結果には、完了したチェックの証拠と対象範囲が表示されます。問題が見つからなくても、アプリケーションに脆弱性がないことの証明にはなりません。

GET /v1/vulnerabilities

#### クエリパラメータ

| パラメータ | タイプ | 説明 |
| --- | --- | --- |
| url オプション | string | 分析対象の完全な公開 HTTP(S) URL。URL とドメインの両方が指定された場合、URL が優先されます。 |
| domain オプション | string | 分析対象の公開ドメインまたは HTTP(S) URL。URL またはドメインのいずれかを指定してください。 |
| mode オプション | string `standard` \| `deep` | スキャンモード: standard はデフォルトで 8 クレジットを消費し、deep は独立した JavaScript レンダリングを追加して 12 クレジットを消費します。他の値は受け入れられません。 |

#### 勧告ソースとカバレッジ

検証済みの公開技術バージョンを、権威あるパッケージアドバイザリ、既知の悪用情報、悪用確率と照合します。DomScanは影響対象バージョン、セキュリティ設定の不備、検査範囲が不明な項目を分けて示すため、チームは証拠が最も強い問題から修正できます。

| フィールド | 説明 |
| --- | --- |
| `checked` | ソースがクエリされ、結果が検出結果に反映されています。 |
| `not_requested` | ソースに問い合わせるものはありませんでした。検出されたコンポーネントには、レビュー済みパッケージにマップされたバージョンを持つものがなかったため、勧告はクエリされず、CVE は悪用ソースに到達していません。これはカバレッジの制限であり、ターゲットが影響を受けていないことの証拠ではありません。 |
| `partial` / `failed` | ソースがクエリされましたが、不完全または全く応答がありませんでした。影響を受けるコンポーネントは不明のままであり、安全と報告されることはありません。 |

#### リクエスト例

```bash
curl -H "X-API-Key: your-api-key" "https://domscan.net/v1/vulnerabilities?domain=example.com&mode=standard"   -H "x-api-key: YOUR_API_KEY"
```

```python
import requests

domscan = requests.Session()
domscan.headers.update({"X-API-Key": "your-api-key"})

response = domscan.get(
    "https://domscan.net/v1/vulnerabilities",
    params={"domain": "example.com", "mode": "deep"},
    headers={"x-api-key": "YOUR_API_KEY"},
)
result = response.json()

print(result["summary"]["posture"])
print(result["coverage"]["package_advisories"])
```

#### レスポンスフィールド

| フィールド | タイプ |
| --- | --- |
| `target` | object |
| `target.requested_url` | string |
| `target.final_url` | string |
| `target.hostname` | string |
| `scan` | object |
| `scan.mode` | string |
| `scan.status` | string |
| `scan.checked_at` | string |
| `scan.duration_ms` | integer |
| `scan.disclaimer` | string |
| `summary` | object |
| `summary.posture` | string |
| `summary.risk_level` | string |
| `summary.finding_count` | integer |
| `summary.version_affected_count` | integer |
| `summary.misconfiguration_count` | integer |
| `summary.urgent_count` | integer |
| `summary.severity_counts` | object |
| `findings[]` | object[] |
| `findings[]` | object |
| `findings[].fingerprint` | string |
| `findings[].classification` | string |
| `findings[].severity` | string |
| `findings[].priority` | string |
| `findings[].title` | string |
| `findings[].summary` | string |
| `findings[].component` | object |
| `findings[].component.technology_id` | string |
| `findings[].component.name` | string |
| `findings[].component.detected_version` | string |
| `findings[].component.version_kind` | string |
| `findings[].component.confidence` | string |
| `findings[].component.confidence_score` | integer |
| `findings[].component.ecosystem` | string |
| `findings[].component.package` | string |
| `findings[].component.purl` | string |
| `findings[].advisory` | object |
| `findings[].advisory.id` | string |
| `findings[].advisory.aliases[]` | string[] |
| `findings[].advisory.cves[]` | string[] |
| `findings[].advisory.published_at` | string \| null |
| `findings[].advisory.modified_at` | string \| null |
| `findings[].advisory.cvss[]` | object[] |
| `findings[].advisory.cvss[]` | object |
| `findings[].advisory.cvss[].type` | string |
| `findings[].advisory.cvss[].vector` | string |
| `findings[].advisory.fixed_versions[]` | string[] |
| `findings[].advisory.affected_ranges[]` | object[] |
| `findings[].advisory.affected_ranges[]` | object |
| `findings[].advisory.references[]` | string[] |
| `findings[].exploitation` | object |
| `findings[].exploitation.cisa_kev` | boolean \| null |
| `findings[].exploitation.kev_added_at` | string \| null |
| `findings[].exploitation.kev_required_action` | string \| null |
| `findings[].exploitation.known_ransomware_use` | string \| null |
| `findings[].exploitation.epss_probability` | number \| null |
| `findings[].exploitation.epss_percentile` | number \| null |
| `findings[].exploitation.epss_date` | string \| null |
| `findings[].evidence` | object |
| `findings[].evidence.confidence` | string |
| `findings[].evidence.observed[]` | string[] |
| `findings[].evidence.limitations[]` | string[] |
| `findings[].remediation` | object |
| `findings[].remediation.summary` | string |
| `findings[].remediation.fixed_versions[]` | string[] |
| `findings[].sources[]` | string[] |
| `components[]` | object[] |
| `components[]` | object |
| `components[].technology_id` | string |
| `components[].name` | string |
| `components[].detected_version` | string \| null |
| `components[].version_kind` | string \| null |
| `components[].confidence` | string |
| `components[].advisory_status` | string |
| `components[].matched_advisories` | integer |
| `coverage` | object |
| `coverage.target_response` | string |
| `coverage.technology_detection` | string |
| `coverage.package_advisories` | string |
| `coverage.known_exploitation` | string |
| `coverage.exploitation_probability` | string |
| `coverage.detected_components` | integer |
| `coverage.versioned_components` | integer |
| `coverage.advisory_eligible_components` | integer |
| `coverage.advisory_checked_components` | integer |
| `coverage.advisory_deferred_components` | integer |
| `coverage.advisory_query_limit` | integer |
| `coverage.relay_used` | boolean |
| `coverage.limitations[]` | string[] |
| `sources[]` | object[] |
| `sources[]` | object |
| `sources[].id` | string |
| `sources[].name` | string |
| `sources[].owner` | string |
| `sources[].url` | string |
| `sources[].status` | string |
| `sources[].retrieved_at` | string \| null |
| `sources[].cache_hit` | boolean |
| `sources[].expected_freshness` | string |
| `sources[].fallback_behavior` | string |
| `sources[].cost` | string |
| `_meta` | object |

#### レスポンス例

```json
{
  "target": {
    "requested_url": "https://www.example.com/",
    "final_url": "https://www.example.com/",
    "hostname": "www.example.com"
  },
  "scan": {
    "mode": "standard",
    "status": "complete",
    "checked_at": "2026-10-09T10:15:30.000Z",
    "duration_ms": 3120,
    "disclaimer": "A clean result means DomScan did not detect an issue within the documented scan coverage. Automated scanning cannot prove that an application is vulnerability-free or replace an authorized penetration test."
  },
  "summary": {
    "posture": "review",
    "risk_level": "medium",
    "finding_count": 2,
    "version_affected_count": 0,
    "misconfiguration_count": 2,
    "urgent_count": 0,
    "severity_counts": {
      "critical": 0,
      "high": 0,
      "medium": 1,
      "low": 1,
      "info": 0,
      "unknown": 0
    }
  },
  "findings": [
    {
      "fingerprint": "configuration:content-security-policy:www.example.com",
      "classification": "security_misconfiguration",
      "severity": "medium",
      "priority": "elevated",
      "title": "Content Security Policy is not advertised",
      "summary": "The observed response did not include a Content-Security-Policy header.",
      "evidence": {
        "confidence": "high",
        "observed": [
          "Public response did not include the expected content-security-policy protection."
        ],
        "limitations": [
          "header_policy_can_vary_by_path_or_response_status"
        ]
      },
      "remediation": {
        "summary": "Deploy a restrictive Content Security Policy in report-only mode first, then enforce it.",
        "fixed_versions": []
      },
      "sources": [
        "target_response"
      ]
    },
    {
      "fingerprint": "configuration:referrer-policy:www.example.com",
      "classification": "security_misconfiguration",
      "severity": "low",
      "priority": "normal",
      "title": "Referrer Policy is not advertised",
      "summary": "The response did not include an explicit Referrer-Policy header.",
      "evidence": {
        "confidence": "high",
        "observed": [
          "Public response did not include the expected referrer-policy protection."
        ],
        "limitations": [
          "header_policy_can_vary_by_path_or_response_status"
        ]
      },
      "remediation": {
        "summary": "Choose and deploy a Referrer-Policy that matches the application privacy and analytics requirements.",
        "fixed_versions": []
      },
      "sources": [
        "target_response"
      ]
    }
  ],
  "components": [
    {
      "technology_id": "jquery",
      "name": "jQuery",
      "detected_version": "3.7.1",
      "version_kind": "asset",
      "confidence": "high",
      "advisory_status": "checked",
      "matched_advisories": 0
    },
    {
      "technology_id": "cloudflare",
      "name": "Cloudflare",
      "detected_version": null,
      "version_kind": null,
      "confidence": "high",
      "advisory_status": "mapping_unavailable",
      "matched_advisories": 0
    }
  ],
  "coverage": {
    "target_response": "checked",
    "technology_detection": "checked",
    "package_advisories": "checked",
    "known_exploitation": "not_requested",
    "exploitation_probability": "not_requested",
    "detected_components": 2,
    "versioned_components": 1,
    "advisory_eligible_components": 1,
    "advisory_checked_components": 1,
    "advisory_deferred_components": 0,
    "advisory_query_limit": 20,
    "relay_used": true,
    "limitations": [
      "Only exact reviewed technology-to-package mappings are checked against OSV.",
      "Versionless or semantically incompatible detections are not reported as vulnerable.",
      "This passive scan does not send exploit payloads or prove exploitability.",
      "Response headers and exposed versions can vary by path, edge location, or authentication state."
    ]
  },
  "sources": [
    {
      "id": "target_response",
      "name": "Observed public response",
      "owner": "Target website",
      "url": "https://domscan.net/tech-stack-api",
      "status": "checked",
      "retrieved_at": "2026-10-09T10:15:30.000Z",
      "cache_hit": false,
      "expected_freshness": "Live at scan time",
      "fallback_behavior": "Unavailable signals remain unknown and never imply that the target is unaffected",
      "cost": "none"
    },
    {
      "id": "osv",
      "name": "OSV",
      "owner": "Google Open Source Security Team",
      "url": "https://google.github.io/osv.dev/",
      "status": "checked",
      "retrieved_at": "2026-10-09T10:15:29.000Z",
      "cache_hit": false,
      "expected_freshness": "OSV targets advisory freshness within 15 minutes",
      "fallback_behavior": "Use a fresh cached result when available; otherwise mark the component advisory check unknown",
      "cost": "none"
    },
    {
      "id": "cisa_kev",
      "name": "CISA Known Exploited Vulnerabilities Catalog",
      "owner": "Cybersecurity and Infrastructure Security Agency",
      "url": "https://www.cisa.gov/known-exploited-vulnerabilities-catalog",
      "status": "not_requested",
      "retrieved_at": null,
      "cache_hit": false,
      "expected_freshness": "Catalog changes are checked hourly",
      "fallback_behavior": "Use a fresh cached catalog when available; otherwise leave exploitation status unknown",
      "cost": "none"
    },
    {
      "id": "first_epss",
      "name": "Exploit Prediction Scoring System",
      "owner": "FIRST",
      "url": "https://www.first.org/epss/",
      "status": "not_requested",
      "retrieved_at": null,
      "cache_hit": false,
      "expected_freshness": "Scores are generated daily",
      "fallback_behavior": "Return the advisory without an EPSS value and mark exploitation probability unknown",
      "cost": "none"
    }
  ],
  "_meta": {
    "served_by": "pop=MAD country=ES",
    "analysis_status": "complete"
  }
}
```

**検査範囲と情報源:**
問題が検出されなかった結果でも、アプリケーションに脆弱性がないことを証明したり、許可を得たペネトレーションテストの代わりになったりするものではありません。
