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

@ -133,3 +133,13 @@ To handle pubsub signatures from command line, you may use
.. _XEP-0476: Pubsub Signing: OpenPGP Profile: https://xmpp.org/extensions/xep-0476.html
E2EE with Email Gateway
=======================
For compatible gateways, Libervia supports "Relayed" encryption, which is a method for using end-to-end encryption (E2EE). This feature is currently experimental and only works for emails.
If no key is known for an email recipient, Libervia uses Autocrypt. Autocrypt automatically exchanges encryption keys to enable what's called "opportunistic" encryption. While the security isn't as robust as proper key management and peer authentication, it still offers better protection than having no E2EE at all. Autocrypt is only used when a recipient’s key is not known by other, more secure means.
For more information about Autocrypt and its security model, please refer to `Wikipedia's Autocrypt page`_.
.. _Wikipedia's Autocrypt page: https://en.wikipedia.org/wiki/Autocrypt