Syntax: CERT ADD [nickname] [fingerprint]
CERT DEL [nickname] fingerprint
CERT LIST [nickname]
Modifies or displays the certificate list for your nick.
If you connect to IRC and provide a client certificate with a
matching fingerprint in the cert list, you will be
automatically identified to services. Services Operators
may provide a nick to modify other users’ certificate lists.
Adds your current fingerprint to the certificate list and
automatically identifies you when you connect to IRC
using this fingerprint.
Removes the fingerprint from your certificate list.
Displays the current certificate list.
Automatically Identifying Using SSL + CertFP
This page describes how to use SSL with a certificate fingerprint to automatically identify your registered nickname with NickServ on connect. You must have an IRC client that supports SSL with a client certificate.
Creating a Self-signed Certificate
First you need generate a self-signed certificate. We will be using OpenSSL which should be available on most Linux and BSD distributions. There are ports for other platforms including Windows.
Generate the Key and Certificate
We need to generate our certificate and key. We’ll use the openssl command with the ‘req’ option.
The fields you are asked to fill out here do not matter for connecting to OFTC so fill them out however you wish. (You can use other key sizes if you want, but the hash algorithm needs to be SHA-1.) You now have two files, the key in nick.key and the certificate in nick.cer. Remember to protect your key using chmod.
If you are curious, you can have a closer look at your cert. We are mainly interested in the certificate fingerprint (CertFP). (This is not a required step, there are other ways to get the fingerprint.)
We now combine certificate and key to a single file nick.pem (Remember to also protect this file because it now includes your private key!):
Connecting to ZEnet with your Cert
If you are using a client that is not listed here feel free to submit a step-by-step howto about it, and we will include it. Either grab a staff member from #zenet or send a mail to our support address firstname.lastname@example.org with the information needed. Thank you.
Move the certificates you created some where safe, for example ~/.irssi/certs.
Now remove the current server and re-add it with the SSL flag, using your newly generated certificate. Note that we use the SSL port 6697 to connect.
Next we need to disconnect and connect back to the server. (A /reconnect does not read the new settings we added.)
- Go to “Settings -> Configure KvIRC”
- Go to “Connection->advanced”
- On the Tab “SSL” check ‘Use ssl certificate’ and ‘Use SSL private key’ and point both to the nick.pem file you created.
- Change your connection settings and enable the ssl option. Also make sure it is set to connect to port 6697.
- Go Main Options Menu -> Connect -> Options
- Click on the SSL button
- Click on the empty box below ‘Private Key File’, navigate to where you placed your nick.pem file and select it.
- Do the same for ‘Certificate Chain File’
- Make sure to connect to the network over SSL. The command is ‘/server irc.zenet.org +6697’ – note the plus sign before the port number. This is what sets mIRC to connect over SSL. To save this server with the SSL settings, you can simply add the plus sign before the port number in mIRC’s server manager.
- Convert the key to pkcs12: openssl pkcs12 -export -out nick.pfx -in nick.pem
- Go to the Certificate Manager. You should find that in the Preferences, Advanced Options, Encryption. Select ‘View Certificates’ and there you can import the nick.pfx you just generated
- Now connect to ZEnet using SSL and Chat**Zilla asks if you want to use the certificate for authentication. Say yes. (Note that you will have to confirm sending the certificate once for every server you connect to. As irc.zenet.org is a rotation it might ask you later again, don’t be surprised).
- Follow the instructions found on https://wiki.znc.in/Cert
- This should not be confused with https://wiki.znc.in/Certauth which is used to authenticate your remote client to your instance of znc. You’re trying to authenticate your znc instance with ZEnet.
Quassel settings are stored in ~/.config/quassel-irc.org/ so we can make the certs in ~/.config/quassel-irc.org/certs/ .
In the “Settings -> Configure Quassel “ menu, the “Identities” section, “Advanced” tab contains the interface to indicate the certificate.
- Load the key (~/.config/quassel-irc.org/certs/mynick.key)
- Load the certificate (~/.config/quassel-irc.org/certs/mynick.pem)
- Click OK and re-connect to the network.
You (obviously) need to be using an SSL port for this to work. http://bugs.quassel-irc.org/projects/1/wiki#IRC-Configuration has some detail on server settings interface.
Move the certificate you created:
Now start up Emacs and customize the tls-program variable (e.g. by calling “M-x customize-variable” and entering “tls-program”).
In order to connect with gnutls-cli, add the following entry:
In order to connect with openssl, add the following entry:
Then call “M-x erc-tls” and connect to irc.zenet.org, port 6697.
More info on using SSL in ERC can be found at the EmacsWiki.
Move the certificates you created somewhere safe, for example ~/.weechat/certs.
Now disconnect and remove the current server. Re-add it with the SSL flag, using your newly generated certificate. Note that we use the SSL port 6697 to connect.
Exit WeeChat and connect back to the ZEnet server.