From ed5640d8b587fbcfed7dd7967f3de04b37a76f26 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sun, 7 Apr 2024 11:06:44 +0200 Subject: Adding upstream version 4:7.4.7. Signed-off-by: Daniel Baumann --- helpcontent2/source/text/shared/guide/openpgp.xhp | 106 ++++++++++++++++++++++ 1 file changed, 106 insertions(+) create mode 100644 helpcontent2/source/text/shared/guide/openpgp.xhp (limited to 'helpcontent2/source/text/shared/guide/openpgp.xhp') diff --git a/helpcontent2/source/text/shared/guide/openpgp.xhp b/helpcontent2/source/text/shared/guide/openpgp.xhp new file mode 100644 index 000000000..f53e4e772 --- /dev/null +++ b/helpcontent2/source/text/shared/guide/openpgp.xhp @@ -0,0 +1,106 @@ + + + + + + + OpenPGP + /text/shared/guide/openpgp.xhp + + + + + OpenPGP;document encryption + file encryption;OpenPGP + public key;file encryption + private key;file encryption + file encryption;symmetric keys + +

Encrypting Documents with OpenPGP

+ %PRODUCTNAME can encrypt documents using OpenPGP public key cryptography. The document is encrypted using a symmetric encryption algorithm. +

+ According to https://bugs.documentfoundation.org/show_bug.cgi?id=125636#c16 , only ODF files can be signed with GPG + GPG signing only works for ODF documents. +

+ Choose menu File - Save as, select Encrypt with GPG key, Click Save. +

+ %PRODUCTNAME can encrypt documents confidentially using OpenPGP. The document is encrypted using a symmetric encryption algorithm, which requires a symmetric key. Each symmetric key is used only once and is also called a session key. The document and its session key are sent to the recipient. The session key must be sent to the recipients so they know how to decrypt the document, but to protect it during transmission it is encrypted with the recipient's public key. Only the private key belonging to the recipient can decrypt the session key. + + %PRODUCTNAME uses the OpenPGP software installed in your computer. If no OpenPGP software is available you must download and install one suitable for your operating system, likely from your application store or software distribution channel. + Here are some external GPG applications known to work with %PRODUCTNAME: + + + gpg4win on Windows + + + GPGTools on MacOS + + + On Linux, usually already installed: + gnupg - a command line utility for signing, encrypting and key management. + Graphical applications for gnupg such as Seahorse (gnome), Kleopatra and KGpg (KDE). + gpgme - an application program interface (API) to develop applications with GPG. + + + You must define a personal pair of cryptography keys with the OpenPGP application. Refer to the OpenPGP software installed on how to create a pair of keys, it is usually the first step to execute after the software installation. +

%PRODUCTNAME Encryption Setup

+ Choose menu %PRODUCTNAME - PreferencesTools - Options – User Data. In the Cryptography area: +

Encrypting documents

+ OpenPGP encryption requires the use of the public key of the recipient and this key must be available in the OpenPGP key chain stored in your computer. To encrypt a document: + + + Choose File – Save As, + + + Enter a name for the file. + + + Mark the Encrypt with GPG key checkbox. + + + Click Save. %PRODUCTNAME opens the OpenPGP public key selection dialog. + + + Choose the public key of the recipient. You can select multiple keys at the time. + + + Click OK to close the dialog and save the file. + + + The file is saved encrypted with the selected public keys. + Only the private key belonging to the recipient can decrypt the document, unless you also encrypt for yourself. +

Decrypting documents

+ You can only decrypt documents that have been encrypted with your public key. To decrypt a document: + + + Open the document. An Enter password prompt shows. + + + Enter the password of the OpenPGP private key. The document is decrypted and the contents is available. + + +

Difference between document encryption with OpenPGP and Save with password

+ + Both commands address confidentiality, but in different ways. + + When you save a document with a password, you must remember the password inserted to open the document later. Anyone else that needs to open the document must also know the password used at save time. Therefore, the Save password must be transmitted to be known by other users. + + Files encrypted with the save password cannot be decrypted unless the save password is supplied. + + With document OpenPGP encryption, you define the set of users that can decrypt the document and you don’t need to send passwords through channels which security is unknown. Besides, the OpenPGP application manages the key chain of public keys more efficiently. +

+ + Wikipedia on OpenPGP +

+ + -- cgit v1.2.3