clawsec/wiki/ja/data-flow.md at main

mirror of https://github.com/prompt-security/clawsec.git synced 2026-06-13 05:28:02 +03:00

Files

T

David Abutbul b37162a33d feat(i18n): add multilingual wiki scaffolding, language switcher, and… (#212 )

* feat(i18n): add multilingual wiki scaffolding, language switcher, and translation QA pipeline

* docs(readme): adopt picoclaw-style multilingual link bar

* fix(i18n): repair localized index links and tighten partial-pair QA

* ci(i18n): fail on broken markdown links in README/wiki

* ci(i18n): add changed-files mode for markdown link checks

* i18n(de): use local Argos MT to fill untranslated German sections

* i18n(es,fr): fill untranslated sections via local Argos workflow

* i18n(ja): fill untranslated sections with scoped local Argos pass

* i18n(ko): fill untranslated sections with scoped local Argos pass

* fix(i18n): address review feedback

---------

Co-authored-by: David Abutbul <David.a@prompt.security>

2026-04-29 09:00:31 +03:00

7.6 KiB

Raw Permalink Blame History

ツイートデータフロー

プライマリフロー

Advisory ingestion:NVD/communityの入力は顧客のために、署名された正常化された諮問的な供給に変えられます。
Skill catalog publication: リリースアセットが発見され、public/skills/index.jsonとパースキルのドキュメント/チェックサムに変換されます。
Runtime enforcement: スイートとナノクローの消費者は、アドバイザリーデータをロードし、スキルと一致し、アラートや確認ゲートを発します。
- - このページは、INDEX.mdのGuidesセクションで表示されます。

ステップバイステップ

1。フィードプロデューサーワークフロー/スクリプトフェッチソースデータ (NVD API または発行ペイロード). 2。 JSON は、ロジックが重度/種類/影響領域を正規化し、アドバイザリー ID による重複排除を行います。 3。シグネチャー/チェックサムのステップは、分離されたシグネチャとチェックサムマニフェストを生成します。 4。 public/とpublic/releases/latest/download/でワークフローミラー署名済みのアーティファクトを展開します。 5。 UI 消費者は JSON 形状/コンテンツを検証します。ランタイムの消費者は、フィードデータを信頼する前に、署名/チェックサムを検証します。 6。 Matchers は、affected の仕様をスキル名/バージョンに比較し、アラートを発したり、確認を強制したりします。

入力と出力

入力/出力は下の表でまとめられます。

##ダイアグラム

flowchart LR
  A["NVD + Issue Inputs"] --> B["Transform + Deduplicate"]
  B --> C["advisories/feed.json"]
  C --> D["Sign + checksums"]
  D --> E["public/advisories + releases/latest"]
  E --> F["Web UI fetch"]
  E --> G["Suite/NanoClaw verification"]
  G --> H["Match skills + emit alerts/gates"]

状態とストレージ

サンプルスニペット

# Local feed flow (NVD fetch -> transform -> sync)
./scripts/populate-local-feed.sh --days 120
jq '.updated, (.advisories | length)' advisories/feed.json

# Runtime guarded install uses signed feed paths
CLAWSEC_LOCAL_FEED=~/.openclaw/skills/clawsec-suite/advisories/feed.json \
CLAWSEC_FEED_PUBLIC_KEY=~/.openclaw/skills/clawsec-suite/advisories/feed-signing-public.pem \
node skills/clawsec-suite/scripts/guarded_skill_install.mjs --skill test-skill --dry-run

失敗モード

NVD率の限界(403/429)は送りを遅らせ、retries/backoffを要求できます。
欠損または無効な離脱署名により、異常終了モードのフィード拒否が発生します。
JSONエンドポイントのHTMLフォールバック応答は、明示的にフィルタリングされていない限り、偽陽性を生成できます。
パストークンの誤設定(\$HOME)は、ローカルのフォールバックパスの解像度を破ることができます。
ワークフローで公開鍵のフィンガープリントをミスマッチして、ハードなCI障害が発生します。

ソース参照

アドバイザリー/フィード.json
アドバイザリー/フィード.json.sig
スクリプト/populate-local-feed.sh
スクリプト/populate-local-skills.sh
.github/workflows/poll-nvd-cves.yml
.github/workflows/community-advisory.yml
.github/workflows/deploy-pages.yml
.github/workflows/skill-release.yml
スキル/ clawsec-suite/hooks/clawsec-advisory-guardian/lib/feed.mjs
スキル/クローセスイート/ホック/クローセ-アドバイザー/lib/state.ts
スキル/クローセスイート/ホック/クローセ管理人/lib/matching.ts
スキル/clawsec-suite/scripts/guarded_skill_install.mjs
スキル/クローセ・ナンクロー/lib/advisories.ts
スキル/法律/犯罪サービス/アドバイザー/キャッシュ.ts

7.6 KiB Raw Permalink Blame History