summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorOlivier Hallot <ohallot@collabora.co.uk>2016-08-03 19:32:03 -0300
committerOlivier Hallot <ohallot@collabora.co.uk>2016-08-17 13:24:19 +0000
commit38af1adac0c495b5865cd70d8a29163ec2fcdc14 (patch)
tree74c92e74e9c7c0e7392d34b4dabb50bf713d00ae
parent2e141341684eb610834db92693d715f3fd01d0dd (diff)
Document classification help page enhancements
Added more information on Objective of classification Categories Levels Customization Pasting contents Toolbar Grammar and liguistics checks welcome. Corrected lawsuits Change-Id: Ibdf652a9ee7927fa10262c7b3b54f1d750bf72c6 Reviewed-on: https://gerrit.libreoffice.org/27857 Reviewed-by: Olivier Hallot <ohallot@collabora.co.uk> Tested-by: Olivier Hallot <ohallot@collabora.co.uk>
-rw-r--r--source/text/shared/guide/main.xhp3
-rw-r--r--source/text/swriter/classificationbar.xhp136
2 files changed, 123 insertions, 16 deletions
diff --git a/source/text/shared/guide/main.xhp b/source/text/shared/guide/main.xhp
index 5f4b33ba89..c8564a8e81 100644
--- a/source/text/shared/guide/main.xhp
+++ b/source/text/shared/guide/main.xhp
@@ -43,6 +43,7 @@
<embed href="text/shared/guide/doc_open.xhp#doc_open"/>
<embed href="text/shared/guide/workfolder.xhp#workfolder"/>
<embed href="text/shared/guide/doc_save.xhp#doc_save"/>
+<embed href="text/swriter/classificationbar.xhp#classdoc"/>
<embed href="text/shared/guide/collab.xhp#collab"/>
<embed href="text/shared/guide/export_ms.xhp#export_ms"/>
<embed href="text/shared/guide/import_ms.xhp#import_ms"/>
@@ -206,4 +207,4 @@
<embed href="text/shared/guide/digital_signatures.xhp#digital_signatures"/>
</body>
-</helpdocument> \ No newline at end of file
+</helpdocument>
diff --git a/source/text/swriter/classificationbar.xhp b/source/text/swriter/classificationbar.xhp
index 92b7a83025..ac6c8d092b 100644
--- a/source/text/swriter/classificationbar.xhp
+++ b/source/text/swriter/classificationbar.xhp
@@ -1,29 +1,135 @@
<?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/.
- -->
-<helpdocument version="1.0">
+ *
+-->
+
<meta>
-<topic id="textswriterclassificationbarxml" indexer="include" status="PUBLISH">
-<title id="tit" xml-lang="en-US">Classification Bar</title>
-<filename>/text/swriter/classificationbar.xhp</filename>
-</topic>
+ <topic id="textswriterclassificationbarxml" indexer="include" status="PUBLISH">
+ <title id="tit" xml-lang="en-US">Document Classification</title>
+ <filename>/text/swriter/classificationbar.xhp</filename>
+ </topic>
</meta>
+
<body>
+
+<paragraph id="hd_id3156324" role="heading" level="1" xml-lang="en-US"><variable id="classdoc"><link href="text/swriter/classificationbar.xhp" name="Document Classification">Document Classification</link> </variable></paragraph>
+<bookmark xml-lang="en-US" branch="index" id="bm_id030820161847569710">
+ <bookmark_value>classification;BAILS levels</bookmark_value>
+ <bookmark_value>classification;BAF category</bookmark_value>
+ <bookmark_value>classification;security levels</bookmark_value>
+ <bookmark_value>classification;document</bookmark_value>
+ <bookmark_value>classification;classification bar</bookmark_value>
+ <bookmark_value>document;classification</bookmark_value>
+</bookmark>
+
+<paragraph id="par_id030820161744119967" role="paragraph" xml-lang="en-US">Document classification and security is an important issue for businesses and governments.</paragraph>
+<paragraph id="par_id030820161744113553" role="paragraph" xml-lang="en-US">Information is exchanged between users and organizations that collaborate to pursue a business goal. Where sensitive information is involved, it is assumed that the parties will have agreed what information is sensitive and how such information will be identified and handled. Any recipient of a resource will rely upon the provider of the information to follow the agreed procedures to identify the sensitivity of the information.</paragraph>
+<paragraph id="par_id030820161744118823" role="paragraph" xml-lang="en-US">%PRODUCTNAME provides standardized means for such sensitivity information to be expressed and may be used between parties if interoperable systems are to be implemented. It provides a set of standard “fields” that can be used to hold sensitivity information. It does not attempt to define what the contents of these “fields” should be. This approach is an improvement upon the only alternative that exists at the moment, which is for the provider to use an arbitrary means to express sensitivity that may not be useful to a recipient.</paragraph>
+<paragraph id="par_id030820161744121143" role="paragraph" xml-lang="en-US">While this standard has been developed with the intent that it would be applicable in any domain of activity, %PRODUCTNAME retained the aerospace and defense industry nomenclature and categories, where sensitivity marking results from national security, export control and intellectual property policies.</paragraph>
+<paragraph id="par_id030820161744123676" role="paragraph" xml-lang="en-US">%PRODUCTNAME implemented the open standards produced by <item type="acronym">TSCP</item> (Transglobal Secure Collaboration Participation, Inc.) independent of a specific vendor. Two of them are interesting:</paragraph>
+
+<list type="unordered">
+ <listitem>
+ <paragraph id="par_id030820161744122593" role="ul_item" xml-lang="en-US">Business Authentication Framework (<item type="acronym">BAF</item>) specifies how to describe the existing policy (which is probably some legal text) in a machine-readable format.</paragraph>
+ </listitem>
+ <listitem>
+ <paragraph id="par_id030820161744126871" role="ul_item" xml-lang="en-US">Business Authorization Identification and Labeling Scheme (<item type="acronym">BAILS</item>) specifies how to refer to such a <item type="acronym">BAF</item> policy in a document. The concepts in <item type="acronym">BAILS</item> are so generic that they can be applied to any format that supports document-level user-defined properties.</paragraph>
+ </listitem></list>
+
+<paragraph id="hd_id030820161800093929" role="heading" level="2" xml-lang="en-US">BAF Categories</paragraph>
+<bookmark xml-lang="en-US" branch="index" id="bm_id030820161856432825">
+ <bookmark_value>classification;displayed in user interface</bookmark_value>
+ <bookmark_value>classification;headers and footers</bookmark_value>
+ <bookmark_value>classification;watermark</bookmark_value>
+ <bookmark_value>classification;categories</bookmark_value>
+</bookmark>
+
+<paragraph id="par_id030820161800092823" role="paragraph" xml-lang="en-US">The default BAF categories for %PRODUCTNAME are listed below.</paragraph>
+<paragraph id="par_id030820161800098142" role="tip" xml-lang="en-US">Only the Intellectual Properties category will modify the layout of the document with a watermark, fields in the header and footer and an information bar on top of the document area. Each item inserted in the document is controlled by the classification configuration file.</paragraph>
+<paragraph id="par_idN106B0" role="heading" level="3" xml-lang="en-US">Intellectual Property</paragraph>
+<paragraph id="par_idN106C0" role="paragraph" xml-lang="en-US">Intellectual property is a generic term for the nature of the contents of the document. Select this category for general purpose document classification.</paragraph>
+<paragraph id="par_idN106CD" role="heading" level="3" xml-lang="en-US">National Security</paragraph>
+<paragraph id="par_idN106DD" role="paragraph" xml-lang="en-US">Selects the category of this document for the national security policy type. The selected category is saved together with the document as BAILS metadata in the file properties and no modifications is carried in the document layout or the user interface.</paragraph>
+<paragraph id="par_idN106EA" role="heading" level="3" xml-lang="en-US">Export Control</paragraph>
+<paragraph id="par_idN106FA" role="paragraph" xml-lang="en-US">Selects the category of this document for the export control policy type. The selected category is saved together with the document as BAILS metadata in the file properties and no modifications is carried in the document layout or the user interface.</paragraph>
+<paragraph id="par_id030820161800091021" role="warning" xml-lang="en-US">Refer to your corporate data security policy and information security officers for support in document classification.</paragraph>
+<paragraph id="hd_id030820161747122444" role="heading" level="2" xml-lang="en-US">Default levels of classification</paragraph>
+<bookmark xml-lang="en-US" branch="index" id="bm_id030820161849574719">
+ <bookmark_value>classification levels;Internal use only</bookmark_value>
+ <bookmark_value>classification levels;Confidential</bookmark_value>
+ <bookmark_value>classification levels;General Business</bookmark_value>
+ <bookmark_value>classification levels;Non-Business</bookmark_value>
+</bookmark>
+
+<paragraph id="par_id030820161747139337" role="paragraph" xml-lang="en-US">%PRODUCTNAME provides default levels of document classification (<item type="acronym">BAILS</item>) shown below, sorted by increasing level of business sensitivity:</paragraph>
+
+<list type="unordered">
+ <listitem>
+ <paragraph id="par_id030820161747135421" role="ul_item" xml-lang="en-US"><emph>Non-Business</emph>: Information in document has no impact in business, if made public.</paragraph>
+ </listitem>
+ <listitem>
+ <paragraph id="par_id030820161747132341" role="ul_item" xml-lang="en-US"><emph>General Business</emph>: Minor impact. Information has impact in business, can generate embarrassments, minor damage in brand image, if made public.</paragraph>
+ </listitem>
+ <listitem>
+ <paragraph id="par_id030820161747139845" role="ul_item" xml-lang="en-US"><emph>Confidential</emph>: Modest impact. Information disclosed can damage business brand, can generate negative media coverage and loss of revenue.</paragraph>
+ </listitem>
+ <listitem>
+ <paragraph id="par_id030820161747138519" role="ul_item" xml-lang="en-US"><emph>Internal use only</emph>: Major damage. Negative national media, lawsuits, fines, long term brand damages.</paragraph>
+ </listitem></list>
+
+<paragraph id="hd_id030820161747134459" role="heading" level="2" xml-lang="en-US">Customizing classification levels.</paragraph>
+<bookmark xml-lang="en-US" branch="index" id="bm_id030820161851045883">
+ <bookmark_value>custom;classifcation levels</bookmark_value>
+ <bookmark_value>classifcation levels;customizing</bookmark_value>
+</bookmark>
+
+<paragraph id="par_id030820161747133280" role="paragraph" xml-lang="en-US">%PRODUCTNAME allows customization of the levels of classification for your business. To customize the number and the name of the levels, copy the file <item type="literal">example.xml</item> located in <item type="menuitem">Tools -&gt; Options -&gt; LibreOffice -&gt; Paths -&gt; Classification</item> into a local folder and edit the contents.</paragraph>
+<paragraph id="par_id03082016174713477" role="tip" xml-lang="en-US">Use the file with your %PRODUCTNAME locale in the name as example.</paragraph>
+<paragraph id="par_id030820161747137522" role="paragraph" xml-lang="en-US">Save the file and make the classification path above access the file.</paragraph>
+<paragraph id="par_id030820161747135133" role="tip" xml-lang="en-US">Your system administrator can place the file in a network folder and make all users access the classification settings file.</paragraph>
+
+<paragraph id="hd_id03082016174713354" role="heading" level="2" xml-lang="en-US">Pasting contents in documents with different levels of classification.</paragraph>
+<bookmark xml-lang="en-US" branch="index" id="bm_id030820161851512902">
+ <bookmark_value>document classification;pasting contents</bookmark_value>
+</bookmark>
+
+<paragraph id="par_id030820161747134188" role="paragraph" xml-lang="en-US">To prevent a breach in the security policy, contents with high classification level pasted to documents with lower classification level are not allowed. %PRODUCTNAME will display a warning message wherever it detects that the contents of the clipboard have higher security classification than the target document.</paragraph>
+
<section id="toolbar">
-<paragraph role="heading" id="hd_id3150342" xml-lang="en-US" level="1"><link href="text/swriter/classificationbar.xhp" name="Classification Bar">Classification Bar</link></paragraph>
-<paragraph role="paragraph" id="par_id3150202" xml-lang="en-US"><ahelp hid=".">The <emph>Classification</emph> bar contains tools to help secure document handling.</ahelp></paragraph>
+
+<paragraph id="hd_id3150342" role="heading" level="1" xml-lang="en-US"><link href="text/swriter/classificationbar.xhp" name="Classification Bar">Classification Bar</link></paragraph>
+<bookmark xml-lang="en-US" branch="index" id="bm_id030820161853495457">
+ <bookmark_value>Classification toolbar;display</bookmark_value>
+</bookmark>
+
+<paragraph id="par_id3150202" role="paragraph" xml-lang="en-US"><ahelp hid=".">The <emph>Classification</emph> bar contains tools to help secure document handling.</ahelp></paragraph>
+<paragraph id="par_id030820161754171423" role="paragraph" xml-lang="en-US">The Classification toolbar contains listboxes to help in selecting the security of the document, according to the <item type="acronym">BAF</item> category policy and <item type="acronym">BAILS</item> levels. %PRODUCTNAME will add custom fields in the document properties (<item type="menuitem">File -&gt; Properties</item>, Custom fields tab) to store the classification policy as document metadata.</paragraph>
+
+<section id="howtoget">
+<paragraph id="par_id030820161754175408" role="paragraph" xml-lang="en-US">Go to menu <item type="menuitem">View -&gt; Toolbars </item>and select <item type="menuitem">Classification</item></paragraph>
+</section>
+
+
+<section id="relatedtopics">
+
+<list type="unordered">
+ <listitem>
+ <paragraph id="par_id030820161818081317" role="ul_item" xml-lang="en-US"><link href="http://www.tscp.org/about-tscp/"><item type="acronym">TSCP</item> (Transglobal Secure Collaboration Participation, Inc.) website</link>.</paragraph>
+ </listitem>
+ <listitem>
+ <paragraph id="par_id030820161818082152" role="ul_item" xml-lang="en-US"><link href="http://www.tscp.org/wp-content/uploads/2013/08/TSCP_BAFv1.pdf">Business Authentication Framework (<item type="acronym">BAF</item>) document (PDF)</link></paragraph>
+ </listitem>
+ <listitem>
+ <paragraph id="par_id030820161818085901" role="ul_item" xml-lang="en-US"><link href="http://www.tscp.org/wp-content/uploads/2013/08/TSCP_BAILSv1.pdf">Business Authorization Identification and Labeling Scheme (<item type="acronym">BAILS</item>) document (PDF)</link></paragraph>
+ </listitem></list>
+</section>
</section>
-<paragraph role="paragraph" id="par_id31502029" xml-lang="en-US">The purpose of this toolbar is that in case the user is required to follow a policy when editing a document, then $[officename] can help the user respect these rules in case $[officename] is informed about the rules. Transglobal Secure Collaboration Participation (TSCP) provides standards to describe document classification: Business Authentication Framework (BAF) describes how to specify a policy this toolbar can handle, and Business Authorization Identification and Labeling Scheme (BAILS) describes how to refer to this policy in documents.</paragraph>
-<paragraph role="heading" id="par_idN106B0" xml-lang="en-US" level="2">Intellectual Property</paragraph>
-<paragraph role="paragraph" id="par_idN106C0" xml-lang="en-US">Selects the category of this document from the available BAF categories for the intellectual property policy type. The selected category influences the infobar, headers, footers and the watermark of the document.</paragraph>
-<paragraph role="heading" id="par_idN106CD" xml-lang="en-US" level="2">National Security</paragraph>
-<paragraph role="paragraph" id="par_idN106DD" xml-lang="en-US">Selects the category of this document for the national security policy type. The selected category is saved together with the document as BAILS metadata, but it does not influence the user interface.</paragraph>
-<paragraph role="heading" id="par_idN106EA" xml-lang="en-US" level="2">Export Control</paragraph>
-<paragraph role="paragraph" id="par_idN106FA" xml-lang="en-US">Selects the category of this document for the export control policy type. The selected category is saved together with the document as BAILS metadata, but it does not influence the user interface.</paragraph>
</body>
+
</helpdocument>