IPsec-on-FreeBSD.html 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220
  1. <!DOCTYPE html>
  2. <html lang="en">
  3. <head>
  4. <meta charset="UTF-8">
  5. <title>IPsec on FreeBSD | dn42 wiki</title>
  6. <meta name="viewport" content="width=device-width, initial-scale=1.0">
  7. <meta name="robots" content="index, follow">
  8. <meta name="keywords" content="dn42,wiki,routing,bgp">
  9. <link rel="canonical" href="https://dn42.obl.ong/howto/IPsec-on-FreeBSD.html">
  10. <link rel="icon" type="image/x-icon" href="/favicon.ico">
  11. <link rel="shortcut icon" type="image/x-icon" href="/favicon.ico">
  12. <link rel="author" type="text/html" href="/docs/people">
  13. <link rel="stylesheet" href="/css/normalize.css">
  14. <link rel="stylesheet" href="/css/simple.min.css">
  15. <link rel="stylesheet" href="/css/style.css">
  16. <link rel="stylesheet" href="/css/menu.css">
  17. </head>
  18. <body>
  19. <header>
  20. <b>dn42 wiki / IPsec on FreeBSD</b>
  21. <div id="dn42_header">
  22. <p><a href="/"><img src="/dn42.png" alt="dn42" /></a></p>
  23. </div>
  24. </header>
  25. <main>
  26. <h1 id="ipsec-on-freebsd">IPsec on FreeBSD</h1>
  27. <p>These instructions are for IPsec in transport mode not IPsec in tunnel mode. IPsec in tunnel mode requires a too tight coupling with the routing table for dynamic routing because the policies can only be specified based on source/destination address and protocol not based on interfaces.</p>
  28. <h2 id="requirements">Requirements</h2>
  29. <ul>
  30. <li>Root access to both endpoints.</li>
  31. <li>Static IPv4 addresses for both endpoints unless you want to write a small shell script as hook for racoon.</li>
  32. <li>At least one static IPv4 on at least one endpoint unless you hate yourself.</li>
  33. </ul>
  34. <h2 id="kernel-configuration">Kernel configuration</h2>
  35. <p>The FreeBSD GENERIC kernel lacks support for in-kernel IPsec processing. Add this two lines to your kernel config and (re-)build your own kernel.
  36. If you’re new to FreeBSD check Chapters <a href="http://www.freebsd.org/doc/handbook/ipsec.html">15.9.1</a> and <a href="http://www.freebsd.org/doc/handbook/kernelconfig.html">9</a> of the FreeBSD handbook.</p>
  37. <div class="language-conf highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">options</span> <span class="n">IPSEC</span> <span class="c">#IP security
  38. </span><span class="n">device</span> <span class="n">crypto</span>
  39. </code></pre></div></div>
  40. <p>Reboot into your new kernel.</p>
  41. <h2 id="userland-configuration">Userland configuration</h2>
  42. <p>Install the racoon daemon. It’s included in the <a href="http://www.freshports.org/security/ipsec-tools/">security/ipsec-tools</a> port.
  43. Racoon is pain in the ass to configure the first time because it’s error messages aren’t helping and the complexity of IPsec. Don’t let this stop you.</p>
  44. <div class="language-conf highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">path</span> <span class="n">pre_shared_key</span> <span class="s2">"/usr/local/etc/racoon/psk"</span>;
  45. <span class="n">path</span> <span class="n">certificate</span> <span class="s2">"/usr/local/etc/racoon/certs"</span>;
  46. <span class="n">log</span> <span class="n">info</span>;
  47. <span class="n">listen</span> {
  48. <span class="n">isakmp</span> <span class="n">a</span>.<span class="n">b</span>.<span class="n">c</span>.<span class="n">d</span> [<span class="m">500</span>];
  49. <span class="n">isakmp_natt</span> <span class="n">a</span>.<span class="n">b</span>.<span class="n">c</span>.<span class="n">d</span> [<span class="m">4500</span>];
  50. }
  51. <span class="n">padding</span> {
  52. <span class="n">strict_check</span> <span class="n">on</span>;
  53. }
  54. <span class="n">timer</span> {
  55. <span class="n">natt_keepalive</span> <span class="m">5</span> <span class="n">sec</span>;
  56. <span class="n">interval</span> <span class="m">3</span> <span class="n">sec</span>;
  57. <span class="n">phase1</span> <span class="m">45</span> <span class="n">sec</span>; <span class="c"># give embedded CPUs time to finish RSA operations
  58. </span> <span class="n">phase2</span> <span class="m">45</span> <span class="n">sec</span>;
  59. }
  60. <span class="n">remote</span> <span class="n">b</span>.<span class="n">c</span>.<span class="n">d</span>.<span class="n">e</span> [<span class="m">500</span>] {
  61. <span class="n">exchange_mode</span> <span class="n">main</span>;
  62. <span class="n">proposal_check</span> <span class="n">strict</span>;
  63. <span class="n">my_identifier</span> <span class="n">asn1dn</span>;
  64. <span class="n">peers_identifier</span> <span class="n">asn1dn</span>;
  65. <span class="n">lifetime</span> <span class="n">time</span> <span class="m">1</span> <span class="n">hour</span>;
  66. <span class="n">certificate_type</span> <span class="n">x509</span> <span class="s2">"self.crt"</span> <span class="s2">"self.key"</span>;
  67. <span class="n">peers_certfile</span> <span class="n">x509</span> <span class="s2">"peer.crt"</span>;
  68. <span class="n">ca_type</span> <span class="n">x509</span> <span class="s2">"ca.crt"</span>;
  69. <span class="n">verify_cert</span> <span class="n">on</span>;
  70. <span class="n">send_cert</span> <span class="n">off</span>; <span class="c"># neither send
  71. </span> <span class="n">send_cr</span> <span class="n">off</span>; <span class="c"># nor request a crt to be send
  72. </span>
  73. <span class="n">proposal</span> {
  74. <span class="n">encryption_algorithm</span> <span class="n">aes</span> <span class="m">256</span>;
  75. <span class="n">hash_algorithm</span> <span class="n">sha256</span>;
  76. <span class="n">authentication_method</span> <span class="n">rsasig</span>;
  77. <span class="n">dh_group</span> <span class="n">modp4096</span>;
  78. }
  79. }
  80. <span class="n">sainfo</span> (<span class="n">address</span> <span class="n">a</span>.<span class="n">b</span>.<span class="n">c</span>.<span class="n">d</span> <span class="n">gre</span> <span class="n">address</span> <span class="n">b</span>.<span class="n">c</span>.<span class="n">d</span>.<span class="n">e</span> <span class="n">gre</span>) {
  81. <span class="n">pfs_group</span> <span class="n">modp4096</span>;
  82. <span class="n">lifetime</span> <span class="n">time</span> <span class="m">1</span> <span class="n">hour</span>;
  83. <span class="n">encryption_algorithm</span> <span class="n">aes</span> <span class="m">256</span>;
  84. <span class="n">authentication_algorithm</span> <span class="n">hmac_sha1</span>;
  85. }
  86. </code></pre></div></div>
  87. <div id="menu-container" class="menu-container">
  88. <hr>
  89. <div id="menu" class="menu">
  90. <ul>
  91. <li><a href="/Home">Home</a>
  92. <ul>
  93. <li><a href="/howto/Getting-Started">Getting Started</a></li>
  94. <li><a href="/howto/Registry-Authentication">Registry Authentication</a></li>
  95. <li><a href="/howto/Address-Space">Address Space</a></li>
  96. <li><a href="/howto/BGP-communities">BGP communities</a></li>
  97. <li><a href="/FAQ">FAQ</a></li>
  98. </ul>
  99. </li>
  100. <li>How-To
  101. <ul>
  102. <li><a href="/howto/wireguard">Wireguard</a></li>
  103. <li><a href="/howto/openvpn">Openvpn</a></li>
  104. <li><a href="/howto/IPsec-with-PublicKeys">IPsec With Public Keys</a></li>
  105. <li><a href="/howto/tinc">Tinc</a></li>
  106. <li><a href="/howto/GRE-on-FreeBSD">GRE on FreeBSD</a></li>
  107. <li><a href="/howto/GRE-on-OpenBSD">GRE on OpenBSD</a></li>
  108. <li><a href="/howto/IPv6-Multicast">IPv6 Multicast (PIM-SM)</a></li>
  109. <li><a href="/howto/multicast">SSM Multicast</a></li>
  110. <li><a href="/howto/mpls">MPLS</a></li>
  111. <li><a href="/howto/Bird2">Bird2</a></li>
  112. <li><a href="/howto/frr">FRRouting</a></li>
  113. <li><a href="/howto/OpenBGPD">OpenBGPD</a></li>
  114. <li><a href="/howto/mikrotik">Mikrotik RouterOS</a></li>
  115. <li><a href="/howto/EdgeOS-Config">EdgeRouter</a></li>
  116. <li><a href="/howto/Static-routes-on-Windows">Static routes on Windows</a></li>
  117. <li><a href="/howto/networksettings">Universal Network Requirements</a></li>
  118. <li><a href="/howto/vyos1.4.x">VyOS</a></li>
  119. <li><a href="/howto/nixos">NixOS</a></li>
  120. </ul>
  121. </li>
  122. <li>Services
  123. <ul>
  124. <li><a href="/services/IRC">IRC</a></li>
  125. <li><a href="/services/Whois">Whois registry</a></li>
  126. <li><a href="/services/DNS">DNS</a></li>
  127. <li><a href="/services/IX-Collection">IX Collection</a></li>
  128. <li><a href="/services/Clearnet-Domains">Public DNS</a></li>
  129. <li><a href="/services/Looking-Glasses">Looking Glasses</a></li>
  130. <li><a href="/services/Automatic-Peering">Automatic Peering</a></li>
  131. <li><a href="/services/Repository-Mirrors">Repository Mirrors</a></li>
  132. <li><a href="/services/Distributed-Wiki">Distributed Wiki</a></li>
  133. <li><a href="/services/Certificate-Authority">Certificate Authority</a></li>
  134. <li><a href="/services/Route-Collector">Route Collector</a></li>
  135. </ul>
  136. </li>
  137. <li>Internal
  138. <ul>
  139. <li><a href="/internal/Internal-Services">Internal services</a></li>
  140. <li><a href="/internal/Interconnections">Interconnections</a></li>
  141. <li><a href="/internal/APIs">APIs</a></li>
  142. <li><a href="/internal/ShowAndTell">Show and Tell</a></li>
  143. <li><a href="/internal/Historical-Services">Historical services</a></li>
  144. </ul>
  145. </li>
  146. <li>Historical
  147. <ul>
  148. <li><a href="/historical/Bird">Bird 1</a></li>
  149. <li><a href="/historical/Quagga">Quagga</a></li>
  150. </ul>
  151. </li>
  152. <li>External Tools
  153. <ul>
  154. <li><a href="https://paste.dn42.us">Paste Board</a></li>
  155. <li><a href="https://git.dn42.dev">Git Repositories</a></li>
  156. </ul>
  157. </li>
  158. </ul>
  159. <hr />
  160. </div>
  161. </div>
  162. </main>
  163. <footer><div class="center">
  164. <div id="dn42_footer">
  165. <table>
  166. <tbody>
  167. <tr>
  168. <td>Hosted by: <a href="mailto:dn42@burble.com">BURBLE-MNT</a>, <a href="mailto:nurtic-vibe@grmml.net">GRMML-MNT</a>, <a href="mailto:xuu@dn42.us">XUU-MNT</a>, <a href="mailto:janeric@ortgies.it">JAN-MNT</a>, <a href="mailto:lare@lare.cc">LARE-MNT</a>, <a href="mailto:danny@saru.moe">SARU-MNT</a>, <a href="mailto:androw95220@gmail.com">ANDROW-MNT</a>, <a href="mailto:dn42@mk16.de">MARK22K-MNT</a></td>
  169. <td>Accessible via: <a href="https://wiki.dn42">dn42</a>, <a href="https://dn42.dev/">dn42.dev</a>, <a href="https://dn42.eu/">dn42.eu</a>, <a href="https://wiki.dn42.us/">wiki.dn42.us</a>, <a href="https://dn42.de/">dn42.de</a> (IPv6-only), <a href="https://dn42.cc/">dn42.cc</a> (wiki-ng), <a href="https://dn42.wiki/">dn42.wiki</a>, <a href="https://dn42.pp.ua/">dn42.pp.ua</a>, <a href="https://dn42.obl.ong/">dn42.obl.ong</a></td>
  170. </tr>
  171. </tbody>
  172. </table>
  173. </div>
  174. </div>
  175. </footer>
  176. </body>
  177. </html>