diff options
| author | Olivier Hallot <olivier.hallot@libreoffice.org> | 2018-12-02 22:46:19 -0200 |
|---|---|---|
| committer | Katarina Behrens <Katarina.Behrens@cib.de> | 2018-12-06 15:42:13 +0100 |
| commit | fe0a1e4dbf6de65be1820553fba7b7e215013f85 (patch) | |
| tree | b27f5a3b71d0a85c73e3124d36c441ea16ddd551 /source/text/shared/guide | |
| parent | 8e718f78ec456aa228240da579780391b51e8d9a (diff) | |
tdf#116078 OpenPGP encryption
+ some update (drop) references to LO file picker
Addressed comments by reviewer.
fix ordered list
Fixed reviewer comment.
Fixed DTD violations
Change-Id: Ie71f736a5713b042e185e93e595b6880ffe7541c
Reviewed-on: https://gerrit.libreoffice.org/64436
Tested-by: Jenkins
Reviewed-by: Katarina Behrens <Katarina.Behrens@cib.de>
Diffstat (limited to 'source/text/shared/guide')
| -rw-r--r-- | source/text/shared/guide/cmis-remote-files-setup.xhp | 9 | ||||
| -rw-r--r-- | source/text/shared/guide/digital_signatures.xhp | 1 | ||||
| -rw-r--r-- | source/text/shared/guide/openpgp.xhp | 104 |
3 files changed, 106 insertions, 8 deletions
diff --git a/source/text/shared/guide/cmis-remote-files-setup.xhp b/source/text/shared/guide/cmis-remote-files-setup.xhp index 8a91ca9ad3..d32ddab8a9 100644 --- a/source/text/shared/guide/cmis-remote-files-setup.xhp +++ b/source/text/shared/guide/cmis-remote-files-setup.xhp @@ -15,10 +15,8 @@ <filename>/text/shared/guide/cmis-remote-files-setup.xhp</filename> </topic> </meta> - <body> - <section id="setup_remote_files"> <bookmark xml-lang="en-US" branch="hid/svtools/uiconfig/ui/placeedit/@@nowidget@@" id="@@nowidget@@" localize="false"/> <bookmark xml-lang="en-US" branch="hid/svtools/uiconfig/ui/placeedit/PlaceEditDialog" id="bm_id3137069" localize="false"/> @@ -26,10 +24,8 @@ <bookmark_value>remote file service;setup</bookmark_value> </bookmark> - <paragraph id="hd_id200820161036353610" role="heading" level="1" xml-lang="en-US"><link href="text/shared/guide/cmis-remote-files-setup.xhp">Setting up a remote file service connection</link></paragraph> </section> -<paragraph id="par_id150820161816033788" role="note" xml-lang="en-US">To access remote servers, you must use %PRODUCTNAME’s own Open and Save dialogs. If you currently use your operating system dialogs for saving and opening files, go to <item type="menuitem">Tools - Options - %PRODUCTNAME - General</item> and check the option <item type="menuitem">Use %PRODUCTNAME dialogs</item>.</paragraph> <section id="howtoget"> <paragraph id="par_id150820161816033744" role="paragraph" xml-lang="en-US">To enable a remote server connection, use one of these methods:</paragraph> @@ -44,14 +40,13 @@ <listitem> <paragraph id="par_id150820161816037870" role="ul_item" xml-lang="en-US">Select <item type="menuitem">File - Save to Remote Server</item></paragraph> </listitem></list> -<paragraph id="par_id150820161816033600" role="paragraph" xml-lang="en-US">Then click on the Add Service button in the dialog to open the File Services dialog.</paragraph> + <paragraph id="par_id150820161816033600" role="paragraph" xml-lang="en-US">Then press <widget>Add Service</widget> button in the dialog to open the File Services dialog.</paragraph> </section> <bookmark xml-lang="en-US" branch="index" id="bm_id170820162240508275"> <bookmark_value>WebDAV;remote file service setup</bookmark_value> <bookmark_value>remote file service setup;WebDAV</bookmark_value> </bookmark> - <paragraph id="hd_id1501201618160340" role="heading" level="3" xml-lang="en-US">Connecting to a <link href="text/shared/00/00000002.xhp#webdav">WebDAV</link> server</paragraph> <paragraph id="par_id150820161816034989" role="paragraph" xml-lang="en-US"><variable id="introservice">In the File Services dialog, set:</variable></paragraph> @@ -83,7 +78,6 @@ <bookmark_value>remote file service setup;SSH</bookmark_value> </bookmark> - <paragraph id="hd_id1508201618160340" role="heading" level="3" xml-lang="en-US">Connecting to <link href="text/shared/00/00000002.xhp#ftp">FTP</link> and SSH servers</paragraph> <paragraph id="par_id150820161816034969" role="paragraph" xml-lang="en-US" localize="false"><embedvar href="text/shared/guide/cmis-remote-files-setup.xhp#introservice" markup="keep"/></paragraph> @@ -212,5 +206,4 @@ <paragraph id="par_id210820161039438142" role="paragraph" xml-lang="en-US"><link href="text/shared/guide/cmis-remote-files.xhp#check">Checking-in and checking-out documents</link></paragraph> </section> </body> - </helpdocument> diff --git a/source/text/shared/guide/digital_signatures.xhp b/source/text/shared/guide/digital_signatures.xhp index 39046bc15e..84ff4cfeaa 100644 --- a/source/text/shared/guide/digital_signatures.xhp +++ b/source/text/shared/guide/digital_signatures.xhp @@ -100,6 +100,7 @@ <paragraph xml-lang="en-US" id="par_id6075624" role="paragraph">On Windows operating systems, the Windows features of validating a signature are used. On Solaris and Linux systems, files that are supplied by Thunderbird, Mozilla or Firefox are used. You must ensure that the files that are in use within your system are really the original files that were supplied by the original developers. For malevolent intruders, there are numerous ways to replace original files with other files that they supply.</paragraph> <paragraph xml-lang="en-US" id="par_id6819971" role="warning">The messages about validation of a signature that you see in %PRODUCTNAME are the messages that the validation files return. The %PRODUCTNAME software has no way to ensure that the messages reflect the true status of any certificate. The %PRODUCTNAME software only displays the messages that other files that are not under control of %PRODUCTNAME report. There is no legal responsibility of %PRODUCTNAME that the displayed messages reflect the true status of a digital signature.</paragraph> <section id="relatedtopics"> + <paragraph role="paragraph" id="par_id681543699425744" localize="false"><embedvar href="text/shared/guide/openpgp.xhp#openpgphead" markup="ignore"/></paragraph> <paragraph xml-lang="en-US" id="par_id3204443" role="paragraph"><link href="https://wiki.documentfoundation.org/How_to_use_digital_Signatures" name="wiki.documentfoundation.org: How to use digital Signatures">English Wiki page on digital signatures</link></paragraph> <paragraph xml-lang="en-US" id="par_id486465" role="paragraph"><link href="text/shared/guide/digitalsign_send.xhp">Applying digital signatures</link></paragraph> <paragraph xml-lang="en-US" id="par_id3448591" role="paragraph"><link href="text/shared/guide/digitalsign_receive.xhp">Opening a document using WebDAV over HTTPS</link></paragraph> diff --git a/source/text/shared/guide/openpgp.xhp b/source/text/shared/guide/openpgp.xhp new file mode 100644 index 0000000000..d24a450d8d --- /dev/null +++ b/source/text/shared/guide/openpgp.xhp @@ -0,0 +1,104 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + <!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + --> + + <meta> + <topic id="encryptopenpgp" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">OpenPGP</title> + <filename>/text/shared/guide/openpgp.xhp</filename> + </topic> + </meta> + <body> + <bookmark xml-lang="en-US" branch="index" id="bm_id361543701916002"> + <bookmark_value>OpenPGP;document encryption</bookmark_value> + <bookmark_value>file encryption;OpenPGP</bookmark_value> + <bookmark_value>public key;file encryption</bookmark_value> + <bookmark_value>private key;file encryption</bookmark_value> + <bookmark_value>file encryption;symmetric keys</bookmark_value> + </bookmark> + <section id="openpgphead"> + <h1 id="hd_id131543693200115"><link href="text/shared/guide/openpgp.xhp" name="openpgp">Encrypting Documents with OpenPGP</link></h1> + <paragraph id="par_id531543693200117" role="paragraph" xml-lang="en-US"><ahelp hid=".">%PRODUCTNAME can encrypt documents using OpenPGP public key cryptography. The document is encrypted using a symmetric encryption algorithm.</ahelp></paragraph> + </section> + <section id="howtoget"> + <paragraph role="paragraph" id="par_id551543694091730" xml-lang="en-US">Choose menu <menuitem>File - Save as</menuitem>, select <widget>Encrypt with GPG key</widget>, Press <widget>Save</widget>.</paragraph> + </section> + <paragraph role="paragraph" id="par_id421543694016897">%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.</paragraph> + + <paragraph role="paragraph" id="par_id931543694032072">%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.</paragraph> + <paragraph role="paragraph" id="par_id131543846940809">Here are some external GPG applications known to work with %PRODUCTNAME:</paragraph> + <list type="unordered"> + <listitem> + <paragraph id="par_id831543846877587" role="listitem"><emph>gpg4win</emph> on Windows</paragraph> + </listitem> + <listitem> + <paragraph id="par_id191543846891252" role="listitem"><emph>GPGTools</emph> on MacOS</paragraph> + </listitem> + <listitem> + <paragraph id="par_id791543846905735" role="listitem">On Linux, usually already installed:</paragraph> + <paragraph id="par_id411544099245722" role="listitem"><emph>gnupg</emph> - a command line utility for signing, encrypting and key management.</paragraph> + <paragraph id="par_id811544099299847" role="listitem">Graphical applications for gnupg such as <emph>Seahorse</emph> (gnome), <emph>Kleopatra</emph> and <emph>KGpg</emph> (KDE).</paragraph> + <paragraph id="par_id631544099446081" role="listitem"><emph>gpgme</emph> - an application program interface (API) to develop applications with GPG.</paragraph> + </listitem> + </list> + <paragraph role="paragraph" id="par_id461543694043196">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.</paragraph> + <h2 id="hd_id881543694319935">%PRODUCTNAME Encryption Setup</h2> + <embed href="text/shared/optionen/01010100.xhp#cryptointro"/> + <paragraph role="paragraph" id="par_id611543699681558">Choose menu <menuitem>Tools – Options – User Data</menuitem>. In the <emph>Cryptography</emph> area:</paragraph> + <embed href="text/shared/optionen/01010100.xhp#opengpg"/> + <h2 id="hd_id251543694437685">Encrypting documents</h2> + <paragraph role="paragraph" id="par_id121543694447798">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:</paragraph> + <list type="ordered"> + <listitem> + <paragraph id="par_id501543694474227" role="listitem" xml-lang="en-US">Choose <menuitem>File – Save As</menuitem>,</paragraph> + </listitem> + <listitem> + <paragraph id="par_id641543694535615" role="listitem">Enter a name for the file.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id621543694550648" role="listitem">Mark the <widget>Encrypt with GPG key</widget> checkbox.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id91543694595310" role="listitem">Press <widget>Save</widget>. %PRODUCTNAME opens the OpenPGP public key selection dialog.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id31543694619204" role="listitem">Choose the public key of the recipient. You can select multiple keys at the time.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id811543694660297" role="listitem">Press <widget>OK</widget> to close the dialog and save the file.</paragraph> + </listitem> + </list> + <paragraph role="paragraph" id="par_id981543694776604">The file is saved encrypted with the selected public keys.</paragraph> + <warning id="par_id851543694185733">Only the private key belonging to the recipient can decrypt the document, unless you also encrypt for yourself.</warning> + <h2 id="hd_id81543694812238">Decrypting documents</h2> + <paragraph role="paragraph" id="par_id731543694835151">You can only decrypt documents that have been encrypted with your public key. To decrypt a document:</paragraph> + <list type="ordered"> + <listitem> + <paragraph id="par_id801543694880414" role="listitem">Open the document. An Enter password prompt shows.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id891543694892170" role="listitem">Enter the password of the OpenPGP private key. The document is decrypted and the contents is available.</paragraph> + </listitem> + </list> + <h2 id="hd_id811543694928568">Difference between document encryption with OpenPGP and Save with password</h2> + + <paragraph role="paragraph" id="par_id391543694940352">Both commands address confidentiality, but in different ways.</paragraph> + + <paragraph role="paragraph" id="par_id331543694947279">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.</paragraph> + + <paragraph role="paragraph" id="par_id351543694955038">Files encrypted with the save password cannot be decrypted unless the save password is supplied.</paragraph> + + <paragraph role="paragraph" id="par_id681543694965846">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.</paragraph> + <section id="relatedtopics"> + <paragraph role="paragraph" id="par_id681543699425744" localize="false"><embedvar href="text/shared/guide/digital_signatures.xhp#digital_signatures" markup="ignore"/></paragraph> + <paragraph role="paragraph" id="par_id51543697316590"><link href="https://en.wikipedia.org/wiki/Pretty_Good_Privacy#OpenPGP" name="Wikipedia on OpenPGP">Wikipedia on OpenPGP</link></paragraph> + </section> +</body> +</helpdocument> |