Add instructions for setting modes

[irc/freenode/web-7.0.git] / content / kb / using / certfp.md

diff --git a/content/kb/using/certfp.md b/content/kb/using/certfp.md
index e564ac01cc8fcfff21f05a51e9c012cbcc935b29..297c6290b6cc8222c0b51a73c830898cd3f9524b 100644 (file)
--- a/content/kb/using/certfp.md
+++ b/content/kb/using/certfp.md
@@ -6,6 +6,8 @@ Slug: certfp
 As an alternative to password-based authentication, you can connect to freenode
 with a TLS certificate and have services recognise it automatically.
 
+For SASL EXTERNAL to work, you must connect over SSL. 
+
 Creating a self-signed certificate
 ==================================
 
@@ -87,6 +89,20 @@ that the `certs` directory does not exist by default and you will have to
 create it yourself. Once the file is there, all subsequent SSL connections to
 that network will use the certificate.
 
+Konversation
+------------
+
+Create the pem file as per above, then place it wherever you want. 
+Start Konversation, then open the Identity dialogue by either pressing F8
+or via the Settings menu entry. Choose the identity you use for the 
+freenode network or create a new one. 
+In the part `Auto Identity` you have to choose `SASL External (Cert)`
+as the `Type` for SASL External or `SSL CLient Certificate` for CertFP.
+SASL External requires at least version 1.7 of Konversation. 
+Optionally fill in your account name in the `Account`field. 
+You can then choose the certificate you created with the file picker
+or enter the path manually in the field next to it.
+Once done, apply the configuration and (re)connect to freenode.
 
 Add your fingerprint to NickServ
 ================================