EMail.html 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260
  1. <!DOCTYPE html>
  2. <html lang="en">
  3. <head>
  4. <meta charset="UTF-8">
  5. <title>Email | 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/EMail.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 / Email</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. <p>Running email in dn42 is not very complicated. Your SMTP daemon probably already listens on the wildcard address, so you mostly need to:</p>
  27. <ul>
  28. <li>open your firewall to allow TCP/25 from dn42</li>
  29. <li>setup DNS (MX records, or simply relevant A records)</li>
  30. <li>configure your mail server if needed</li>
  31. </ul>
  32. <h2 id="redirect">Redirect</h2>
  33. <p><del>There are forwarding rules for <em>PERSON</em> @ dn42.org to the mail addresses which have been given in the registry. Please note that the trailing <code class="language-plaintext highlighter-rouge">-DN42</code> is stripped from the local part.</del></p>
  34. <h3 id="example">Example</h3>
  35. <table>
  36. <thead>
  37. <tr>
  38. <th style="text-align: left">Handle</th>
  39. <th style="text-align: left">Alias</th>
  40. <th style="text-align: left">Redirection</th>
  41. </tr>
  42. </thead>
  43. <tbody>
  44. <tr>
  45. <td style="text-align: left"><code class="language-plaintext highlighter-rouge">STV0G-DN42</code></td>
  46. <td style="text-align: left">stv0g@dn42.org</td>
  47. <td style="text-align: left"><code class="language-plaintext highlighter-rouge">post@steffenvogel.de</code></td>
  48. </tr>
  49. </tbody>
  50. </table>
  51. <h2 id="test-email">Test email</h2>
  52. <p><del>Send an email to <code class="language-plaintext highlighter-rouge">test@evenet.dn42</code> to check if your mail setup is correct.</del> This host will reply using the following
  53. sieve filter:</p>
  54. <div class="language-conf highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">require</span> [<span class="s2">"regex"</span>, <span class="s2">"variables"</span>, <span class="s2">"vacation-seconds"</span>];
  55. <span class="n">if</span> <span class="n">header</span> :<span class="n">contains</span> <span class="s2">"To"</span> [<span class="s2">"test@evenet.dn42"</span>] {
  56. <span class="n">if</span> <span class="n">header</span> :<span class="n">matches</span> <span class="s2">"Subject"</span> <span class="s2">"*"</span> {
  57. <span class="n">set</span> <span class="s2">"subject_was"</span> <span class="s2">": ${1}"</span>;
  58. }
  59. <span class="n">vacation</span> :<span class="n">addresses</span> [<span class="s2">"test@evenet.dn42"</span>] :<span class="n">seconds</span> <span class="m">60</span> :<span class="n">subject</span> <span class="s2">"Re: ${subject_was}"</span> <span class="s2">"Your dn42 email setup works!"</span>;
  60. }
  61. </code></pre></div></div>
  62. <h2 id="exim-tips">Exim tips</h2>
  63. <h3 id="sending-emails">Sending emails</h3>
  64. <p>By default on Debian, Exim refuses to send mail to other mailservers when they resolve to RFC1918 addresses. This will manifest by the following error message when trying to send a mail:</p>
  65. <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>** foo@bar.dn42: all relevant MX records point to non-existent hosts
  66. </code></pre></div></div>
  67. <p>This is controlled by the <code class="language-plaintext highlighter-rouge">ignore_target_hosts</code> variable in the configuration file.</p>
  68. <h3 id="receiving-emails">Receiving emails</h3>
  69. <p>Don’t forget to add your dn42 domains to the list of local domains, so that you accept incoming emails. On Debian, it is controlled by <code class="language-plaintext highlighter-rouge">dc_other_hostnames</code> in <code class="language-plaintext highlighter-rouge">update-exim4.conf.conf</code>. For instance:</p>
  70. <div class="language-conf highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">dc_other_hostnames</span>=<span class="s1">'myself.org;myself.dn42;myserver.myself.dn42'</span>
  71. </code></pre></div></div>
  72. <h2 id="postfix">Postfix</h2>
  73. <h3 id="sending-mails">Sending Mails</h3>
  74. <p>If your machine sends/receives Mails in “clearnet” with specific bound IP’s you need to create an additional transport in master.cf</p>
  75. <div class="language-conf highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">out_dn42</span> <span class="n">unix</span> - - <span class="n">n</span> - - <span class="n">smtp</span>
  76. -<span class="n">o</span> <span class="n">smtp_bind_address</span>=<span class="m">172</span>.<span class="m">23</span>.<span class="m">67</span>.<span class="m">1</span>
  77. -<span class="n">o</span> <span class="n">smtp_bind_address6</span>=<span class="n">fd70</span>:<span class="m">96</span><span class="n">c9</span>:<span class="n">ef25</span>::<span class="m">1</span>
  78. -<span class="n">o</span> <span class="n">smtp_helo_name</span>=<span class="n">ns1</span>.<span class="n">mhm</span>.<span class="n">dn42</span>
  79. -<span class="n">o</span> <span class="n">syslog_name</span>=<span class="n">postfix</span>-<span class="n">dn42</span>
  80. </code></pre></div></div>
  81. <p>and add this transport to /etc/postfix/transport for dn42 (and dont forget to postmap)</p>
  82. <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>.dn42 out_dn42:
  83. </code></pre></div></div>
  84. <p>This should to the trick for sending mails via your DN42-IP</p>
  85. <p>If you use <code class="language-plaintext highlighter-rouge">smtpd_recipient_restrictions</code> you can use the following rule to white-list dn42 as sender.
  86. This can circumvent certain rdns configuration failure or in case you use rbl lists:</p>
  87. <div class="language-conf highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">smtpd_recipient_restrictions</span> = <span class="n">permit_mynetworks</span>,
  88. <span class="n">permit_sasl_authenticated</span>,
  89. <span class="n">check_client_access</span> <span class="n">cidr</span>:/<span class="n">etc</span>/<span class="n">postfix</span>/<span class="n">dn42</span>.<span class="n">cidr</span>,
  90. <span class="n">reject_non_fqdn_sender</span>,
  91. <span class="c"># ...
  92. </span> <span class="n">permit</span>
  93. </code></pre></div></div>
  94. <div class="language-conf highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c">#/etc/postfix/dn42.cidr
  95. </span><span class="m">172</span>.<span class="m">16</span>.<span class="m">0</span>.<span class="m">0</span>/<span class="m">12</span> <span class="n">OK</span>
  96. <span class="m">10</span>.<span class="m">0</span>.<span class="m">0</span>.<span class="m">0</span>/<span class="m">8</span> <span class="n">OK</span>
  97. <span class="n">fc00</span>::/<span class="m">7</span> <span class="n">OK</span>
  98. </code></pre></div></div>
  99. <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>postmap /etc/postfix/dn42.cidr
  100. </code></pre></div></div>
  101. <h3 id="receiving-emails-1">Receiving emails</h3>
  102. <p>The Domain mails should be received for has to be added to <code class="language-plaintext highlighter-rouge">mydestination =</code> in main.cf</p>
  103. <h2 id="new-smtp-rfc-smtputf8">New SMTP RFC SMTPUTF8</h2>
  104. <h3 id="eai">EAI</h3>
  105. <p>Email Address Internationalization (EAI) as defined in <a href="http://tools.ietf.org/html/rfc6531">RFC 6531</a> (SMTPUTF8 extension), <a href="http://tools.ietf.org/html/rfc6532">RFC 6532</a> (Internationalized email headers) and <a href="http://tools.ietf.org/html/rfc6533">RFC 6533</a> (Internationalized delivery status notifications).</p>
  106. <h3 id="postfix-1">Postfix</h3>
  107. <p>Introduced with Postfix version 3.0, this fully supports UTF-8 email addresses and UTF-8 message header values.
  108. more at the <a href="http://www.postfix.org/SMTPUTF8_README.html">SMTPUTF8_README</a>.</p>
  109. <h3 id="exim">Exim</h3>
  110. <p>Watch Exims EAI Tracker <a href="http://bugs.exim.org/show_bug.cgi?id=1177">Bug 1177</a></p>
  111. <div id="menu-container" class="menu-container">
  112. <hr>
  113. <div id="menu" class="menu">
  114. <ul>
  115. <li><a href="/Home">Home</a>
  116. <ul>
  117. <li><a href="/howto/Getting-Started">Getting Started</a></li>
  118. <li><a href="/howto/Registry-Authentication">Registry Authentication</a></li>
  119. <li><a href="/howto/Address-Space">Address Space</a></li>
  120. <li><a href="/howto/BGP-communities">BGP communities</a></li>
  121. <li><a href="/FAQ">FAQ</a></li>
  122. </ul>
  123. </li>
  124. <li>How-To
  125. <ul>
  126. <li><a href="/howto/wireguard">Wireguard</a></li>
  127. <li><a href="/howto/openvpn">Openvpn</a></li>
  128. <li><a href="/howto/IPsec-with-PublicKeys">IPsec With Public Keys</a></li>
  129. <li><a href="/howto/tinc">Tinc</a></li>
  130. <li><a href="/howto/GRE-on-FreeBSD">GRE on FreeBSD</a></li>
  131. <li><a href="/howto/GRE-on-OpenBSD">GRE on OpenBSD</a></li>
  132. <li><a href="/howto/IPv6-Multicast">IPv6 Multicast (PIM-SM)</a></li>
  133. <li><a href="/howto/multicast">SSM Multicast</a></li>
  134. <li><a href="/howto/mpls">MPLS</a></li>
  135. <li><a href="/howto/Bird2">Bird2</a></li>
  136. <li><a href="/howto/frr">FRRouting</a></li>
  137. <li><a href="/howto/OpenBGPD">OpenBGPD</a></li>
  138. <li><a href="/howto/mikrotik">Mikrotik RouterOS</a></li>
  139. <li><a href="/howto/EdgeOS-Config">EdgeRouter</a></li>
  140. <li><a href="/howto/Static-routes-on-Windows">Static routes on Windows</a></li>
  141. <li><a href="/howto/networksettings">Universal Network Requirements</a></li>
  142. <li><a href="/howto/vyos1.4.x">VyOS</a></li>
  143. <li><a href="/howto/nixos">NixOS</a></li>
  144. </ul>
  145. </li>
  146. <li>Services
  147. <ul>
  148. <li><a href="/services/IRC">IRC</a></li>
  149. <li><a href="/services/Whois">Whois registry</a></li>
  150. <li><a href="/services/DNS">DNS</a></li>
  151. <li><a href="/services/IX-Collection">IX Collection</a></li>
  152. <li><a href="/services/Clearnet-Domains">Public DNS</a></li>
  153. <li><a href="/services/Looking-Glasses">Looking Glasses</a></li>
  154. <li><a href="/services/Automatic-Peering">Automatic Peering</a></li>
  155. <li><a href="/services/Repository-Mirrors">Repository Mirrors</a></li>
  156. <li><a href="/services/Distributed-Wiki">Distributed Wiki</a></li>
  157. <li><a href="/services/Certificate-Authority">Certificate Authority</a></li>
  158. <li><a href="/services/Route-Collector">Route Collector</a></li>
  159. </ul>
  160. </li>
  161. <li>Internal
  162. <ul>
  163. <li><a href="/internal/Internal-Services">Internal services</a></li>
  164. <li><a href="/internal/Interconnections">Interconnections</a></li>
  165. <li><a href="/internal/APIs">APIs</a></li>
  166. <li><a href="/internal/ShowAndTell">Show and Tell</a></li>
  167. <li><a href="/internal/Historical-Services">Historical services</a></li>
  168. </ul>
  169. </li>
  170. <li>Historical
  171. <ul>
  172. <li><a href="/historical/Bird">Bird 1</a></li>
  173. <li><a href="/historical/Quagga">Quagga</a></li>
  174. </ul>
  175. </li>
  176. <li>External Tools
  177. <ul>
  178. <li><a href="https://paste.dn42.us">Paste Board</a></li>
  179. <li><a href="https://git.dn42.dev">Git Repositories</a></li>
  180. </ul>
  181. </li>
  182. </ul>
  183. <hr />
  184. </div>
  185. </div>
  186. </main>
  187. <footer><div class="center">
  188. <div id="dn42_footer">
  189. <table>
  190. <tbody>
  191. <tr>
  192. <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>
  193. <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>
  194. </tr>
  195. </tbody>
  196. </table>
  197. </div>
  198. </div>
  199. </footer>
  200. </body>
  201. </html>