source/text/shared/guide/main.xhp | 3
source/text/swriter/classificationbar.xhp | 136 ++++++++++++++++++++++++++----
2 files changed, 123 insertions(+), 16 deletions(-)
New commits:
commit 38af1adac0c495b5865cd70d8a29163ec2fcdc14
Author: Olivier Hallot <ohal...@collabora.co.uk>
Date: Wed Aug 3 19:32:03 2016 -0300
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 <ohal...@collabora.co.uk>
Tested-by: Olivier Hallot <ohal...@collabora.co.uk>
diff --git a/source/text/shared/guide/main.xhp
b/source/text/shared/guide/main.xhp
index 5f4b33b..c8564a8 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 92b7a83..ac6c8d0 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 -> Options -> LibreOffice -> Paths ->
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 ->
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 -> 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>
_______________________________________________
Libreoffice-commits mailing list
libreoffice-comm...@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/libreoffice-commits
