====== irssi ======

Irssi es un cliente IRC basado en ncurses.

El protocolo IRC (Internet Relay Chat) ha sido diseñado para usar con conferencias basadas en texto.
====== Instalación ======

irccd se distribuye con Slackware.

====== Usando con tor ======

Este párrafo muestra un método que puede seguir para irssi para una sesión de IRC en Freenode con Slackware Linux.
===== What is Freenode =====

The Freenode IRC network provides discussion facilities for the Free and Open Source Software communities. Amongst its channels one finds those that cater for discussion on Slackware, e.g. the ##slackware , #slackbuilds and #slackdocs channels.

===== What is tor =====

tor (The Onion Router) provides anonymity for dissidents and whistle blowers on the Internet. It also channels traffic through port 443, thus it can be used to penetrate through some dumb firewalls that block some services to the users relying only on the destination port information.

A SlackBuild for tor is maintained on the [[http://slackbuilds.org/result/?search=tor|slackbuilds.org]] repository. You will also need [[http://slackbuilds.org/result/?search=torsocks|torsocks]], as you will be using ''torify''.

If you are using a desktop, I recommend to install also vidalia. A SlackBuild for vidalia is also found on the [[http://slackbuilds.org/result/?search=vidalia|slackbuilds.org]] repository. If you choose to use vidalia, then do not start tor manually, as otherwise vidalia will get confused and quit. If on the other hand you do not want vidalia, then you will need to start tor manually. As root perform the following commands to start tor: <code>
# chmod +x /etc/rc.d/rc.tor
# /etc/rc.d/rc.tor start
</code>

I recommend to install the latest releases of tor (and optionally vidalia) from the official download sites, as the SlackBuilds are not always updated. Modify the scripts to target the updated source code if needed.

===== Misuse =====

Some sorry individuals might pursue this option for trolling purposes. Although I am not going to deviate on this subject, trolling is a sure sign of a personality disorder. Seek professional help as trolling is not going to ease your frustrations! Also note that you will need to register you nick before starting so you will be banned after you get detected for misbehavior anyway.

===== Register your Nick =====

You will need to register your nick with freenode.net. You will need a valid e-mail address to do that. The procedure to register your nick may be followed from here: http://freenode.net/faq.shtml#nicksetup so I will not repeat it.

===== SASL Authentication =====

Then you will need to logon Freenode via SASL authentication.

Install [[http://software.jaos.org/#cpan2tgz|cpan2tgz]]. You will need Version 0.6.7 or later. Look also at the [[http://software.jaos.org/git/cpan2tgz|git]] repository for the most recent release. A SlackBuild for cpan2tgz is available from [[http://slackbuilds.org/result/?search=cpan2tgz|slackbuilds.org]]

Then proceed to install some required CPAN perl modules:

As root, execute the following commands. Note that you will need an Internet connection <code>
# cpan2tgz --build-tag=me Crypt::Blowfish
# cpan2tgz --build-tag=me Math::BigInt::GMP
# cpan2tgz --build-tag=me Crypt::DH Crypt::OpenSSL::Bignum
# cpan2tgz --build-tag=me Math::BigInt
# cpan2tgz --build-tag=me Math::BigInt::FastCalc
</code>
Note that the argument "--build-tag=me" will cause a "build tag" to be added to the resulting package (like "''perl-crypt-blowfish-2.12-i486-1me.txz''") which makes it easier to exclude from [[slackware:slackpkg|slackpkg]] package management.

Now as your chosen non-privileged user, rename your irssi configurations files, to ensure consistency: <code>
$ mv -i $HOME/.irssi $HOME/.irssi.orig
$ irssi
</code>

Quit irssi by entering <code>
/quit
</code>

Edit the 3rd last line of the file ''$HOME/.irssi/config'' which will have been created, to accomodate your nick. For example:

From:
<code>
core = { real_name = "Chris"; user_name = "chris"; nick = "chris"; };
</code>

To:
<code>
core = { real_name = "Chris"; user_name = "Chris Abela"; nick = "ChrisAbela"; };
</code>

Then proceed as follows:

<code>
$ mkdir -p $HOME/.irssi/scripts/autorun
$ cd $HOME/.irssi/scripts/
$ wget http://scripts.irssi.org/scripts/cap_sasl.pl
$ ln -s ../cap_sasl.pl autorun/
$ cd
$ irssi
</code>

In the irssi session, enter the following commands:

<code>
/network add Freenode
/server add -auto -ssl -ssl_verify -network Freenode irc.freenode.net 7000
/save
/script load cap_sasl.pl
/sasl set Freenode <nick> <password> PLAIN
</code>

Naturally enter your actual nick and password where indicated.

Proceed like this:

<code>
/sasl save
/save
/quit
</code>

Next time you run irssi, you will automatically logon to Freenode without being asked for the password, this indicates that your SASL authentication has been succesful.

===== Torifying irssi =====

<note warning>Note that Freenode hidden service is offline until further notice. The rest of this wiki will not work. 
</note>

<note warning>If you have an installation with multilib packages, it may be necessary to create this symbolic link as root for the torify command to work:

<code>
# cd /usr/lib
# ln -s ../lib64/torsocks/ .
</code></note> 

To connect to freenode with tor, start it as follows:
<code>
$ http_proxy=http://127.0.0.1:6677/ torify irssi
</code>
and it will fail miserably!

This is my result:
<code>
20:45 -!- Irssi: Looking up irc.freenode.net
20:45 -!- Irssi: SASL: auth loaded from /home/chris/.irssi/sasl.auth
20:46 -!- Irssi: Connecting to irc.freenode.net [195.148.124.79] port 7000
20:46 -!- Irssi: warning SSL handshake failed: Connection reset by peer
20:46 -!- Irssi: Connection lost to irc.freenode.net
</code>

You will need to connect to the Freenode's tor's hidden service address: //frxleqtzgvwkv7oz.onion//
<code>
/server frxleqtzgvwkv7oz.onion
</code>

Be aware that the connection will be slow. If you are using vidalia, you may try changing your proxy server for a better connect. Eventually, you should manage to log in but you have to be patient and accept some latency. Should you still fail, consider reporting your problems to the #freenode channel.

You may check that you are chatting anonymously:

<code>
/whois <nick>
</code>

I obtained the following result:
<code>
20:18 -!- ChrisAbela [~Chris@gateway/tor-sasl/chrisabela]
20:18 -!-  ircname  : Chris
20:18 -!-  server   : zelazny.freenode.net [internal]
20:18 -!-  hostname : gateway/tor-sasl/chrisabela 255.255.255.255 
20:18 -!-  idle     : 0 days 0 hours 0 mins 9 secs [signon: Fri Jan 10 20:18:40 2014]
20:18 -!-  account  : ChrisAbela
20:18 -!- End of WHOIS
</code>

Note that the user_name is leaked!

Then proceed as usual:

<code>
/j ##slackware
</code>

If you need assistance, you may join the freenode channel to seek guidance:

<code>
/j #freenode
</code>

===== Sources =====

  * http://www.irssi.org/
  * https://tools.ietf.org/html/rfc1459
  * http://freenode.net/
  * https://www.torproject.org/
  * http://www.andrews-corner.org/irssi.html
  * Originally written by [[wiki:user:chrisabela | Chris Abela]]
  * Contributions by [[wiki:user:markand | markand]]

{{tag>howtos tor irssi author_chrisabela}}