doc (components, encryption): add documentation on autocrypt for client and email gateway:

fix 456
This commit is contained in:
Goffi 2025-02-28 09:23:35 +01:00
commit 2346dfb461

View file

@ -977,6 +977,18 @@ specification. This works by indicating to client how to format and encrypt the
(in technical terms, it's by telling it to use MIME and OpenPGP) before sending it to the
gateway. This only works with clients implementing this specification.
Autocrypt
~~~~~~~~~
The gateway relays "Autocrypt" headers, which is a way to share public keys without
relaying them to a key server. In layman's terms, it's a way to exchange encryption data
to be able to encrypt messages automatically. However, while better than not using
end-to-end encryption, this method is not as secure as proper management of encryption
keys and authentication of the peer we're talking to.
Please refer to `Wikipedia's Autocrypt page`_ for more details, in particular on its
security model
.. note::
@ -989,4 +1001,5 @@ gateway. This only works with clients implementing this specification.
.. _XEP-0106 (JID Escaping): https://xmpp.org/extensions/xep-0106.html
.. _XEP-0131 (Stanza Headers and Internet Metadata): https://xmpp.org/extensions/xep-0131.html
.. _XEP-0498 (Pubsub File Sharing): https://xmpp.org/extensions/xep-0498.html
.. _Wikipedia's Autocrypt page: https://en.wikipedia.org/wiki/Autocrypt