View source for SASL

SASL is a way to automatically identify to your registered nickname during the connection to the network, ensuring that you don't have to manually identify to services. To use SASL, first, you need a [[Nick_Registration|registered nickname]]; then, you need to configure your client as explained later.
<p>Rizon supports these two SASL mechanisms:
* '''SASL PLAIN''' with your nickname and password
* '''SASL EXTERNAL''' via a client certificate ([[CertFP]])
</p>


==SASL PLAIN Client Configurations==
{{Expand list|date=June 2017}}

===Irssi===
'''''Note:''' You need Irssi version >=0.8.18 to use SASL''<br />
<!-- <pre>/NETWORK ADD -sasl_mechanism plain -sasl_username <nickname> -sasl_password <password> rizon</pre> -->
<code>/NETWORK ADD -sasl_mechanism PLAIN -sasl_username <em>YourNickname</em> -sasl_password <em>YourPassword</em> Rizon</code>

===WeeChat===

# <code>/set irc.server.rizon.addresses irc.rizon.net/6697</code>
# <code>/set irc.server.rizon.sasl_mechanism plain</code>
# <code>/set irc.server.rizon.sasl_username <em>YourNick</em></code>
# <code>/secure set rizon <em>YourPassword</em></code>
# <code>/set irc.server.rizon.sasl_password "${sec.data.rizon}"</code>

===HexChat===
# '''HexChat''' → '''Network List''' (or press {{Key Txt|Ctrl}} + {{Key Txt|S}}) for the ''' Network List''' dialogue box.
# In the '''Networks''' list, find and select '''Rizon''' item, then press {{Button|Edit...}}
# As '''Login method''' select {{Button|SASL (username + password) &nbsp;&nbsp;&nbsp;{{Unicode|▼}}}}
# In the '''Password''' field enter <code><em>YourPassword</em></code>
# Press {{Button|Close}} then {{Button|Connect}}

===ZNC===
Please refer to the [https://wiki.znc.in/Sasl ZNC wiki] for instructions.

=== mIRC ===
# '''Tools''' → '''Options...''' (or press {{Key Txt|Alt}} + {{Key Txt|O}}) to&nbsp;open the&nbsp;'''mIRC Options''' dialogue box.
{| style="width:700px;"
! width="49%" style="background: #f2f2f2;" | mIRC version ≤ 7.67
! width="49%" style="background: #f9f9f9;" | mIRC version ≥ 7.68
|-
| style="vertical-align:top;" | <ol>
   <li value="2">Go to '''Connect''' → '''Servers'''.</li>
   <li>Press {{Button|Add}}</li>
</ol>
| style="vertical-align:top;" | <ol>
   <li value="2">Go to '''Connect'''</li>
   <li>Press {{Button| style=font-weight:bold;|{{Unicode|≡}}}} button, and select '''Add'''</li>
</ol>
|}
<ol><li value=4>Fill the fields with the following data:</li>
{| class="wikitable" style=width:360px;
|-
! style="width:100px; text-align:right;" | Description
| <code>SASL (Plain)</code>
|-
! style="text-align:right;" | Address
| <code>irc.rizon.net</code>
|-
! style="text-align:right;" | Ports
| <code>+6697,+9999</code>
|-
! style="text-align:right;" | Group
| <code>Rizon</code>
|-
! style="text-align:right;" | Password
| ''Leave it empty!''
|-
! style="text-align:right;" | Login Method
| {{Button|SASL (/CAP) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{{Unicode|▼}}}}
|-
! style="text-align:right;" | Password
| <code><em>YourPassword</em></code>
|}
</ol>
{| style="width:700px;"
! width="49%" style="background: #f2f2f2;" | mIRC version ≤ 7.67
! width="49%" style="background: #f9f9f9;" | mIRC version ≥ 7.68
|-
| style="vertical-align:top;" | <ol><li value=5>Press {{Button|OK}} then {{Button|Select}} and&nbsp;(re)connect.</li></ol>
| style="vertical-align:top;" | <ol><li value=5>Press {{Button|OK}} and&nbsp;(re)connect.</li></ol>
|}

==SASL EXTERNAL Client Configurations==
To configure SASL EXTERNAL, first set up your client [[CertFP]], then set the following settings in your client:

===Irssi===
'''''Note:''' You need Irssi version ≥ 0.8.18 to use SASL''<br />

<!-- <pre>
/NETWORK ADD -sasl_mechanism external rizon
/SERVER ADD -auto -tls -tls_verify -tls_cert ~/.irssi/certs/Rizon.pem -network rizon -port 6697 irc.rizon.net
</pre> -->
# <code>/NETWORK ADD -sasl_mechanism EXTERNAL Rizon</code>
# <code>/SERVER ADD -auto -tls -tls_verify -tls_cert ~/.irssi/certs/Rizon.pem -network Rizon -port 6697 irc.rizon.net</code>

===WeeChat===
<pre>
/set irc.server.rizon.addresses irc.rizon.net/6697
/set irc.server.rizon.ssl on
/set irc.server.rizon.ssl_verify on
/set irc.server.rizon.ssl_cert %h/ssl/Rizon.pem
/set irc.server.rizon.sasl_mechanism external
</pre>

===HexChat===
'''''Note:''' The '''<big><kbd>.pem</kbd></big>''' file name should match what appears in the '''Networks''' list (step #2, below). This guide assumes that they are both named '''Rizon'''.<br />

The generated '''<big><kbd>.pem</kbd></big>''' file should be in <code>~/.config/hexchat/certs/Rizon.pem</code> for Linux/Unix users, and <code>%AppData%\HexChat\certs\Rizon.pem</code> for Windows users.
# '''HexChat''' → '''Network List''' (or press {{Key Txt|Ctrl}} + {{Key Txt|S}}) for the ''' Network List''' dialogue box.
# In the '''Networks''' list, find and select '''Rizon''' item, then press {{Button|Edit...}}
# As '''Login method''' select {{Button|SASL EXTERNAL (cert) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{{Unicode|▼}}}}
# Press {{Button|Close}} then {{Button|Connect}}
If the file exists, all your subsequent connections to Rizon network will use this certificate.

===ZNC===
Please refer to the [https://wiki.znc.in/Sasl ZNC wiki] for instructions.

=== mIRC ===
# '''Tools''' → '''Options...''' (or press {{Key Txt|Alt}} + {{Key Txt|O}}) to&nbsp;open the&nbsp;'''mIRC Options''' dialogue box.
{| style="width:700px;"
! width="49%" style="background: #f2f2f2;" | mIRC version ≤ 7.67
! width="49%" style="background: #f9f9f9;" | mIRC version ≥ 7.68
|-
| style="vertical-align:top;" | <ol>
 <li value="2">Go to '''Connect''' → '''Servers'''.</li>
 <li>Press {{Button|Add}}</li>
</ol>
| style="vertical-align:top;" | <ol>
 <li value="2">Go to '''Connect'''</li>
 <li>Press {{Button| style=font-weight:bold;|{{Unicode|≡}}}} button, and select '''Add'''</li>
</ol>
|}
<ol><li value=4>Fill the fields with the following data:</li>
{| class="wikitable"
|-
! style="text-align:right;" | Description
| <code>SASL (External) with CertFP</code>
|-
! style="text-align:right;" | Address
| <code>irc.rizon.net</code>
|-
! style="text-align:right;" | Ports
| <code>+6697,+9999</code>
|-
! style="text-align:right;" | Group
| <code>Rizon</code>
|-
! style="text-align:right;" | Password
| ''Leave it empty!''
|-
! style="text-align:right;" | Login Method
| {{Button|SASL External (/CAP) &nbsp;{{Unicode|▼}}}}
|-
! style="text-align:right;" | Password
| ''Leave it empty!''
|}
</ol>
{| style="width:700px;"
! width="49%" style="background: #f2f2f2;" | mIRC version ≤ 7.67
! width="49%" style="background: #f9f9f9;" | mIRC version ≥ 7.68
|-
| style="vertical-align:top;" | <ol><li value=5>Press {{Button|OK}} then {{Button|Select}} and&nbsp;(re)connect.</li></ol>
| style="vertical-align:top;" | <ol><li value=5>Press {{Button|OK}} and&nbsp;(re)connect.</li></ol>
|}