website/templates/connect.html

58 lines
2.4 KiB
HTML

{% extends "base.html" %}
{% block title %}Connect — echoIRCd{% endblock %}
{% block content %}
<section class="page-head">
<h1>Connect</h1>
<p class="lede">Point any IRC client at the network — or open it in your browser.</p>
</section>
<section class="wrap">
<table class="detail">
<tr><th>Server</th><td class="mono">irc.echoircd.org</td></tr>
<tr><th>TLS (recommended)</th><td class="mono">6697</td></tr>
<tr><th>Plaintext</th><td class="mono">6667</td></tr>
<tr><th>Network</th><td class="mono">echoiRCd</td></tr>
</table>
<div class="webchat">
<span>Prefer the browser?</span>
<a class="btn" href="https://orbit.devtronic.pro">Open the web client &#8599;</a>
</div>
<h2 class="section-title">Client quick-start</h2>
<div class="block">
<p>Most clients accept a one-line server string. The leading <span class="mono">+</span> on the
port means TLS.</p>
<pre class="code">/server irc.echoircd.org +6697
/join #echoircd</pre>
<table class="detail">
<tr><th>HexChat</th><td class="mono">Network list → Add → irc.echoircd.org/+6697 → tick "Use SSL"</td></tr>
<tr><th>WeeChat</th><td class="mono">/server add echo irc.echoircd.org/6697 -tls</td></tr>
<tr><th>irssi</th><td class="mono">/connect -tls irc.echoircd.org 6697</td></tr>
<tr><th>mIRC</th><td class="mono">/server irc.echoircd.org +6697</td></tr>
</table>
</div>
<h2 class="section-title">Register your nick</h2>
<div class="block">
<p>Registering lets you keep your nickname, found channels, and log in with SASL.</p>
<pre class="code">/msg NickServ REGISTER &lt;password&gt; &lt;email&gt;
/msg NickServ IDENTIFY &lt;password&gt;</pre>
</div>
<h2 class="section-title">Log in with a key (ECDSA)</h2>
<div class="block">
<p>Instead of a password you can authenticate with a NIST&nbsp;P-256 key. The server sends a
challenge, your client signs it, and the signature is checked against the key on your
account — nothing secret crosses the wire.</p>
<pre class="code"># generate a key and read its public half
ecdsatool keygen ~/.ecdsa.pem
ecdsatool pubkey ~/.ecdsa.pem
# store it on your account, then use ECDSA-NIST256P-CHALLENGE for SASL
/msg NickServ SET PUBKEY &lt;printed-public-key&gt;</pre>
<p class="hint">Point your client's SASL settings at the same key file and pick the
<span class="mono">ECDSA-NIST256P-CHALLENGE</span> mechanism.</p>
</div>
</section>
{% endblock %}