SanDssrf — Node.js のための SSRF 封じ込め

プロジェクト概要

遮断するのではなく、封じ込める。SSRF 防御の新時代。

SanDssrf は、私自身の DSSRF を含む SSRF 対策を攻撃するなかで何度も突き当たった問題への答えです。DSSRF のようなライブラリは URL を検証してからリクエストを通しますが、どれもパーサーディファレンシャル、DNS リバインディング、あるいは誰もリストに載せていなかった IPv6 表記で破られ得ます。SanDssrf は検証をやめ、封じ込めます。ユーザーが指定した URL への接続は、シミュレートされた内部ネットワークを持つ Linux ネットワーク名前空間の内側から行われます。宛先が内部アドレスなら Linux カーネルが無害なおとりへルーティングし、公開アドレスなら通常どおり送信されます。誤り得る範囲チェックも勝てる競合も存在しないため、バイパスの攻撃クラスそのものが消滅します。しかもアプリケーション自身のデータベース、キャッシュ、内部 API はそのまま動作します。依存関係ゼロの純粋な Node.js 実装で、MIT ライセンスのもと npm に @insitetechjp/sandssrf として公開しています。

数行で導入

信頼できない URL を取得する箇所だけに、サンドボックスの Agent を渡します。http／https 向けの Agent に加え、HTTP 以外のプロトコル向けに sandbox.connect() も提供しています。TLS 証明書は引き続きホスト名で検証されます。

const { createSSRFSandbox } = require('@insitetechjp/sandssrf');

const sandbox = createSSRFSandbox();
const agent   = sandbox.Agent();

sandbox.on('blocked', (e) => log.warn('SSRF attempt', e));

// user-supplied URL — contained
await fetchWith(agent, userUrl);

// everything else is untouched
await pgcon.query('select 1');

限界を正直に明記

「限界を隠すセキュリティライブラリは、存在しないよりも悪い。」

• Linux 専用です。unshare（util-linux）と ip（iproute2）、および非特権ユーザー名前空間が必要です。
• Docker の既定の seccomp プロファイルではブロックされる場合があります。その場合 ready() は黙って素通しせず、SANDSSRF_UNAVAILABLE で明示的に失敗します。
• 封じ込められるのはサンドボックスの Agent 経由で作られたソケットだけです。直接の fetch()、サブプロセス、ネイティブアドオンは対象外です。
• 公開ホストへの通信は制限しません。それには宛先の許可リストという別の対策が必要です。

SanDssrf は DSSRF の後継となる設計です。DSSRF に寄せられたアドバイザリ、そして私自身が発見し公開してきたバイパスから得た教訓を、検証ではなく封じ込めという形で実装しました。