Sakura Dashboard

ダッシュボードはAIを一切呼び出しません。外部プロセス(aiclientなど)が対象一覧を取得し、自分でチェックした結果をここに送り返す「取得/送信」の2エンドポイントだけを提供します。両方ともx-api-keyヘッダーが必須です(上の「APIキーの管理」で発行)。ダッシュボードにBasic認証を設定している場合はそちらも別途必要です。

GET /api/vulnerability-check/targets

ミドルウェアを1つ以上持つ監視対象と、それぞれの現在のバージョン・前回のチェック結果を返します。何を再チェックすべきかは呼び出し側が判断してください(vuln_checked_atを見て、一定期間より古ければ再チェックする、など)。

curl -H "x-api-key: <発行したキー>" http://localhost:3000/api/vulnerability-check/targets

[
  {
    "monitor_id": 6,
    "target": "https://example.com/",
    "middlewares": [
      {
        "id": 3,
        "name": "Apache",
        "version": "2.4.41",
        "overall_risk": "high",
        "risks": [
          { "cve_id": "CVE-2021-41773", "severity": "critical",
            "summary": "...", "source_url": "https://..." }
        ],
        "vuln_checked_at": "2026-09-04 09:28:53",
        "vuln_error": null
      }
    ]
  }
]

POST /api/vulnerability-check/results

1件のオブジェクト、または配列を渡せます。middleware_idは上のtargetsで返ってきたものをそのまま使ってください(versionとセットで、その組み合わせの結果としてキャッシュされます)。成功時は204、失敗を報告する場合はrisksを省略してerrorだけ渡してください。

curl -X POST http://localhost:3000/api/vulnerability-check/results \
  -H "x-api-key: <発行したキー>" -H "Content-Type: application/json" \
  -d '{
    "middleware_id": 3,
    "version": "2.4.41",
    "overall_risk": "high",
    "risks": [
      { "cve_id": "CVE-2021-41773", "severity": "critical",
        "summary": "...", "source_url": "https://..." }
    ]
  }'