mikaela.github.io/pages/external/identifying.html

<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8" /> <!-- <meta http-equiv="refresh" content="60" /> --> <meta name="description" content="Instructions for identifying to services on various IRC networks." /> <meta name="author" content="Mikaela Suomalainen" /> <link rel="canonical" href="https://mkaysi.github.io/pages/external/identifying.html">
<title>
Insert title here
</title>
<link rel="stylesheet" type="text/css" href="../../css.css" />
</head>
<body>

<p><strong>NOTE: This might be heavily freenode-specific, but these things should work with other networks too, at least SASL and CertFP.</strong></p>
<p>I will document the four different methods to identify to services which I use by myself. <strong>I use all of these at the same time.</strong></p>
<h2 id="sasl">SASL</h2>
<p>There isn't much to say about SASL as it's easy to configure as long as your IRC client supports it. SASL identifies you before logging in, but it won't help you in case services are down. The easiest way to check does the network where you are support SASL is probably to whois or message or both to the SaslServ.</p>
<pre><code>/whois SaslServ SaslServ
/msg SaslServ help</code></pre>
<p>If the network does support SASL, you should see something like this which freenode gives:</p>
<pre><code>XX:XX:XX -- [SaslServ] (SaslServ@services.): SASL Authentication Agent
XX:XX:XX -- [SaslServ] services. (Atheme IRC Services)
XX:XX:XX -- [SaslServ] is a Network Service
XX:XX:XX -- [saslserv] End of WHOIS
XX:XX:XX -- SaslServ: This service exists to identify connecting clients to the network. It has no public interface.</code></pre>
<p>There are different mechanisms for use with SASL. I personally use them in this order with ZNC: <code>PLAIN DH-AES DH-BLOWFISH and EXTERNAL</code>.</p>
<p>This is what ZNC 1.5-git-3b01efc says about them:</p>
<pre><code>XX:XX:XX &lt; *sasl&gt; +-------------+----------------------------------------------------+
XX:XX:XX &lt; *sasl&gt; | Mechanism   | Description                                        |
XX:XX:XX &lt; *sasl&gt; +-------------+----------------------------------------------------+
XX:XX:XX &lt; *sasl&gt; | EXTERNAL    | TLS certificate, for use with the *cert module     |
XX:XX:XX &lt; *sasl&gt; | DH-BLOWFISH | Secure negotiation using the DH-BLOWFISH mechanism |
XX:XX:XX &lt; *sasl&gt; | DH-AES      | More secure negotiation using the DH-AES mechanism |
XX:XX:XX &lt; *sasl&gt; | PLAIN       | Plain text negotiation                             |
XX:XX:XX &lt; *sasl&gt; +-------------+----------------------------------------------------+</code></pre>
<p>Some notes:</p>
<ul class="incremental">
<li>PLAIN is plain text as it says, so if you use it like I do, you should use SSL.</li>
<li>EXTERNAL is supposed to be used together with CertFP, but it doesn't work with most of networks.
<ul class="incremental">
<li>It's not supported even by freenode.</li>
<li>I don't know any network that supports it.</li>
</ul></li>
<li>This won't help you if services go down.</li>
</ul>
<h2 id="certfp">CertFP</h2>
<p>CertFP identifies you using SSL certificate which you must generate and add to your NickServ account.</p>
<p>You can use this command at IRC to check if the network supports certfp.</p>
<pre><code>/msg NickServ help cert</code></pre>
<p>I am not sure how this happens on Windows, so you might need to look for that information elsewhere unless someone decides to help me and tell how does it happen. I am going to tell about OpenSSL.</p>
<h3 id="generating-the-certificate">Generating the certificate</h3>
<p>Open terminal and run this command and replae YOURNICKNAMEHERE.pem with your nickname or something else which makes you know what it is (<strong>DO NOT SET PASSWORD FOR IT OR YOUR CLIENT MIGHT NOT BE ABLE TO USE IT</strong>):</p>
<pre><code>openssl req -nodes -newkey rsa:4096 -keyout YOURNICKNAMEHERE.pem -x509 -days 365 -out YOURNICKNAMEHERE.pem</code></pre>
<p>This gives us file <code>YOURNICKNAMEHERE.pem</code> which you must give to your IRC client. I am sorry, but that depends on your IRC client too, so I cannot say anything about it.</p>
<h3 id="telling-nickserv-about-your-key">Telling NickServ about your key</h3>
<p>NickServ wants to know the fingerprint which you can get with the following command:</p>
<pre><code>openssl x509 -sha1 -noout -fingerprint -in YOURNICKNAMEHERE.pem | sed -e &#39;s/^.*=//;s/://g;y/ABCDEF/abcdef/&#39;</code></pre>
<p>which returns your fingerprint (<strong>WHICH YOU MUST NOT SHARE WITH ANYONE</strong>)</p>
<pre><code>05dd01fedc1b821b796d0d785160f03e32f53fa8</code></pre>
<p>Now you can tell to NickServ about it.</p>
<pre><code>/msg NickServ CERT ADD 05dd01fedc1b821b796d0d785160f03e32f53fa8</code></pre>
<p>(replace that with your own fingerprint!) And nickerv replies to you</p>
<pre><code>14:13:39 -- NickServ: Added fingerprint 05dd01fedc1b821b796d0d785160f03e32f53fa8 to your fingerprint list.</code></pre>
<h3 id="testing">Testing</h3>
<p>Now when you connect to freenode and have configured your IRC client to use your new certificate, you should get identified automatically and you should see your certificate by whoising yourself and running cert list with NickServ.</p>
<pre><code>/WHOIS YOURNICK YOURNICK
/MSG NickServ CERT LIST</code></pre>
<p>replies</p>
<pre><code>&lt;...&gt;
XX:XX:XX -- [YOURNICK] has client certificate fingerprint 05dd01fedc1b821b796d0d785160f03e32f53fa8
&lt;...&gt;
XX:XX:XX -- NickServ: Fingerprint list for YOURNICK:
XX:XX:XX -- NickServ: - 05dd01fedc1b821b796d0d785160f03e32f53fa8$$
XX:XX:XX -- NickServ: End of YOURNICK fingerprint list.</code></pre>
<h3 id="notes">Notes</h3>
<ul class="incremental">
<li>You must recreate your certificate yearly.</li>
<li>This will identify you with immediately so you are still visible to /monitor.</li>
<li>This will identify you after services return unlike other methods if you happen to be on splitted server without services.</li>
<li>Supported networks which I am on:
<ul class="incremental">
<li>freenode</li>
<li>oftc</li>
<li>piratenet</li>
</ul></li>
</ul>
<h2 id="server-password">Server password</h2>
<p>This might not work with some networks, but this works with freenode. All IRC clients should support settng password which to use while connecting to server. Set it as <code>username:password</code> for freenode and you are automatically identified when you connect.</p>
<p>Some notes:</p>
<ul class="incremental">
<li>This is only known to work with freenode.</li>
<li>You aren't identified immediately so as shown in the embedded gist, your real host is visible for people who have you on <code>/monitor</code>.</li>
<li>This won't help you if services go down.</li>
</ul>
<h2 id="automatic-command">Automatic command</h2>
<p>This works with probably every client. They support setting commands that are automatically run as you connect and you can set the command</p>
<pre><code>/msg NickServ identify username password</code></pre>
<p>or whatever syntax the services on your network use.</p>
<p>Some notes:</p>
<ul class="incremental">
<li>Your real host is still visible for /monitor ing people.</li>
<li>Your client might send that command too late to prevent you from getting to redirect channels for unidentified users and show your real host to everyone.</li>
<li>You might annoy people by joining twice and quitting once with &quot;Changing host&quot;.</li>
</ul>
<hr/>
For corrections above this line, please contact <a href="../irc.html">me at IRC</a> or fix them by yourself <a href="https://github.com/Mkaysi/mkaysi.github.io/blob/master/pages/external/identifying.html.md">here</a>. What is below that line is embedded GitHub gist which reads where to contact with issues with it.
<hr/>
<script src="https://gist.github.com/maxanton/1e2cf7ada079c271bd3c.js"></script>
</body>
</html>
<!-- vim : set ft=markdown-->
pages/irc: bold the first line & start pages/external/identifying.html 2014-05-23 12:05:31 +02:00			`<!DOCTYPE html>`
			`<html>`
			`<head>`
			`<meta charset="UTF-8" /> <!-- <meta http-equiv="refresh" content="60" /> --> <meta name="description" content="Instructions for identifying to services on various IRC networks." /> <meta name="author" content="Mikaela Suomalainen" /> <link rel="canonical" href="https://mkaysi.github.io/pages/external/identifying.html">`
			`<title>`
			`Insert title here`
			`</title>`
			`<link rel="stylesheet" type="text/css" href="../../css.css" />`
			`</head>`
			`<body>`

			`<p><strong>NOTE: This might be heavily freenode-specific, but these things should work with other networks too, at least SASL and CertFP.</strong></p>`
pages/external/identifying: username:password & automatic command. 2014-05-23 12:57:31 +02:00			`<p>I will document the four different methods to identify to services which I use by myself. <strong>I use all of these at the same time.</strong></p>`
pages/external/identifying: SASL 2014-05-23 12:36:52 +02:00			`<h2 id="sasl">SASL</h2>`
			`<p>There isn't much to say about SASL as it's easy to configure as long as your IRC client supports it. SASL identifies you before logging in, but it won't help you in case services are down. The easiest way to check does the network where you are support SASL is probably to whois or message or both to the SaslServ.</p>`
			`<pre><code>/whois SaslServ SaslServ`
			`/msg SaslServ help</code></pre>`
			`<p>If the network does support SASL, you should see something like this which freenode gives:</p>`
			`<pre><code>XX:XX:XX -- [SaslServ] (SaslServ@services.): SASL Authentication Agent`
			`XX:XX:XX -- [SaslServ] services. (Atheme IRC Services)`
			`XX:XX:XX -- [SaslServ] is a Network Service`
			`XX:XX:XX -- [saslserv] End of WHOIS`
			`XX:XX:XX -- SaslServ: This service exists to identify connecting clients to the network. It has no public interface.</code></pre>`
			`<p>There are different mechanisms for use with SASL. I personally use them in this order with ZNC: <code>PLAIN DH-AES DH-BLOWFISH and EXTERNAL</code>.</p>`
			`<p>This is what ZNC 1.5-git-3b01efc says about them:</p>`
			`<pre><code>XX:XX:XX < *sasl> +-------------+----------------------------------------------------+`
			`XX:XX:XX < *sasl> \| Mechanism \| Description \|`
			`XX:XX:XX < *sasl> +-------------+----------------------------------------------------+`
			`XX:XX:XX < sasl> \| EXTERNAL \| TLS certificate, for use with the cert module \|`
			`XX:XX:XX < *sasl> \| DH-BLOWFISH \| Secure negotiation using the DH-BLOWFISH mechanism \|`
			`XX:XX:XX < *sasl> \| DH-AES \| More secure negotiation using the DH-AES mechanism \|`
			`XX:XX:XX < *sasl> \| PLAIN \| Plain text negotiation \|`
			`XX:XX:XX < *sasl> +-------------+----------------------------------------------------+</code></pre>`
			`<p>Some notes:</p>`
			`<ul class="incremental">`
			`<li>PLAIN is plain text as it says, so if you use it like I do, you should use SSL.</li>`
			`<li>EXTERNAL is supposed to be used together with CertFP, but it doesn't work with most of networks.`
			`<ul class="incremental">`
			`<li>It's not supported even by freenode.</li>`
			`<li>I don't know any network that supports it.</li>`
			`</ul></li>`
pages/external/identifying: username:password & automatic command. 2014-05-23 12:57:31 +02:00			`<li>This won't help you if services go down.</li>`
pages/external/identifying: SASL 2014-05-23 12:36:52 +02:00			`</ul>`
			`<h2 id="certfp">CertFP</h2>`
finish automatic identifying 2014-05-23 13:26:30 +02:00			`<p>CertFP identifies you using SSL certificate which you must generate and add to your NickServ account.</p>`
			`<p>You can use this command at IRC to check if the network supports certfp.</p>`
			`<pre><code>/msg NickServ help cert</code></pre>`
			`<p>I am not sure how this happens on Windows, so you might need to look for that information elsewhere unless someone decides to help me and tell how does it happen. I am going to tell about OpenSSL.</p>`
			`<h3 id="generating-the-certificate">Generating the certificate</h3>`
			`<p>Open terminal and run this command and replae YOURNICKNAMEHERE.pem with your nickname or something else which makes you know what it is (<strong>DO NOT SET PASSWORD FOR IT OR YOUR CLIENT MIGHT NOT BE ABLE TO USE IT</strong>):</p>`
			`<pre><code>openssl req -nodes -newkey rsa:4096 -keyout YOURNICKNAMEHERE.pem -x509 -days 365 -out YOURNICKNAMEHERE.pem</code></pre>`
			`<p>This gives us file <code>YOURNICKNAMEHERE.pem</code> which you must give to your IRC client. I am sorry, but that depends on your IRC client too, so I cannot say anything about it.</p>`
			`<h3 id="telling-nickserv-about-your-key">Telling NickServ about your key</h3>`
			`<p>NickServ wants to know the fingerprint which you can get with the following command:</p>`
			`<pre><code>openssl x509 -sha1 -noout -fingerprint -in YOURNICKNAMEHERE.pem \| sed -e 's/^.*=//;s/://g;y/ABCDEF/abcdef/'</code></pre>`
			`<p>which returns your fingerprint (<strong>WHICH YOU MUST NOT SHARE WITH ANYONE</strong>)</p>`
			`<pre><code>05dd01fedc1b821b796d0d785160f03e32f53fa8</code></pre>`
			`<p>Now you can tell to NickServ about it.</p>`
			`<pre><code>/msg NickServ CERT ADD 05dd01fedc1b821b796d0d785160f03e32f53fa8</code></pre>`
			`<p>(replace that with your own fingerprint!) And nickerv replies to you</p>`
			`<pre><code>14:13:39 -- NickServ: Added fingerprint 05dd01fedc1b821b796d0d785160f03e32f53fa8 to your fingerprint list.</code></pre>`
			`<h3 id="testing">Testing</h3>`
			`<p>Now when you connect to freenode and have configured your IRC client to use your new certificate, you should get identified automatically and you should see your certificate by whoising yourself and running cert list with NickServ.</p>`
			`<pre><code>/WHOIS YOURNICK YOURNICK`
			`/MSG NickServ CERT LIST</code></pre>`
			`<p>replies</p>`
			`<pre><code><...>`
			`XX:XX:XX -- [YOURNICK] has client certificate fingerprint 05dd01fedc1b821b796d0d785160f03e32f53fa8`
			`<...>`
			`XX:XX:XX -- NickServ: Fingerprint list for YOURNICK:`
			`XX:XX:XX -- NickServ: - 05dd01fedc1b821b796d0d785160f03e32f53fa8$$`
			`XX:XX:XX -- NickServ: End of YOURNICK fingerprint list.</code></pre>`
			`<h3 id="notes">Notes</h3>`
			`<ul class="incremental">`
			`<li>You must recreate your certificate yearly.</li>`
			`<li>This will identify you with immediately so you are still visible to /monitor.</li>`
			`<li>This will identify you after services return unlike other methods if you happen to be on splitted server without services.</li>`
			`<li>Supported networks which I am on:`
			`<ul class="incremental">`
			`<li>freenode</li>`
			`<li>oftc</li>`
			`<li>piratenet</li>`
			`</ul></li>`
			`</ul>`
pages/external/identifying: SASL 2014-05-23 12:36:52 +02:00			`<h2 id="server-password">Server password</h2>`
pages/external/identifying: username:password & automatic command. 2014-05-23 12:57:31 +02:00			`<p>This might not work with some networks, but this works with freenode. All IRC clients should support settng password which to use while connecting to server. Set it as <code>username:password</code> for freenode and you are automatically identified when you connect.</p>`
			`<p>Some notes:</p>`
			`<ul class="incremental">`
			`<li>This is only known to work with freenode.</li>`
			`<li>You aren't identified immediately so as shown in the embedded gist, your real host is visible for people who have you on <code>/monitor</code>.</li>`
			`<li>This won't help you if services go down.</li>`
			`</ul>`
pages/external/identifying: SASL 2014-05-23 12:36:52 +02:00			`<h2 id="automatic-command">Automatic command</h2>`
pages/external/identifying: username:password & automatic command. 2014-05-23 12:57:31 +02:00			`<p>This works with probably every client. They support setting commands that are automatically run as you connect and you can set the command</p>`
			`<pre><code>/msg NickServ identify username password</code></pre>`
			`<p>or whatever syntax the services on your network use.</p>`
			`<p>Some notes:</p>`
			`<ul class="incremental">`
			`<li>Your real host is still visible for /monitor ing people.</li>`
			`<li>Your client might send that command too late to prevent you from getting to redirect channels for unidentified users and show your real host to everyone.</li>`
			`<li>You might annoy people by joining twice and quitting once with "Changing host".</li>`
			`</ul>`
finish automatic identifying 2014-05-23 13:26:30 +02:00			`<hr/>`
pages/irc: bold the first line & start pages/external/identifying.html 2014-05-23 12:05:31 +02:00			`For corrections above this line, please contact <a href="../irc.html">me at IRC</a> or fix them by yourself <a href="https://github.com/Mkaysi/mkaysi.github.io/blob/master/pages/external/identifying.html.md">here</a>. What is below that line is embedded GitHub gist which reads where to contact with issues with it.`
			`<hr/>`
			`<script src="https://gist.github.com/maxanton/1e2cf7ada079c271bd3c.js"></script>`
			`</body>`
			`</html>`
			`<!-- vim : set ft=markdown-->`