脅威フィードを配る
自分で脅威フィードを運営する方法です。フィードは署名つきの JSON ファイルで、https で配れればどこに置いても構いません。
元のファイル
{
"format": "typress.threatfeed/1",
"sequence": 1,
"entries": [
{
"sha256": "e874f5c7...(64 桁)",
"kind": "plugin",
"label": "Example 1.0.0",
"reason": "セッション Cookie を外部に送る",
"severity": "high"
}
]
}sequence: フィードの通し番号。中身を変えるたびに上げます。kind:pluginかthemeseverity:low/medium/high/criticalreference: 詳しい説明の https の URL(任意)
署名する
bun tools/tpkg/src/main.ts keygen --label feed # 最初の 1 回
bun tools/tpkg/src/main.ts feed-sign feed.json --key feed --expires 7dfeed.signed.json ができるので、これを配信します。購読する人には、最後に表示される公開鍵を伝えてください。
有効期限と更新
署名には有効期限が入ります(--expires、既定 7 日、最大 90 日)。期限が切れると購読している全サイトで警告が出るので、中身が変わらなくても期限前に署名し直します。--bump を付けると通し番号を上げて元のファイルにも書き戻すので、cron で回すだけで済みます。
0 */6 * * * cd /srv/feed && bun /path/to/tpkg feed-sign feed.json --key feed --expires 1d --bump && rsync feed.signed.json web:/var/www/feed/- 期限の長さは「配信を止められても気づけない最長期間」になります。短いほど早く気づけますが、署名し直しを忘れると全サイトに警告が出ます。
- 署名し直しは、期限よりかなり短い間隔で回してください(例: 期限 1 日なら数時間ごと)。
- 署名鍵は配信サーバーに置かず、別のマシンで署名してファイルだけ送ってください。
制限
- エントリは 10 万件まで、ファイルは 5 MiB までです。
- 通し番号が前より小さいもの、同じ番号で中身が違うもの、期限切れのものは受け付けません。
- ファイルの指紋が完全に一致したものだけを止めます。少しでも書き換えた別の版は、フィードに載るまで止まりません。