Konversation/Configuring SASL authentication

This document will guide you through configuring SASL authentication for an IRC network, using the Freenode network as an example. Note: Support for SASL authentication is a new feature in Konversation v1.5, which has not yet been released. If you'd like to test SASL authentication prior to the release, have a look at our instructions for downloading the latest source code.

1. Let's start by adding the network to the Server List. (If you have already added the desired network to the server list, you can skip to step X.) Open the Server List dialog window by pressing the F2 key or by clicking File -> Server List... in the application menu:

1. In the Server List dialog window, click the New... button in the upper-right of the window to open the New Network dialog window:

1. In the New Network dialog window, give the network a name by filling in the Network name field. Then click the Add... button below the list labeled Servers to open the Add Server dialog window:

1. Fill the Add Server dialog window as shown in the next screenshot. As the purpose of this guide is to ultimately configure a secure authentication method, note that we have chosen to enable SSL to also use a secure transport between us and the server, logically complementing the choice of authentication. (You can learn more about Freenode's servers and the ports they listen on here.) Clicking the Ok button will add the server and take you back to the New Network dialog window.

1. Back in the New Network dialog window, notice the newly-added server in the Servers list for the network. Now click the Edit... button next to the drop-down selection labeled Identity to open the Identities dialog window:

1. Welcome to the Identities dialog window. This dialog window allows you to create and manage an unlimited number of Identities. An Identity is a way to store settings related to your person (such as your real name and nicknames) separately from the settings for a network, so you can for example reuse them for multiple different networks. It also makes it easy to switch between different Identity settings for a single network, by selecting the right Identity in the New Network dialog window from the preceding steps or in the similar Edit Network dialog window used to modify an existing network in the Server List. For added convenience, if you open the Identities dialog window from the New/Edit Network dialog window as we have done here (alternatively, you can open it any time by pressing F8), the Identity you are viewing at the time you press the Ok button will be automatically selected for the network.

Because Identities are such an important concept in Konversation, this guide will now take you through adding and filling in an entirely new Identity to use with Freenode before turning to adding the authentication settings. If you're already familiar with managing Identities, you can skip to step Y now.

Note that adding a new Identity is not strictly necessary. As long as you are only using a single IRC network, just filling in the Default Identity is of course enough. But even when using multiple IRC networks, using just the Default Identity for all of them can be enough, if there is no need for any of the Identity settings to differ from network to network. However because, as we will see later, the authentication settings are part of the Identity, it is usually good practice to use separate Identities for different networks, so you can use different passwords on each network for better security. Given this, click the button next to the drop-down selection labeled Identity to open the Add Identity dialog window:

1. In the Add Identity dialog window, enter a name for the new Identity and click the Ok button to get back to the Identities dialog window. Note that the name "Freenode" in the following screenshot is just a useful memory aid for the connection to the network; there is no need for the network and Identity name to be the same:

1. Back in the Identities dialog window, fill in the basic settings for the newly-added Identity, which has been automatically selected in the dialog (notice the drop-down selection labeled Identity at the top of the dialog window). Entering a Real name and adding at least one Nickname are required:

1. Now it's time to get to our final objective: Adding SASL authentication settings to our new Identity for use with the Freenode network.

(A short interlude: For the sake of brevity, and because the best and most up-to-date documentation for the account creation process is available on Freenode's own website, this guide assumes that you already have a Freenode account. If you don't have an account yet, however, click Ok now in the Identities dialog window and then in the New Network dialog window. You can then connect to Freenode unauthenticated by selecting it in the Server List dialog window and clicking the Connect button at the bottom of the dialog window. Once you are connected to Freenode you can follow their instructions to create an account. Once you're done, open the Server List dialog window again (see step 1), select Freenode and click the Edit... button to open the Edit Network dialog window and the Edit... button again to open the Identities dialog. Note that you will need to reconnect after adding the authentication settings to connect authenticated.)