Difference between revisions of "SASL"
(→Irssi: Add note about the minimum version) |
Tag: Undo |
||
(12 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
SASL is a way to 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 you need a [[Nick_Registration|registered nickname]]. | 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}} | {{Expand list|date=June 2017}} | ||
===Irssi=== | ===Irssi=== | ||
''Note: You need Irssi version >=0.8.18 to use SASL'' | '''''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> | <!-- <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=== | ===WeeChat=== | ||
==SASL EXTERNAL== | # <code>/set irc.server.rizon.addresses irc.rizon.net/6697</code> | ||
To configure SASL EXTERNAL first set up [[CertFP]], then set the following settings in your client: | # <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) {{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 open the '''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) {{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 (re)connect.</li></ol> | |||
| style="vertical-align:top;" | <ol><li value=5>Press {{Button|OK}} and (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=== | ===Irssi=== | ||
<pre> | '''''Note:''' You need Irssi version ≥ 0.8.18 to use SASL''<br /> | ||
<!-- <pre> | |||
/NETWORK ADD -sasl_mechanism external rizon | /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 | /SERVER ADD -auto -tls -tls_verify -tls_cert ~/.irssi/certs/Rizon.pem -network rizon -port 6697 irc.rizon.net | ||
</pre> | </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=== | ===WeeChat=== | ||
<pre> | <pre> | ||
Line 31: | Line 101: | ||
/set irc.server.rizon.sasl_mechanism external | /set irc.server.rizon.sasl_mechanism external | ||
</pre> | </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) {{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 open the '''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) {{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 (re)connect.</li></ol> | |||
| style="vertical-align:top;" | <ol><li value=5>Press {{Button|OK}} and (re)connect.</li></ol> | |||
|} |
Latest revision as of 18:45, 28 June 2023
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 registered nickname; then, you need to configure your client as explained later.
Rizon supports these two SASL mechanisms:
- SASL PLAIN with your nickname and password
- SASL EXTERNAL via a client certificate (CertFP)
SASL PLAIN Client Configurations
Irssi
Note: You need Irssi version >=0.8.18 to use SASL
/NETWORK ADD -sasl_mechanism PLAIN -sasl_username YourNickname -sasl_password YourPassword Rizon
WeeChat
/set irc.server.rizon.addresses irc.rizon.net/6697
/set irc.server.rizon.sasl_mechanism plain
/set irc.server.rizon.sasl_username YourNick
/secure set rizon YourPassword
/set irc.server.rizon.sasl_password "${sec.data.rizon}"
HexChat
- HexChat → Network List (or press Ctrl + S) for the Network List dialogue box.
- In the Networks list, find and select Rizon item, then press Edit...
- As Login method select SASL (username + password) ▼
- In the Password field enter
YourPassword
- Press Close then Connect
ZNC
Please refer to the ZNC wiki for instructions.
mIRC
- Tools → Options... (or press Alt + O) to open the mIRC Options dialogue box.
mIRC version ≤ 7.67 | mIRC version ≥ 7.68 |
---|---|
|
|
- Fill the fields with the following data:
Description | SASL (Plain)
|
---|---|
Address | irc.rizon.net
|
Ports | +6697,+9999
|
Group | Rizon
|
Password | Leave it empty! |
Login Method | SASL (/CAP) ▼ |
Password | YourPassword
|
mIRC version ≤ 7.67 | mIRC version ≥ 7.68 |
---|---|
|
|
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
/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
WeeChat
/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
HexChat
Note: The .pem file name should match what appears in the Networks list (step #2, below). This guide assumes that they are both named Rizon.
The generated .pem file should be in ~/.config/hexchat/certs/Rizon.pem
for Linux/Unix users, and %AppData%\HexChat\certs\Rizon.pem
for Windows users.
- HexChat → Network List (or press Ctrl + S) for the Network List dialogue box.
- In the Networks list, find and select Rizon item, then press Edit...
- As Login method select SASL EXTERNAL (cert) ▼
- Press Close then Connect
If the file exists, all your subsequent connections to Rizon network will use this certificate.
ZNC
Please refer to the ZNC wiki for instructions.
mIRC
- Tools → Options... (or press Alt + O) to open the mIRC Options dialogue box.
mIRC version ≤ 7.67 | mIRC version ≥ 7.68 |
---|---|
|
|
- Fill the fields with the following data:
Description | SASL (External) with CertFP
|
---|---|
Address | irc.rizon.net
|
Ports | +6697,+9999
|
Group | Rizon
|
Password | Leave it empty! |
Login Method | SASL External (/CAP) ▼ |
Password | Leave it empty! |
mIRC version ≤ 7.67 | mIRC version ≥ 7.68 |
---|---|
|
|