summaryrefslogtreecommitdiff
path: root/doc/en/plugins/gpg.txt
diff options
context:
space:
mode:
authormathieui <mathieui@mathieui.net>2013-04-08 18:52:35 +0200
committermathieui <mathieui@mathieui.net>2013-04-08 18:52:35 +0200
commitbd8d38d711e15d42ac8e797723af5242e4c3f4fb (patch)
treed3ea6da641be1c7e67a3123071cb816933436502 /doc/en/plugins/gpg.txt
parente5f219d43edbb4b05c8890f81f2f93b90e215a10 (diff)
downloadpoezio-bd8d38d711e15d42ac8e797723af5242e4c3f4fb.tar.gz
poezio-bd8d38d711e15d42ac8e797723af5242e4c3f4fb.tar.bz2
poezio-bd8d38d711e15d42ac8e797723af5242e4c3f4fb.tar.xz
poezio-bd8d38d711e15d42ac8e797723af5242e4c3f4fb.zip
Beginning of the migration to reST documentation
Diffstat (limited to 'doc/en/plugins/gpg.txt')
-rw-r--r--doc/en/plugins/gpg.txt101
1 files changed, 0 insertions, 101 deletions
diff --git a/doc/en/plugins/gpg.txt b/doc/en/plugins/gpg.txt
deleted file mode 100644
index a39b68a4..00000000
--- a/doc/en/plugins/gpg.txt
+++ /dev/null
@@ -1,101 +0,0 @@
-GPG
-===
-
-This plugin implements the
-link:http://xmpp.org/extensions/xep-0027.html[XEP-0027] “Current Jabber OpenPGP
-Usage”.
-
-This is a plugin used to encrypt one-to-one conversation using the PGP
-encryption method. You can use it if you want really good privacy. Without this
-encryption, your messages are encrypted *at least* from your client (poezio) to
-your server. The message is decrypted by your server and you cannot control the
-encryption method of your messages from your server to your contact’s server
-(unless you are your own server’s administrator), nor from your contact’s
-server to your contact’s client.
-
-This plugin does end-to-end encryption. This means that *only* your contact can
-decrypt your messages, and it is fully encrypted during *all* its travel
-through the internet.
-
-Note that if you are having an encrypted conversation with a contact, you can
-*not* send XHTML-IM messages to him. They will be remove and be replaced by
-plain text messages.
-
-Installation and configuration
-------------------------------
-
-You should autoload this plugin, as it will send your signed presence directly
-on login, making it easier for your contact’s clients to know that you are
-supporting GPG encryption. To do that, use the _plugins_autoload_ configuration
-option.
-
-You need to create a plugin configuration file. Create a file named _gpg.cfg_
-into your plugins configuration directory (_~/.config/poezio/plugins_ by
-default), and fill it like this:
-
-[source,conf]
----------------------------------------------------------------------
-[gpg]
-keyid = 091F9C78
-passphrase = your OPTIONAL passphrase
-
-[keys]
-example@jabber.org = E3CFCDE2
-juliet@xmpp.org = EF27ABCD
----------------------------------------------------------------------
-
-The *Poezio* section is about your key. You need to specify the keyid, for the
-key you want to use. You can as well provide a passphrase. If you don’t, you
-should use a gpg agent or something like that that will ask your passphrase
-whenever you need it.
-
-The *keys* section contains your contact’s id keys. For each contact you want
-to have encrypted conversations with, add her/his JID associated with the keyid
-of his/her key.
-
-And that’s it, now you need to talk directly to the *full* jid of your
-contacts. Poezio doesn’t let you encrypt messages whom recipients is a bare
-JID.
-
-Additionnal information on GnuPG
---------------------------------
-
-Create a key
-~~~~~~~~~~~~
-
-To create a personal key, use
-==================
-gpg --gen-key
-==================
-and fill the instructions
-
-
-Keyid
-~~~~~
-The keyid (required in the gpg.cfg configuration file) is a 8 character-long
-key. You can get the ones you created or imported by using the command
-=======================
-gpg --list-keys
-=======================
-You will get something like
-
----------------------------------------------------------------------
-pub 4096R/01234567 2011-11-11
-uid Your Name Here (comment) <email@example.org>
-sub 4096R/AAFFBBCC 2011-11-11
-
-pub 2048R/12345678 2011-11-12 [expire: 2011-11-22]
-uid A contact’s name (comment) <fake@fake.fr>
-sub 2048R/FFBBAACC 2011-11-12 [expire: 2011-11-22]
----------------------------------------------------------------------
-
-In this example, the keyids are *01234567* and *12345678*.
-
-Share your key
-~~~~~~~~~~~~~~
-Use
-===========================
-gpg --send-keys --keyserver pgp.mit.edu <keyid>
-===========================
-to upload you public key on a public server.
-