Administration Guide
Administration Guide
Forcepoint
Report
Forcepoint
December 20, 2022
forcepoint.com Forcepoint Proprietary
GetVisibility: Administration Guide forcepoint.com
Table of Contents
AGENT CONFIGURATION................................................................................................................................................. 2
Login into system and Navigate to the agent configuration ......................................................................................... 2
COMPLIANCE....................................................................................................................................................................... 4
Expert Mode .................................................................................................................................................................. 4
Wizard Mode ................................................................................................................................................................. 6
CLASSIFICATION .................................................................................................................................................................. 8
Expert Mode .................................................................................................................................................................. 8
Wizard Mode ............................................................................................................................................................... 10
MS OFFICE PLUGINS......................................................................................................................................................... 13
Expert Mode ................................................................................................................................................................ 13
Wizard Mode ............................................................................................................................................................... 14
MS OFFICE POLICIES & VISUAL TAGGING .......................................................................................................................... 16
Expert Mode ................................................................................................................................................................ 16
Wizard Mode ............................................................................................................................................................... 20
OUTLOOK PLUGINS ........................................................................................................................................................... 23
Expert Mode ................................................................................................................................................................ 23
Wizard Mode ............................................................................................................................................................... 24
OUTLOOK POLICIES & VISUAL TAGGING ............................................................................................................................ 25
Expert Mode ................................................................................................................................................................ 25
Wizard Mode ............................................................................................................................................................... 32
CONFIGURE EMAILS .......................................................................................................................................................... 45
Expert Mode ................................................................................................................................................................ 45
Wizard Mode ............................................................................................................................................................... 47
GENERIC SETTINGS .......................................................................................................................................................... 49
Write Metadata Tags: .................................................................................................................................................. 49
AUTOLABELLING ............................................................................................................................................................... 50
Expert Mode: ............................................................................................................................................................... 50
CAUTION ........................................................................................................................................................................... 52
REPORTS .......................................................................................................................................................................... 53
Agent Activity Report ................................................................................................................................................... 53
Agent Incident Report.................................................................................................................................................. 53
AGENT MANAGEMENT ....................................................................................................................................................... 53
ADMINISTRATION ............................................................................................................................................................ 54
PATTERN MATCHING ......................................................................................................................................................... 54
USER MANAGEMENT ......................................................................................................................................................... 58
Using the portal ........................................................................................................................................................... 58
Using LDAP method .................................................................................................................................................... 61
Agent Configuration
Login into system and Navigate to the agent configuration
1. Login to the Forcepoint Data Classification Powered by GetVisibility portal using the credentials given to you.
3. The dashboard UI offers a wizard to set/update an agent configuration. There are three possible ways to setup the
configuration:
→ Configuration Import Mode: Using this mode, the user can upload an existing configuration from local files. Note
that only json format is accepted. A validity check will be done, and an error message is shown in case the file does
not have a valid json content. This mode usually used by the GetVisibility as a part of their personalized services.
→ Expert Mode: This mode is useful when the user wants to manually edit the agent configuration at their own risk.
Like the previous mode, if the content is not a valid json or not a valid agent configuration structure, a list of errors will
be displayed to the user.
→ Configuration Wizard Mode: This mode is the easiest to use and guides the user through configuring the rules and
uses for the agents. When the user chooses this mode, they will be guided through a few steps to set agent
configuration fields one by one.
4. The first option Configuration Import can be used by simply uploading the config file. Select the Configuration Import
option and the dialog box will open using where the user must select the Json file.
5. Once the configuration is uploaded, Click Finish to save the new config.
In the below section go through the various configurable options that can be applied to the agent using both Expert mode and
Wizard mode.
Compliance
Compliance is the act of conforming to a company directive, rule, policy, or standard or law. Some common compliance regulations
and labels are: GDPR, PII, HIPAA, PHI, PCI. GetVisibility agent gives the user two options to customize and configure compliance
as per their requirements.
Expert Mode
Using the Expert mode, the user can add the compliance tags by making changes in the agent configuration json file. User can add
custom compliance or any of the standard compliance.
5. Configuration saved successfully message will be displayed on the screen along with the OK button.
6. Click on the OK button and the user is returned to the main GetVisibility agent configuration page.
7. To verify the Configuration:
a) Open a word document.
Wizard Mode
Using Wizard Mode, the user can select the compliance tags selecting the check box on screen.
3. Keep selecting Next to only change the compliance tags. The Last step of the wizard is displayed.
Classification
Data classification is broadly defined as the process of organizing data by relevant categorizes so that it can be used and protected
more efficiently. On a basic level, the classification process makes data easier to locate and retrieve. By default, the GetVisibility
classification is Public, Internal and Confidential.
Expert Mode
Using the Expert mode, the user can add the compliance tags by making changes in the agent configuration json file. User can add
custom compliance or any of the standard compliance tags.
5. Configuration saved successfully message will be displayed on the screen along with the OK button.
6. Click on the OK button. The user will return to the main GetVisibility agent configuration page.
7. To verify the Configuration:
a) Open a word document.
b) Select the GetVisibility icon on the top-right of the ribbon.
c) User will be able to see the added custom tags.
Wizard Mode
The user can select the classification by selecting the radio button on the screen.
4. Keep clicking on Next to only change compliance tags. The last step of the wizard the agent will be displayed.
MS Office Plugins
This functionality will allow the user to select which MS Office application the configuration will be applicable to.
Expert Mode
Using the Expert mode, the user can enable/disable the Office Plugins by making changes in the agent configuration json file.
Wizard Mode
Using the Wizard mode, the user can select the application for the configuration will be applicable by selecting the check-box on
screen.
3. Keep selecting Next to only change the compliance. The last step of the wizard the agent will display.
This functionality allows the user to set various to enforce on documents in MS Office applications.
Expert Mode
Using the Expert mode, the user can enable/disable the policies related to MS Office by making changes in agent configuration
json file.
→ PowerPointSubtitle: This will add a Subtitle to the PowerPoint. This policy is optional.
→ PowerPointTitle: This will add a Subtitle to the PowerPoint. This policy is optional.
Example of Config:
→ OfficeConfiguration:
"header": "<span>Classified as {classification} by Getvisibility®</span>",
"footer": "",
"watermark": "",
"tagDirtyBuffersOnSave": "force",
"tagBeforePrint": "ignore",
"allowDeEscalation": false,
"excelTextForwardingActive": false,
7. If the user has manually edited the header or footer and then changed the classification of the document the agent will show
a dialog box showing the notification for placing the new location of the classification.
8. Header Corner has been selected and the classification is placed in the corner without overriding the original header.
9. As tagDirtyBuffersOnSave = Force is configured, the user cannot save the document without classifying it. The
option to Dismiss the notification is disabled which will be enabled when tagDirtyBuffersOnSave = Warn is used.
10. As tagBeforePrint = Warn is configured, the option to Dismiss the notification is enabled which will be disabled when
the tagBeforePrint = Force is used. There will be no notification tagBeforePrint = Log & Ignore is used.
11. As allowDeEscalation = False is configured, the user will not be allowed to lower the level of classification on the
document and all the lower classification options will be disabled.
12. As excelTextForwardingActive = False is configured, text from the MS Office app will not be sent to classifier for
suggestions.
Wizard Mode
Using the Wizard mode, the user can easily enable/disable the policies related to MS office.
3. Keep clicking on Next to only change the compliance tags. The Last step of the wizard the agent will display.
7. If the Force option is selected. The user cannot save the document without classifying it. The option to Dismiss the
notification is disabled which will be enabled when the user selects Warn.
8. If the Warn option is selected, user can Dismiss the notification while printing. This will be disabled when the user selects
Force. There will be no notification for the Log & Ignore.
9. The lower classification option has not been selected. So, user is not allowed to lower the level of classification on the
document and all the lower classification options are disabled:
Outlook Plugins
Expert Mode
Using the Expert mode, user can enable/disable the Outlook Plugins by editing the agent configuration json.
5. Configuration saved successfully message will be displayed on the screen along with the OK button.
6. To verify the Configuration:
a) Open Outlook.
b) user can see the GetVisibility icon on the top-right is enabled.
c) user can be able to click the icon and classify the email, if the OutlookPluginActive = false is configured the
same icon will be disabled.
Wizard Mode
Using the Wizard mode, the user can enable/disable the Outlook Plugins by making changes in the Data Visibility UI.
This functionality will allow the user to set various polies that they can enforce on emails when using Outlook.
Expert Mode
Using the Expert mode, the user can enable/disable the policies related to Outlook by editing the agent configuration json.
"OutlookPluginActive": true,
"footer": "",
"tagOnSend": "force",
"tagOnPrint": "force",
"allowUnclassifiedAttachments": "block",
"minAttachmentsTag": "block",
"allowDeEscalation": true,
"autoClassifyReplyForwardEmails": true,
7. When tagOnSend = force is configured, users cannot send emails without classifying. Select Dismiss to keep editing or
OK to classify.
8. When tagOnSend = Warn is configured users will be able to send email without classifying. Select Dismiss to send the
email or OK to classify.
9. If tagOnSend = Log&Ignore is set no notification will be displayed.
10. When tagOnPrint = force is configured, users cannot print emails without classifying. Select Dismiss to keep editing
the email or OK to classify.
11. When tagOnPrint = Warn is configured, the user can send the email without classifying it. Select Dismiss to send the
email and OK to classify.
12. When tagOnPrint = Log&Ignore is configured no notification will be displayed.
13. With allowUnclassifiedAttachments = Block, the user cannot send any attachment in the email without classifying
it.
14. allowUnclassifiedAttachments = Warn: The user can send the attachment in the email without classifying it, but
agent will give a warning.
15. allowUnclassifiedAttachments = Log&Allow: The user can send the attachment in the email without classifying
without any warning.
16. minAttachmentsTag = Block: In this case the attachment is highly confidential, and the email is on lower level of
classification, so the agent will not allow sending the email. The user will have to change the classification of either the
attachment or the email, otherwise they will not be able to send.
17. minAttachmentsTag = Warn: In this case the attachment is highly confidential, and the email is on lower level of
classification, so the agent will only warn the user. They will still be able to send the email.
18. minAttachmentsTag = Log&Allow: The user will be able send any attachment in the email without any warning.
19. allowDeEscalation = False: The user will not be allowed to lower the level of classification on the document and all
the lower classification options will be disabled.
20. autoClassifyReplyForwardEmails = False: The user has the option to set the classification for forwarding/reply to
an email. As seen below the original email is classified as internal but that is not inherited when forwarding or replying.
21. autoClassifyReplyForwardEmails = True, As seen below while forwarding the email, it has inherited the
classification from the original email.
Wizard Mode
3. Verify the settings on Outlook: the header can be seen but not the footer.
4. If the user changes the setting and footer is added in the config, the wizard and outlook will look as below:
5. To set Outlook polices, the user has selected Force to classify and send the email The user cannot send the email without
classifying it. The option to Dismiss is to keep editing the email and OK is to classify.
6. The last option is Log & ignore, where the user can send the email without classification or warning.
7. The last option is of Log & ignore where user can send the email without classification and without any warning.
8. As the user has selected Force to classify and print the email, they cannot print the email without classifying it. The option to
Dismiss is to keep editing the email and OK is to classify.
9. The other two options are Warn and Log&Ignore where the user will be able to print the email without classifying it. The
option to Dismiss is to print the email and OK is to classify. With the Log&Ignore there will be no warning at all.
10. As the user has selected Block, the user cannot send the any attachment in the email without classifying it.
11. The other two options are: Warn and Log&Ignore, where the user will be able send the attachment in the email without
classifying but with a warning.
12. The user has selected Block for the last option, in this case the attachment is highly confidential, and the email is on a lower
level of classification, so the agent will not allow to send the email. The user will have to change the classification of either
the attachment or the email, otherwise they will not be able to send the email.
13. If user has selects Warn, in this case the attachment is highly confidential, and the email is on lower level of classification, so
the agent will only warn the user, but the user will still be able to send the email.
14. The final option here also is Log&Allow, where the user will be able send any attachment in the email without any warning.
15. The checkbox User lowers classification level of a classified email in unchecked, the user will not be allowed to lower
the level of classification on the document and all the lower classification options will be disabled.
16. The checkbox Inherit classification when Reply and Forward emails in unchecked, the user has the option to set the
classification for the forwarding/reply email and as seen below the original email is classified as internal but that is not
inherited while forward/reply email is applied.
17. The checkbox Inherit classification when Reply and Forward emails in checked, As seen below while forwarding the
email, it has inherited the classification from the original email.
Configure Emails
Expert Mode
Using Expert Mode, the user can enable/disable default policies related to email by editing the agent configuration json.
"configurationOverrides": [
"classification": "Public"
"defaultEmailPolicy": "block",
"blockList": [],
"warnList": ["[email protected]],
"allowList": []
4. The above configuration says that for public type emails are blocked for sending, except for the recipient
[email protected], whom the email can be sent to but with a warning message.
5. Validating the configuration as below. Since all the public emails are blocked from sending and the recipient lab user is not
on the allow or warn list the email can be sent.
6. If we change the recipient to [email protected], the agent will give only a warning as the recipient was in the warn list,
but the email can still be sent.
Wizard Mode
Using the Wizard Mode, the user can enable/disable the policies related to Outlook.
4. Validating the configuration as below. Since all the public emails are blocked from sending and the recipient lab user is not
on the allow or warn list the email can be sent.
5. If the recipient is changed to: [email protected], the agent will only give a warning as the recipient was in the warn list,
but the email can still be sent.
6. The same settings can be done for Internal/Confidential/Highly Confidential emails as well with one additional option to copy
the configuration from the previous classification.
Generic Settings
This property will capture the details about the agent in office applications. The below screenshot is from the config file.
SelectableByWhitelist: Based on the distribution list, the email addresses in this list will be the ones Outlook plugin will allow
sending emails to.
AllowInternalToExternal: This property allows the user to change the distribution list from internal to external.
MaxNumberOfRecipients: This property allows setting the maximum number of people the user wants to send the email to.
SuggestionOptions: This tag will allow users to configure the options they want to show while showing the suggestion box on MS
Office or Outlook.
AgentDialogConfiguration: This tag will allow the user to customize the options they want to show while showing labels such as
compliance classification etc.
DistributionTags: Additional feature to classify the documents/emails. Few examples are: Internal/Restricted/ External/Limited.
AutoLabelling
This optional feature allows users to automatically classify with a default label all newly created documents and emails in Word,
Excel, PowerPoint, and Outlook. It is possible to individually set the default label for each plugin. Users will be able to select the
classification label that they want to apply to documents and email and when there is edit or change in the file and the file is saved
the selected classification will be applied. Setting Autolabelling will allow the user to not to classify the documents every time the file
is printed or saved, the classification will happen automatically.
Expert Mode:
The property used in Expert Mode is: defaultClassificationValue. The defaultClassificationValue is set for
Outlook, Word, Excel, and PowerPoint:
Caution
While using the expert mode the user must be extra careful about the small details like punctuations and formatting of the file, else
the agent will through and error like below.
Reports
There are two reports related to Data Classification as shown below:
Agent Management
Agent Management gives the user a high-level status of all the agents installed. Details like Name of agent, the IP address and
When was the agent last seen is shown on this dashboard. User can also see if the agent is Online or not. The facility to filter the
agent based on Name, Health, and State also is provided.
Administration
Pattern Matching
Using Pattern Matching UI you can view, save, create, and edit RegEx patterns. These the associated rules for each pattern will be
suggested to users of the agents if the RegExs are found.
1. Select the Add New Pattern button to create a new RegEx pattern, a new window will open to enter the RegEx pattern.
2. Add a new RegEx pattern. An example RegEx for Student ID which is made of 7 digits and 2 letters is shown.
3. The tags can be added for the new RegEx as shown below and Select Create.
6. After selecting Publish, the classification pipeline restarts to pick up the enabled RegEx patterns for matching.
8. Restarting of the classification pipeline may take a few minutes. Once complete, open a Word document and enter a
configured RegEx pattern. In this example: Student ID (7 digits and 2 letters).
a) The RegEx pattern has been found and the suggestions of GDPR/PII:100% for Compliance and Confidential for
Classification are given.
b) Users can then select Use Suggested; GDPR/PII and Confidential will get selected and the document will be
classified.
c) Users also have the option to ignore the suggestion and use any other values to classify.
User Management
In the User Management screen, new users can be created to access the User Interface. There are two ways to create new users:
2. User will be asked to login into Keycloak portal (Credentials will be shared separately).
3. Navigate to the User section and Select the Add User button.
4. Select Save.
5. Select Credentials. The user will be able to set the password for the new login, using this method they can create a new
user or view the existing users.
End of Document
About Forcepoint
© 2022 Forcepoint. Forcepoint and the FORCEPOINT logo are trademarks of Forcepoint.
All other trademarks used in this document are the property of their respective owners.
[Forcepoint Data Classification Powered by GetVisibility Administration Guide] [Status]20
Dec. 22
© 2022 Forcepoint Forcepoint Proprietary
62