1*b1cdbd2cSJim Jagielski<?xml version="1.0" encoding="UTF-8"?>
2*b1cdbd2cSJim Jagielski<helpdocument version="1.0">
3*b1cdbd2cSJim Jagielski
4*b1cdbd2cSJim Jagielski<!--***********************************************************
5*b1cdbd2cSJim Jagielski *
6*b1cdbd2cSJim Jagielski * Licensed to the Apache Software Foundation (ASF) under one
7*b1cdbd2cSJim Jagielski * or more contributor license agreements.  See the NOTICE file
8*b1cdbd2cSJim Jagielski * distributed with this work for additional information
9*b1cdbd2cSJim Jagielski * regarding copyright ownership.  The ASF licenses this file
10*b1cdbd2cSJim Jagielski * to you under the Apache License, Version 2.0 (the
11*b1cdbd2cSJim Jagielski * "License"); you may not use this file except in compliance
12*b1cdbd2cSJim Jagielski * with the License.  You may obtain a copy of the License at
13*b1cdbd2cSJim Jagielski *
14*b1cdbd2cSJim Jagielski *   http://www.apache.org/licenses/LICENSE-2.0
15*b1cdbd2cSJim Jagielski *
16*b1cdbd2cSJim Jagielski * Unless required by applicable law or agreed to in writing,
17*b1cdbd2cSJim Jagielski * software distributed under the License is distributed on an
18*b1cdbd2cSJim Jagielski * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
19*b1cdbd2cSJim Jagielski * KIND, either express or implied.  See the License for the
20*b1cdbd2cSJim Jagielski * specific language governing permissions and limitations
21*b1cdbd2cSJim Jagielski * under the License.
22*b1cdbd2cSJim Jagielski *
23*b1cdbd2cSJim Jagielski ***********************************************************-->
24*b1cdbd2cSJim Jagielski
25*b1cdbd2cSJim Jagielski
26*b1cdbd2cSJim Jagielski
27*b1cdbd2cSJim Jagielski
28*b1cdbd2cSJim Jagielski<meta>
29*b1cdbd2cSJim Jagielski      <topic id="textsharedguidedigitalsign_sendxhp" indexer="include" status="PUBLISH">
30*b1cdbd2cSJim Jagielski         <title xml-lang="en-US" id="tit">Applying Digital Signatures</title>
31*b1cdbd2cSJim Jagielski         <filename>/text/shared/guide/digitalsign_send.xhp</filename>
32*b1cdbd2cSJim Jagielski      </topic>
33*b1cdbd2cSJim Jagielski   </meta>
34*b1cdbd2cSJim Jagielski   <body>
35*b1cdbd2cSJim Jagielski<bookmark xml-lang="en-US" branch="index" id="bm_id7430951"><bookmark_value>signing documents with digital signatures</bookmark_value>
36*b1cdbd2cSJim Jagielski      <bookmark_value>digital signatures;getting/managing/applying</bookmark_value>
37*b1cdbd2cSJim Jagielski</bookmark><comment>mw transferred one entry from digital_signatures.xhp and added a new entry</comment>
38*b1cdbd2cSJim Jagielski<paragraph xml-lang="en-US" id="hd_id344248" role="heading" level="1" l10n="NEW"><variable id="digitalsign_send"><link href="text/shared/guide/digitalsign_send.xhp">Applying Digital Signatures</link>
39*b1cdbd2cSJim Jagielski</variable></paragraph><comment>MW created this file by splitting shared/guide/digital_signatures.xhp</comment>
40*b1cdbd2cSJim Jagielski<paragraph xml-lang="en-US" id="par_idN1063C" role="heading" level="2" l10n="NEW">Getting a Certificate</paragraph>
41*b1cdbd2cSJim Jagielski      <paragraph xml-lang="en-US" id="par_idN10640" role="paragraph" l10n="NEW">You can get a certificate from a certification authority, which may be a private company or a governmental institution. Some certification authorities want money for their service, for example when they certify your identity. Other certificates are free of costs, for example those offered by some e-mail providers, which certify your e-mail address. A few of the companies that offer certificates to private persons are listed in the following, in alphabetical order: <link href="http://www.globalsign.net">GlobalSign</link>, <link href="http://www.verisign.com">Verisign</link>.</paragraph>
42*b1cdbd2cSJim Jagielski      <paragraph xml-lang="en-US" id="par_idN106F6" role="heading" level="2" l10n="NEW">Managing your Certificates</paragraph>
43*b1cdbd2cSJim Jagielski<switch select="sys">
44*b1cdbd2cSJim Jagielski<case select="WIN">
45*b1cdbd2cSJim Jagielski<paragraph xml-lang="en-US" id="par_idN1070A" role="paragraph" l10n="NEW">If you are using Microsoft Windows, you can manage your certificates from the Control Panel applet "Internet Options" on the "Contents" tab page.</paragraph>
46*b1cdbd2cSJim Jagielski      <paragraph xml-lang="en-US" id="par_id8311410" role="paragraph" l10n="NEW">Import your new root certificate into the Trusted Root Certification Authorities list.</paragraph>
47*b1cdbd2cSJim Jagielski</case>
48*b1cdbd2cSJim Jagielski<default>
49*b1cdbd2cSJim Jagielski<paragraph xml-lang="en-US" id="par_idN1071D" role="paragraph" l10n="NEW">If you are using Solaris or Linux, you must install a recent version of Thunderbird, Mozilla Suite, or Firefox software to install some system files that are needed for encryption.<comment>how about Mac OS X?</comment></paragraph>
50*b1cdbd2cSJim Jagielski      <paragraph xml-lang="en-US" id="par_idN10720" role="tip" l10n="NEW">If you have created different profiles in Thunderbird, Mozilla, or Firefox, and you want %PRODUCTNAME to use one specified profile for certificates, then you can set the environment variable MOZILLA_CERTIFICATE_FOLDER to point to the folder of that specified profile.</paragraph>
51*b1cdbd2cSJim Jagielski      <list type="ordered">
52*b1cdbd2cSJim Jagielski         <listitem>
53*b1cdbd2cSJim Jagielski            <paragraph xml-lang="en-US" id="par_id944242" role="paragraph" l10n="NEW">Open your Web browser's preferences dialog, select the Privacy &amp; Security tab page, click on Certificates - Manage Certificates. </paragraph>
54*b1cdbd2cSJim Jagielski         </listitem>
55*b1cdbd2cSJim Jagielski         <listitem>
56*b1cdbd2cSJim Jagielski            <paragraph xml-lang="en-US" id="par_id6452223" role="paragraph" l10n="NEW">Import your new root certificate, then select and edit the certificate. Enable the root certificate to be trusted at least for web and email access. This ensures that the certificate can sign your documents. You may edit any intermediate certificate in the same way, but it is not mandatory for signing documents.</paragraph>
57*b1cdbd2cSJim Jagielski         </listitem>
58*b1cdbd2cSJim Jagielski         <listitem>
59*b1cdbd2cSJim Jagielski            <paragraph xml-lang="en-US" id="par_id6486098" role="paragraph" l10n="NEW">When you have edited the new certificates, restart %PRODUCTNAME.</paragraph>
60*b1cdbd2cSJim Jagielski         </listitem>
61*b1cdbd2cSJim Jagielski      </list>
62*b1cdbd2cSJim Jagielski</default>
63*b1cdbd2cSJim Jagielski</switch>
64*b1cdbd2cSJim Jagielski<paragraph xml-lang="en-US" id="par_idN10681" role="heading" level="2" l10n="NEW">Signing a document</paragraph>
65*b1cdbd2cSJim Jagielski      <list type="ordered">
66*b1cdbd2cSJim Jagielski         <listitem>
67*b1cdbd2cSJim Jagielski            <paragraph xml-lang="en-US" id="par_idN10688" role="paragraph" l10n="NEW">Choose <emph>File - Digital Signatures</emph>.</paragraph>
68*b1cdbd2cSJim Jagielski         </listitem>
69*b1cdbd2cSJim Jagielski         <listitem>
70*b1cdbd2cSJim Jagielski            <paragraph xml-lang="en-US" id="par_idN10690" role="paragraph" l10n="NEW">A message box advises you to save the document. Click <emph>Yes</emph> to save the file.</paragraph>
71*b1cdbd2cSJim Jagielski         </listitem>
72*b1cdbd2cSJim Jagielski         <listitem>
73*b1cdbd2cSJim Jagielski            <paragraph xml-lang="en-US" id="par_idN10698" role="paragraph" l10n="NEW">After saving, you see the <link href="text/shared/01/digitalsignatures.xhp">Digital Signatures</link> dialog. Click <emph>Add</emph> to add a public key to the document.</paragraph>
74*b1cdbd2cSJim Jagielski         </listitem>
75*b1cdbd2cSJim Jagielski         <listitem>
76*b1cdbd2cSJim Jagielski            <paragraph xml-lang="en-US" id="par_idN106AE" role="paragraph" l10n="NEW">In the <link href="text/shared/01/selectcertificate.xhp">Select Certificate</link> dialog, select your certificate and click OK. </paragraph>
77*b1cdbd2cSJim Jagielski         </listitem>
78*b1cdbd2cSJim Jagielski         <listitem>
79*b1cdbd2cSJim Jagielski            <paragraph xml-lang="en-US" id="par_idN106C0" role="paragraph" l10n="NEW">You see again the Digital Signatures dialog, where you can add more certificates if you want. Click OK to add the public key to the saved file.</paragraph>
80*b1cdbd2cSJim Jagielski         </listitem>
81*b1cdbd2cSJim Jagielski      </list>
82*b1cdbd2cSJim Jagielski      <paragraph xml-lang="en-US" id="par_idN106C3" role="paragraph" l10n="NEW">A signed document shows an icon
83*b1cdbd2cSJim Jagielski<image id="img_id262764" src="xmlsecurity/res/certificate_16.png" width="0.2228in" height="0.2228in"><alt xml-lang="en-US" id="alt_id262764">Icon</alt>
84*b1cdbd2cSJim Jagielski	</image> in the status bar. You can double-click the icon in the status bar to view the certificate.</paragraph>
85*b1cdbd2cSJim Jagielski      <paragraph xml-lang="en-US" id="par_id2008200911381426" role="paragraph" l10n="NEW">The result of the signature validation is displayed in the status bar and within the Digital Signature dialog. Several documents and macro signatures can exist inside an ODF document. If there is a problem with one signature, then the validation result of that one signature is assumed for all signatures. That is, if there are ten valid signatures and one invalid signature, then the status bar and the status field in the dialog will flag the signature as invalid.</paragraph>
86*b1cdbd2cSJim Jagielski      <paragraph xml-lang="en-US" id="par_idN106E0" role="heading" level="2" l10n="NEW">Signing the macros inside a document</paragraph>
87*b1cdbd2cSJim Jagielski      <paragraph xml-lang="en-US" id="par_idN106E4" role="paragraph" l10n="NEW">Normally, macros are part of a document. If you sign a document, the macros inside the document are signed automatically. If you want to sign only the macros, but not the document, proceed as follows:</paragraph>
88*b1cdbd2cSJim Jagielski      <list type="ordered">
89*b1cdbd2cSJim Jagielski         <listitem>
90*b1cdbd2cSJim Jagielski            <paragraph xml-lang="en-US" id="par_idN106EA" role="paragraph" l10n="NEW">Choose <emph>Tools - Macros - Digital Signature</emph>.</paragraph>
91*b1cdbd2cSJim Jagielski         </listitem>
92*b1cdbd2cSJim Jagielski         <listitem>
93*b1cdbd2cSJim Jagielski            <paragraph xml-lang="en-US" id="par_idN106F2" role="paragraph" l10n="NEW">Apply the signature as described above for documents.</paragraph>
94*b1cdbd2cSJim Jagielski         </listitem>
95*b1cdbd2cSJim Jagielski      </list>
96*b1cdbd2cSJim Jagielski      <paragraph xml-lang="en-US" id="par_idN106F5" role="paragraph" l10n="NEW">When you open the Basic IDE that contains signed macros, you see an icon
97*b1cdbd2cSJim Jagielski<image id="img_id9252296" src="xmlsecurity/res/certificate_16.png" width="0.2228in" height="0.2228in"><alt xml-lang="en-US" id="alt_id9252296">Icon</alt>
98*b1cdbd2cSJim Jagielski	</image> in the status bar. You can double-click the icon in the status bar to view the certificate.</paragraph><comment>WebDAV see issue 32935</comment><comment>main dialog IDs are here to lead the user initially to this help page</comment><comment>Examine certificate button</comment>
99*b1cdbd2cSJim Jagielski<!-- removed HID 1311740419 -->
100*b1cdbd2cSJim Jagielski<paragraph xml-lang="en-US" id="par_id5734733" role="paragraph" l10n="NEW"><ahelp hid="." visibility="hidden">Click to open the View Certificate dialog.</ahelp></paragraph><comment>Accept this certificate temporarily for this session radio button</comment>
101*b1cdbd2cSJim Jagielski<!-- removed HID 1311736321 -->
102*b1cdbd2cSJim Jagielski<paragraph xml-lang="en-US" id="par_id561540" role="paragraph" l10n="NEW"><ahelp hid="." visibility="hidden">Choose this setting to accept the certificate until you exit %PRODUCTNAME.</ahelp></paragraph><comment>Do not accept this certificate and do not connect to this Web site radio button</comment>
103*b1cdbd2cSJim Jagielski<!-- removed HID 1311736326 -->
104*b1cdbd2cSJim Jagielski<paragraph xml-lang="en-US" id="par_id7705618" role="paragraph" l10n="NEW"><ahelp hid="." visibility="hidden">Choose this setting to cancel the connection.</ahelp></paragraph>
105*b1cdbd2cSJim Jagielski      <section id="relatedtopics">
106*b1cdbd2cSJim Jagielski         <paragraph xml-lang="en-US" id="par_id3204443" role="paragraph" l10n="NEW"><link href="https://wiki.openoffice.org/wiki/How_to_use_digital_Signatures">English Wiki page on digital signatures</link></paragraph>
107*b1cdbd2cSJim Jagielski         <paragraph xml-lang="en-US" id="par_id5166173" role="paragraph" l10n="NEW"><link href="text/shared/guide/digital_signatures.xhp">About digital signatures</link></paragraph>
108*b1cdbd2cSJim Jagielski      </section>
109*b1cdbd2cSJim Jagielski   </body>
110*b1cdbd2cSJim Jagielski</helpdocument>