Difference between revisions of "SASL"

From Rizon Wiki
Jump to navigation Jump to search
m (Enhanced intro and headings, and replaced SSL flags with TLS in Irssi.)
m (fix typo)
 
(3 intermediate revisions by one other user not shown)
Line 34: Line 34:
=== mIRC ===
=== mIRC ===
# '''Tools''' → '''Options...''' (or press {{Key Txt|Alt}} + {{Key Txt|O}}) to open the '''mIRC Options''' dialogue box.
# '''Tools''' → '''Options...''' (or press {{Key Txt|Alt}} + {{Key Txt|O}}) to open the '''mIRC Options''' dialogue box.
# Go to '''Connect''' → '''Servers'''.
{| style="width:700px;"
# Under '''IRC Servers:''', find and select '''Rizon''' group, and press {{Button|Add}}
! width="49%" style="background: #f2f2f2;" | mIRC version ≤ 7.67
# Fill the fields with the following data:
! width="49%" style="background: #f9f9f9;" | mIRC version ≥ 7.68
<blockquote>
|-
{| class="wikitable"
| 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="text-align:right;" | Description
! style="width:100px; text-align:right;" | Description
| <code>Random server SASL (Plain)</code>
| <code>SASL (Plain)</code>
|-
|-
! style="text-align:right;" | Address
! style="text-align:right;" | Address
Line 53: Line 63:
|-
|-
! style="text-align:right;" | Password
! style="text-align:right;" | Password
| ''Leave it emptry!''
| ''Leave it empty!''
|-
|-
! style="text-align:right;" | Login Method
! style="text-align:right;" | Login Method
Line 61: Line 71:
| <code><em>YourPassword</em></code>
| <code><em>YourPassword</em></code>
|}
|}
</blockquote>
</ol>
<ol><li value=5>Press {{Button|OK}} then {{Button|Select}} and&nbsp;(re)connect.</li></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==
==SASL EXTERNAL Client Configurations==
Line 102: Line 117:
=== mIRC ===
=== mIRC ===
# '''Tools''' → '''Options...''' (or press {{Key Txt|Alt}} + {{Key Txt|O}}) to&nbsp;open the&nbsp;'''mIRC Options''' dialogue box.
# '''Tools''' → '''Options...''' (or press {{Key Txt|Alt}} + {{Key Txt|O}}) to&nbsp;open the&nbsp;'''mIRC Options''' dialogue box.
# Go to '''Connect''' → '''Servers'''.
{| style="width:700px;"
# Press {{Button|Add}}
! width="49%" style="background: #f2f2f2;" | mIRC version ≤ 7.67
# Fill the fields with the following data:
! width="49%" style="background: #f9f9f9;" | mIRC version ≥ 7.68
<blockquote>
|-
| 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"
{| class="wikitable"
|-
|-
! style="text-align:right;" | Description
! style="text-align:right;" | Description
| <code>Random server SASL (External)</code>
| <code>SASL (External) with CertFP</code>
|-
|-
! style="text-align:right;" | Address
! style="text-align:right;" | Address
Line 121: Line 146:
|-
|-
! style="text-align:right;" | Password
! style="text-align:right;" | Password
| ''Leave it emptry!''
| ''Leave it empty!''
|-
|-
! style="text-align:right;" | Login Method
! style="text-align:right;" | Login Method
Line 127: Line 152:
|-
|-
! style="text-align:right;" | Password
! style="text-align:right;" | Password
| ''Leave it emptry!''
| ''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>
|}
|}
</blockquote>
<ol><li value=5>Press {{Button|OK}} then {{Button|Select}} and&nbsp;(re)connect.</li></ol>

Latest revision as of 11:25, 16 April 2022

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 username (nick)
/set irc.server.rizon.sasl_password password

HexChat

  1. HexChatNetwork List (or press Ctrl + S) for the Network List dialogue box.
  2. In the Networks list, find and select Rizon item, then press Edit...
  3. As Login method select SASL (username + password)    
  4. In the Password field enter YourPassword
  5. Press Close then Connect

ZNC

Please refer to the ZNC wiki for instructions.

mIRC

  1. ToolsOptions... (or press Alt + O) to open the mIRC Options dialogue box.
mIRC version ≤ 7.67 mIRC version ≥ 7.68
  1. Go to ConnectServers.
  2. Press Add
  1. Go to Connect
  2. Press button, and select Add
  1. Fill the fields with the following data:
  2. 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
  1. Press OK then Select and (re)connect.
  1. Press OK and (re)connect.

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

  1. /NETWORK ADD -sasl_mechanism EXTERNAL Rizon
  2. /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.

  1. HexChatNetwork List (or press Ctrl + S) for the Network List dialogue box.
  2. In the Networks list, find and select Rizon item, then press Edit...
  3. As Login method select SASL EXTERNAL (cert)      
  4. 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

  1. ToolsOptions... (or press Alt + O) to open the mIRC Options dialogue box.
mIRC version ≤ 7.67 mIRC version ≥ 7.68
  1. Go to ConnectServers.
  2. Press Add
  1. Go to Connect
  2. Press button, and select Add
  1. Fill the fields with the following data:
  2. 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
  1. Press OK then Select and (re)connect.
  1. Press OK and (re)connect.