[irc/freenode/web-7.0.git] / content / kb / sasl / irssi.md

Title: Configuring SASL for irssi
---
This script, originally by Michael Tharp and Jilles Tjoelker has been further developed by Mantas Mikulėnas (grawity) and lives on scripts.irssi.org. Authentication information may be stored in ~/.irssi/sasl.auth.

1. Copy the script, [cap_sasl.pl <i class="fa fa-external-link" aria-hidden="true"></i>](http://scripts.irssi.org/scripts/cap_sasl.pl), into your ~/.irssi/scripts/autorun directory or from wherever irssi loads startup scripts.
2. The script requires at least the Perl module [MIME::Base64 <i class="fa fa-external-link" aria-hidden="true"></i>](https://metacpan.org/module/MIME::Base64). If you're using Linux, Perl modules are generally in distribution repositories, or you can get them directly from CPAN. If you cannot install them for the whole system, you may be able to use [local::lib <i class="fa fa-external-link" aria-hidden="true"></i>](https://metacpan.org/module/local::lib).
3. Load the script using `/script load autorun/cap_sasl.pl`.
4. The script needs to be configured with `/sasl set network nick password mechanism`.

   `network` is the (case-sensitive) name of the network specified with `/network add`

   `nick` is your registered nickname

   `password` is your NickServ password

   `mechanism` should be `PLAIN`. `PLAIN` sends your password unprotected, as plain text (which is fine when connecting over SSL, as the entire exchange is encrypted already).
5. Save the settings with `/sasl save`
6. If everything has been configured correctly, the next time you connect you should see the message:
`SASL authentication successful`

The script also supports `/sasl show` and `/sasl load`. Show lists currently-configured networks and the saved credentials. Load re-reads the sasl.auth file. A `/sasl set network` command with no other arguments will delete the configuration for that network.
Commit	Line	Data
46e25db6	1	Title: Configuring SASL for irssi
	2	---
	3	This script, originally by Michael Tharp and Jilles Tjoelker has been further developed by Mantas Mikulėnas (grawity) and lives on scripts.irssi.org. Authentication information may be stored in ~/.irssi/sasl.auth.
	4
	5	1. Copy the script, [cap_sasl.pl <i class="fa fa-external-link" aria-hidden="true"></i>](http://scripts.irssi.org/scripts/cap_sasl.pl), into your ~/.irssi/scripts/autorun directory or from wherever irssi loads startup scripts.
	6	2. The script requires at least the Perl module [MIME::Base64 <i class="fa fa-external-link" aria-hidden="true"></i>](https://metacpan.org/module/MIME::Base64). If you're using Linux, Perl modules are generally in distribution repositories, or you can get them directly from CPAN. If you cannot install them for the whole system, you may be able to use [local::lib <i class="fa fa-external-link" aria-hidden="true"></i>](https://metacpan.org/module/local::lib).
	7	3. Load the script using `/script load autorun/cap_sasl.pl`.
	8	4. The script needs to be configured with `/sasl set network nick password mechanism`.
	9
	10	`network` is the (case-sensitive) name of the network specified with `/network add`
	11
	12	`nick` is your registered nickname
	13
	14	`password` is your NickServ password
	15
	16	`mechanism` should be `PLAIN`. `PLAIN` sends your password unprotected, as plain text (which is fine when connecting over SSL, as the entire exchange is encrypted already).
	17	5. Save the settings with `/sasl save`
	18	6. If everything has been configured correctly, the next time you connect you should see the message:
	19	`SASL authentication successful`
	20
	21	The script also supports `/sasl show` and `/sasl load`. Show lists currently-configured networks and the saved credentials. Load re-reads the sasl.auth file. A `/sasl set network` command with no other arguments will delete the configuration for that network.