MCabber OpenPGP support
This files explains how to use PGP support in mcabber.
Please note that you need libgpgme > 1.0.0 (for example, libgpgme11 in Debian)
on your system.
## Enabling OpenPGP support ##
In the configuration file, enable pgp and set pgp_private_key to your key id.
Your key id can be found with the following command:
% gpg --list-keys --keyid-format long your_name
Example (in $HOME/.mcabber/mcabberrc):
set pgp = 1
set pgp_private_key = "E3E6A9C1A6A013D3"
## Encrypting messages ##
Now when you start mcabber, it should ask for your passphrase (unless you put
it in your configuration file or you use gpg-agent).
If you want to know if a contact is using PGP, select the contact and use the
command /info. If (s)he is, it should display something like:
PGP key id: E2C4C9A1601A5A4
Last PGP signature: unknown
The signature is "unknown", because we don't have the contact's key. We could
get it with gpg, for example:
% gpg --recv-keys E2C4C9A1601A5A4
Then, wait for the next presence message.
If the contact has your key and you have their key, you should have
bidirectional encrypted messages.
## Per-contact settings ##
You can provide a PGP key to be used for a given Jabber user or disable PGP on
a per-account basis, using the command /pgp.
If you provide a KeyId for a contact, it will be compared to the key the
contact uses to sign their presence/messages and it will be used for all
outgoing encrypted messages (by default, mcabber will use the contact
signature's key).
Example:
/pgp disable foo@bar.org
(disables encryption of messages sent to foo@bar.org)
/pgp setkey bar@foo.net C9940A9BB0B92210
(set the encryption key for bar@foo.net and warn if this contact doesn't
use this key for their signatures)
/pgp info
(show the PGP settings we've set for the currently selected contact)
Try "/help pgp" for a usage description.
The command /pgp can be used in the configuration file (without the leading /).