typress
An editorial workshop.EN

脅威フィードを配る

自分で脅威フィードを運営する方法です。フィードは署名つきの 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 か theme
  • severity: low / medium / high / critical
  • reference: 詳しい説明の 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 7d

feed.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 までです。
  • 通し番号が前より小さいもの、同じ番号で中身が違うもの、期限切れのものは受け付けません。
  • ファイルの指紋が完全に一致したものだけを止めます。少しでも書き換えた別の版は、フィードに載るまで止まりません。