HN 日本語サマリー

← 一覧へ戻る
セキュリティ

NetBSDにおけるracoon2 IKEデーモンの改善と安定化

Improving and Stabilizing the Racoon2 IKE Daemon in NetBSD (blog.netbsd.org)

15 pointsby jaypatelani8 コメント

要約

Google Summer of Code 2026のプロジェクトとして、NetBSDのracoon2 IKEデーモンの改善と安定化が行われました。主な成果は、IKEv1/IKEv2におけるNATトラバーサル(RFC 3947, 7296)の正確な実装、IPv6サポートの改善とデフォルト化、アドレスマクロの統一、そして自動テストフレームワークの導入です。これにより、racoon2はNAT環境下でもモダンなVPNクライアント(Windows, iOS, Android)をサポートし、より信頼性の高いL2TP/IPsecまたはIKEv2 VPNサーバーとして機能するようになりました。

全文翻訳

Google Summer of Code 2026 レポート:NetBSDのracoon2 IKEデーモンの改善と安定化

2026年10月03日 投稿者: Leonardo Taccari

このレポートは、Google Summer of Code 2026の一環としてArtem Belanによって作成されました。

はじめに & 説明

racoon2は、IPsecのセキュリティパラメータを交換・インストールするためのシステムです。IKEv1/IKEv2鍵交換デーモン、セキュリティポリシー管理デーモン、およびKerberosベースの鍵交換デーモンで構成されています。プロジェクトはzoulasc/racoon2で開発されており、NetBSDおよびLinux上で、Windows、iOS、Androidの組み込みVPNクライアント向けの信頼性の高いL2TP/IPsecまたはIKEv2 VPNサーバーとして機能するように近代化が進められています。

このGSoCプロジェクトの目標は、TODOリストを完了することでした。具体的には、関連RFCに従ってIKEv1とIKEv2の両方でNATトラバーサルを適切に実装し、IPv6が正常に機能するようにしてIPv4とIPv6の両方でracoon2をテストできるようにし、アドレスマクロの混乱を解消し、修正が永続するように単体テストフレームワークを構築することです。最終的には、デーモンはNATデバイスの背後に配置され、設定に回避策のセレクターなしで最新のVPNクライアントを提供できるようになり、IPv6はすぐに使用可能になり、変更は自動テストスイートによって保護されます。

すべての作業はgsoc2026ブランチで行われ、2026年6月から9月の間にプルリクエスト#13–#39を通じてアップストリームにマージされました。

実施内容

IKEフラグメンテーション (RFC 7383)

TODOの言葉を借りれば、フラグメンテーションコードは「古く、不完全」でした。再構築されたメッセージはデーモンによって誤認識される可能性があり、大きすぎるパケットはデーモンをクラッシュさせる可能性がありました。プロジェクトの結果として、送信側と受信側の両方でIKEv1/IKEv2のRFC 7383フラグメンテーションが信頼できるようになりました。大きなIKEメッセージは正しく分割・再構築され、許可されたフラグメントサイズを超えるパケットはクラッシュではなく明確なログメッセージで拒否されるようになり、ピア間で大きなメッセージ(証明書、大きな提案など)を交換する際のサイレントな失敗やデーモンのダウンがなくなりました。

IKEv1クイックモードでのNAT-OAペイロード (RFC 3947)

夏の初めには、デーモンは入力時にNATオリジナルアドレスペイロードを無視し、ピアに送信することはありませんでした。その結果、カーネルはNATの背後にあるクライアントが実際に使用したアドレスを知ることができず、パケット全体でチェックサムを再計算する必要がありました。これは遅く、RFC 3947が規定することではありませんでした。現在では、NAT-OAペイロードはRFCの構造に一致し、クイックモードで構築・送信され、受信時には位置に基づいて解析されます(ローカルアドレスが最初、ピアアドレスが2番目)。ピアからのペイロードの欠落はエラーとして扱われるのではなく、許容されます。オリジナルアドレスはカーネルにも渡されるため、カーネルは完全な再計算ではなく、増分チェックサム修正を実行できます。

NAT-Tトランスポートモードでのアドレス置換 (RFC 7296 §2.23.1)

これはプロジェクトの核心であり、長年のTODO項目への直接的な回答でした。NATデバイスが経路にある場合、ピアがフェーズ2で提案したアドレスがレスポンダーの設定セレクターと一致しなかったため、レスポンダーはセレクターチェックを通過するためだけに、イニシエーター側でのみ有効な追加セレクターを必要としました。transport_ike_natt.confのような設定は回避策としてそれらを保持しており、実際のクライアントからの接続は脆弱なままでした。最終的な動作はRFC 7296 §2.23.1に従います。NAT-Tが有効で、ワイヤ上で観測されたアドレスが設定されたセレクターと一致しない場合、観測されたアドレスがネゴシエートされたセレクターに置換されます。これはIKEv1とIKEv2の両方で行われます。回避策のセレクターは不要になり、デーモンは専用UDPポート(初期ポートだけでなく)でNAT-Tトラフィックを適切に処理するようになりました。

設定におけるアドレスマクロ

TODOの言葉を借りれば、ワイルドカードアドレスマクロは「設定関連の多くのバグの原因」でした。IKEv1設定で機能したものがIKEv2でサイレントに誤動作する可能性があり、あるマクロはコードパスによってはワイルドカードとして機能し、他のパスでは「不明、判明するまで待つ」として機能し、設定ミスは報告されるのではなく無視されていました。プロジェクトでは、これらを単一の一貫したワイルドカード概念に統合し、どこでも同じように動作するようにしました。これはIKEv1とIKEv2の設定の両方で機能し、アドレスのルックアップまたは展開が失敗した場合にサイレントに失敗してユーザーにポリシーがインストールされない理由を推測させるのではなく、明確な診断情報を生成します。

IPv6サポートの修正とデフォルト有効化

racoon2には長年IPv6サポートが存在していましたが、うまく機能していませんでした。インターフェイスがすべてのアドレスを使用するように設定されていても、デーモンはあたかもインターフェイスがIPv4のみを使用するように設定されているかのように、IPv4アドレスのみが存在するかのように動作していました。また、プレフィックス長の境界ケースが壊れていたため、実際にはracoon2をIPv6でテストすることは不可能でした。プロジェクト中にこれらのバグ(アドレスマッチング、Linuxでのインターフェイスアドレス検証、プレフィックス長処理)が修正され、IPv6はモダンなデーモンが持つべきものになりました。デフォルトで使用され、設定スイッチを覚える必要はありません。プロジェクト後、同じ設定ファイルがIPv6アドレスでそのまま機能するようになり、設定側のIPv6に関するTODO項目は閉じられました。実際のIPv6トラフィックでのエンドツーエンドテストのみが残っています。

ポリシーと提案のネゴシエーション

プロジェクト前は、トランスポートモードのポリシーは汎用SAエンドポイントから生成されていましたが、SA用に設定されたアドレスからは生成されていませんでした。トンネルモードのポリシーは間違ったエンドポイントを参照する可能性があり、デーモンはピアが実際に提案したものを採用するのではなく、ネゴシエートされたIPsec提案自体を組み立てていました。これは、独自の提案を持ち込む実際のクライアントとのネゴシエーション失敗の頻繁な原因でした。現在では、トランスポートモードとトンネルモードの両方のポリシーは設定されたSAアドレスから生成され、ネゴシエートされた提案はピアの提案から構築されるため、標準のWindows、iOS、Androidクライアントとの相互運用性は、ローカル設定がすべて正しく推測することに依存しなくなりました。

IKEデーモンのための単体テストフレームワーク

プロジェクトには自動テストがまったくありませんでした。すべての変更は、コードを読み、デーモンを手動で実行して検証する必要がありました。夏の最後の期間は、この状況を変えることに費やされました。外部依存関係のない、小さく自己完結型のテストフレームワークが標準ビルドに統合され、そのテストはサニタイザーの下で実行されます。その上に、このプロジェクトで導入されたロジック(NATオリジナルアドレスペイロード処理、トラフィックセレクターアドレス置換、設定でのワイルドカードアドレス処理、ピアがパージされる際に使用されるアドレスマッチング)を正確にカバーする4つの新しいテストプログラムがあります。また、既存の暗号自己テストも修正され、スイート全体がクリーンにパスするようになりました。これはプロジェクト自体を超えて重要です。このフレームワークにより、まだテストがないデーモンの部分にリグレッションテストを簡単に追加できるようになります。次に誰かがそれらに取り組むとしてもです。

ドキュメント、サンプル、およびNEWS

ドキュメントとサンプル設定は古いデフォルト値を記述していたため、マニュアルは出荷時の動作と矛盾していました。古いIPv6の動作と置換前のセレクター回避策がまだ記述されていました。プロジェクトでは、ドキュメントとサンプルを新しいデフォルト値(デフォルトで使用されるIPv6、自動的に処理されるフラグメンテーション、一貫して使用されるトンネルエンドポイントとワイルドカードアドレス)と同期させ、ユーザーとダウンストリームパッケージャー向けのGSoC 2026の全作業をまとめたNEWSエントリを追加しました。

使用方法

上記で説明したすべては、ssszcmawo/racoon2のgsoc2026ブランチ(アップストリームのzoulasc/racoon2にマージ済み)にあります。試してみたい人のための簡単なツアーです。

ビルドとインストール。 リポジトリにはautotoolsソースのみが含まれているため、最初にconfigureスクリプトを再生成する必要があります。これは、doc/INSTALLに記載されているプロジェクトのCIで使用されるフローと同じです。

autoreconf -fi
./configure
make
make install

通常の開発ツールチェーン(Cコンパイラ、GNU make、autoconf、automake、libtool、flex、bison)とOpenSSLヘッダーが必要です。kinkdデーモンが必要な場合は、Kerberos 5ライブラリ(MIT krb5またはHeimdal)も必要です。オプションのパケットダンプデバッグモードでは、さらにlibpcapが必要です。Debian/Ubuntuでは、CIは上記のコマンドを実行する前に正確にautomake libtool libssl-dev libkrb5-dev libpcap-dev flex bisonをインストールします。便利なconfigureオプションは、デーモンをスキップするための--disable-iked / --disable-kinkd、標準外のKerberos用の--with-krb5=<dir>、パケットダンプ用の--enable-pcapです。--prefix=$NEWDIRは、インストールをデフォルトの/usr/localから移動します。

設定。 必要なすべてがリポジトリのsamples/の下に含まれています。.inファイルはインストール中にインストールパスが埋め込まれるテンプレートであり、シナリオフラグメントはプレーンファイルです。L2TP/IPsecトランスポートモードサーバー(このプロジェクトが対象としていたシナリオ)の場合、フローは次のようになります。

  1. samples/vals.conf.inをvals.confとして使用し、環境を設定します。MY_IPADDRESSとPEERS_IPADDRESS(またはピアのアドレスが事前に不明な場合のIP_ANYワイルドカード)、NATの背後にいる場合はMY_PUBLIC_IPADDRESS、および共有キー設定です。キー自体はpskgenで生成します。

  2. samples/racoon2.conf.inをracoon2.confとして使用します。これはvals.confとdefault.confをインクルードし、インターフェイスを定義します。サンプルにはNAT-Tがコメントアウトされており、指示が記載されています。

    interface
    {
        ike {
            MY_IP port 500;
    #       MY_IP port 4500;   # uncomment to enable NAT-T
        };
        ...
    };
    
  3. このケースtransport_ike.conf用のシナリオのinclude行のコメントを解除します。そのファイルには、remoteセクション(IKEv1およびIKEv2、事前共有キー)、セレクター、およびポリシーが含まれています。

    selector ike_trans_sel_out {
        direction outbound;
        src "${MY_IPADDRESS}" port 1701;
        dst "${PEERS_IPADDRESS}" port any;
        upper_layer_protocol "udp";
        policy_index ike_trans_policy;
    };
    ...
    policy ike_trans_policy {
        action auto_ipsec;
        remote_index ike_trans_remote;
        ipsec_mode transport;
        ipsec_level require;
        ipsec_index { ipsec_esp; };
    };
    

    そして、NATの背後にいる場合は、その独自のコメントアウトされたinclude行が、一般的なプライベートアドレス範囲用の追加セレクターを持つtransport_ike_natt.confをプルします。

注目すべき2つの詳細があります。vals.confのワイルドカードアドレス(IP_ANY)は一貫して動作するようになったため、サーバーはピアのアドレスが事前に不明な場合でも受け入れることができます。また、IPv6は同じファイルでそのまま機能するようになりました。IPv6アドレスを入力すると使用され、切り替えるスイッチはありません。

他のサンプルも同様のパターンに従います。トンネルモード用のtunnel_ike.confおよびtunnel_ike_natt.conf、Kerberosベースの鍵交換用のtransport_kink.confおよびtunnel_kink.conf、および1台のマシンで2つのデーモンを互いにテストするためのlocal-test.confです。

実行。 まずspmd(カーネルへのポリシーチャネルを所有)を起動し、次に設定ファイルを使用してikedを起動します。./configureは両方を配置し、samples/rc.d/にはNetBSDスタイルのシステム用のサービススクリプトがあります。両方が起動したら、action auto_ipsec(上記のようなもの)を持つセレクターに一致するトラフィックがネゴシエーションを自動的にトリガーします。したがって、クライアントでは、サーバーアドレスと共有キーを使用して、組み込みのWindows、iOS、またはAndroid VPNクライアントで接続するだけです。デーモンはNAT検出と実行される置換をログに記録するため、クライアントが接続しない場合に何が起こったのかを簡単に確認できます。

作業を追跡。 すべての変更は、gsoc2026ブランチのプルリクエスト#13–#39にあります。NEWSファイルには、ユーザーに表示される変更をまとめた単一のエントリがあります。トップレベルのTODOファイルには、まだ開いている項目がリストされています。「残りの作業」セクションを参照してください。

課題

  • 古い、テストされていないコード。 racoon2はWIDEプロジェクト時代から存在しており、テストがありませんでした。すべての変更は、主にコードを読み、デバッガーの下でデーモンを手動で実行し、サニタイザーを監視することによって検証する必要がありました。これは、テストフレームワークが後付けではなくプロジェクトの一部になったまさに理由です。
  • RFC準拠 vs. 動作する設定。 アドレス置換の実装には、レスポンダーがなぜそれらのイニシエーター専用の追加セレクターを必要としたのかを理解してから、それらを不要にする方法を理解する必要がありました。IKEv1ネゴシエーションの適切な時点で置換を発生させるには、数回の試行が必要でした。
  • アドレスマクロは deceptively deep。 ワイルドカードマクロは単純な名前変更のように見えましたが、一部の場所では「アドレスはまだ不明であり、カーネルポリシーは待機する必要がある」ことを意味し、他の場所ではそうではありませんでした。どちらのケースも壊すことなくそれらを統一するには、設定解析、セレクターマッチング、およびポリシー更新を注意深くトレースする必要がありました。
  • ビルドシステムの間違い。 他の場所からインポートされたデーモンのオプションビルドパッチは無害に見えましたが、ビルドを壊し、元に戻す必要がありました。これは、差分を読むだけでなく、ツリーを実際にビルドすることの重要性を思い出させます。
  • サニタイザー駆動デバッグ。 サニタイザーを有効にしてビルドすると、長年「機能していた」パスでメモリ安全性に関するバグが見つかりました。観測可能な動作を変更せずにそれらを修正するには、すべての重複バッファの所有権を注意深く追跡する必要がありました。

結果

  • すべての作業は、プルリクエスト#13–#39を通じてアップストリームのgsoc2026ブランチにマージされました。
  • racoon2ctlを除き、TODOリストのすべての項目が処理されました。フェーズ2 SA管理(1)、IKEv1のポリシー生成(3)、IPv6(4)、NAT-OAペイロード(5)、アドレス置換(6)、フラグメンテーション(7)、およびアドレスマクロの混乱(8)は完了しました。残っているのは項目2、つまり、正常な接続/切断制御ツールのみです。
  • NAT-OA、アドレス置換、ワイルドカードアドレスロジックをカバーする4つの新しいテストプログラムを備えた、自己完結型の単体テストフレームワーク。サニタイザーの下で実行される(既存の暗号自己テストを含む)フルスイートはクリーンにパスします。5つのテストプログラム中、0件の失敗です。
  • 新しいNEWSエントリ、および新しいデフォルト値に一致するドキュメントとサンプル設定。

残りの作業

トップレベルのTODOファイルに記録されており、将来の作業のために意図的に残されている項目は次のとおりです。

  • racoon2ctlツール。 イニシエーターが正常に接続および切断する方法はまだありません。デーモンにSIGTERMを送信しても、セキュリティアソシエーションが削除されたり、ピアに削除通知が送信されたりすることはありません。これはIKEv2接続では行われますが、IKEv1ではこのギャップが特に顕著です。小さな制御ツール(およびその背後にあるシャットダウン時の削除動作)があれば、racoon2は単にキルして再実行するものではなく、適切な常駐サービスのように動作するでしょう。
  • まだテストがない機能のテスト。 このプロジェクトでは、導入したロジックのテストのみを追加しました。デーモンの残りの部分(フェーズ2 SAライフサイクル、ポリシー生成、再キー設定、フラグメンテーションパス、設定パーサー全体)は、手動で実行することによってのみテストされています。それらの領域のテストでフレームワークを拡張することは自然な次のステップであり、ここで追加されたパージ関連のテストはそのための出発点として意図されています。
  • エンドツーエンドのIPv6テスト。 IPv6は設定側では機能するようになりましたが、NetBSDおよびLinuxでの実際のシナリオでは、さらに徹底的なテストが必要です。完全なIPv6トンネル、NAT-Tの相互作用、およびイニシエーターとレスポンダーの両方での長時間の接続はまだ実行されていません。

結論

このプロジェクトは「TODOリストを消化する」ことから始まり、大幅に堅牢なracoon2へと成長しました。NATトラバーサルは両方のIKEバージョンの関連RFCに従うようになり、IPv6は実際に機能しデフォルトで使用されるようになり、設定は一貫して動作し、そしておそらく長期的に最も重要なこととして、デーモンはついにサニタイザーの下で実行される自動テストスイートを持つようになりました。

開いている項目は上記の「残りの作業」セクションにまとめられています。RFCレベルの修正とリグレッションテストフレームワークの組み合わせにより、racoon2がNetBSDおよびLinux上の実際のクライアント向けの信頼できるVPNサーバーに大きく近づいたと信じています。

メンターであるChristos Zoulas氏に感謝します。この一連のプルリクエストをレビューしていただき、このプロジェクトの背景にある歴史やアドレスマクロの混乱のような奇妙な点について忍耐強く説明していただきました。また、GSoC 2026の他のメンターや学生の皆様にも感謝します。古いコードベースを掘り下げ、少し怖さを減らすという楽しい夏を過ごしました。

2件のコメント