Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Contents

Table of Contents
minLevel1
maxLevel3

...

Prepared By

Reviewed By

Date

Document Version

Software Version

Ashima Agarwal

Artem Kalaitan

13-June-2022

V 1

V 2.8

Ashima Agarwal

Artem Kalaitan

25-July-2022

V2

V 2.10

Ashima Agarwal

Artem Kalaitan

10-Aug-2022

V4

V 2.10

...

Anchor
_heading=h.tyjcwt
_heading=h.tyjcwt
Agent Configuration

Login into system and navigate to the agent configuration

Login into the Getvisibilityapplication using the credentials given to you

...

The first option of Configuration Import can be used by simply uploading the config file. Click on Select the Configuration Import option and the dialog box will open where the user must select a JSON file.

...

The configuration will be uploaded. When the user clicks Selects Finish the new config will be saved

...

Anchor
_heading=h.2s8eyo1
_heading=h.2s8eyo1
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. Getvisbility agent gives the user two options to customise and configure compliance as per their requirements.

...

Using Expert Mode, the user can add compliance tags by making changes in the agent configuration JSON file. One can add custom compliance or any of the standard compliance tags.

  • Click on Select Expert Mode

  • Scroll down to the compliance section

  • Add the values

    • It can be seen below that EAR/US and CustomCompliaceExample have been added

  • Click on Select Finish

...

‘Configuration saved successfully’ message will be displayed on the screen along with the OK button.

...

  • Click on Select the OK button and the user is returned to the main Getvisibility agent configuration page.

  • To verify the Configuration, open a word document, click on Select the Getvisibility icon in the top-right of the ribbon. The user will be able to see the custom tags.

...

Using Wizard Mode, the user can select the compliance tags selecting the check box on screen.

  • Click on Select Configuration Wizard Mode

  • Below, GDPR/PII has been selected as a compliance tag. Click Select Next.

...

Keep clicking Selecting on Next to only change the compliance tags. The Last step of the wizard is displayed below.

Click Select Finish and following message will be displayed

...

To verify the Configuration, open a Word document, click on Select the Getvisibility icon on the top-right of the ribbon. The user will be able to see the selected tags.

...

Anchor
_heading=h.26in1rg
_heading=h.26in1rg
Classification

Data classification is broadly defined as the process of organising data by relevant categories so that it may 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.

...

Using Expert Mode, the user can add compliance tags by making changes in the agent configuration JSON file. One can add custom compliance or any of the standard compliance tags.

  • Click on Select Expert Mode

  • Scroll down to the classification section

  • Add the values.

    • It can be seen below that CustomClassification has been added in Expert Mode

  • Click on Select the Finish button

...

‘Configuration saved successfully’ message will be displayed on the screen along with the OK button.

...

  • Click on Select the OK button.The user is returned to the main Getvisibility agent configuration page.

  • To verify the Configuration, open a Word document, click on Select the Getvisibility icon on the top-right of the ribbon. The user will be able to see the custom tags.

...

The user can select the classification by selecting the radio button on screen.

  • Click on Select the Configuration Wizard Mode

  • The user has selected Commercial Option as classification

  • Click Select Next.

...

Keep clicking Selecting on Next to only change the compliance tags.The Last step of the wizard the agent will be displayed.

Click Select Finish and following message will be displayed

...

To verify the Configuration, open a Word document, click on Select the Getvisibility icon on the top-right of the ribbon. The user will be able to see the selected tags.

...

Anchor
_heading=h.1ksv4uv
_heading=h.1ksv4uv
MS Office Plugins

This functionality will allow the user to select which MS Office application the configuration will be applicable to.

...

Using Expert mode, the user can enable/disable the Office Plugins by making changes the agent configuration JSON file.

  • Click on Select Expert Mode

  • Scroll down to the Office Configuration section

  • Add the values.

    • It can be seen below that wordPluginActive is set to FALSE

  • Click on Select the Finish button

...

To verify the Configuration, open a Word document, the user will see that the Getvisibility icon on the top-right is disabled. The user will not be able to click Select it.

...

Anchor
_heading=h.2jxsxqh
_heading=h.2jxsxqh
Wizard Mode

Using Wizard Mode, the user can select the which application the configuration will be applicable to by selecting the check-box on screen.

  • Click on Select Configuration Wizard Mode

  • As seen below, the user has selected only Word Plugin as the option. Click Select Next.

...

Keep clicking Selecting on Next to only change the compliance tags. The Last step of the wizard the agent will display:

...

  • Click Select Finish and the settings will be applied.

  • To verify the Configuration, open a Word document, and the user should be able to view the Getvisibility icon and if the user clicks Selects on the icon the compliance and classifications box will be displayed.

...

To verify the Configuration, open a Excel document, user will see that the Getvisibility icon on the top-right is disabled, and user will not be able to click Select it

...

MS Office Policies & Visual Tagging

This functionality allows the user to set various policies to enforce on documents in MS Office applications.

...

Using Expert mode, the user can enable/disable the policies related to MS Office by making changes agent configuration JSON file.

  • Click on Select Expert Mode

  • Scroll down to the OfficeConfiguration section

  • The available policies:

    • Header: - This will add a Header to the document. The user can leave it empty or customise it as needed

    • Footer: - This will add a Footer to the document. The user can leave it empty or customise it as needed

    • Watermark: - This will add a Watermark to the document. The user can leave it empty or customise it as needed

    • TagBeforePrint: - This option will Force, Warn or Log & Ignore (allow) the user to classify any document before printing

    • TagDirtyBufferOnSave: - This option will Force, Warn or Log & Ignore (allow) the user to classify any document before saving

    • AllowDescalation: - This option allows the user to lower the classification level of a classified document.

    • ExcelTextForwardingActive: This is a scraping feature, it tells the plugin to scrape the text from within an app like Word or Excel and then forward it to the classifier for a suggestion. This option can be set using True or False.

    • PowerpointSubtitle:- This will add a Subtitle to the PowerPoint. This policy is optional.

    • PowerpointTitle:- This will add a title to the PowerPoint. This policy is optional.

  • Example of Config:

...

Code Block
"header": "<span>Classified as {classification} by Getvisibility&reg;</span>",

      "footer": "",

      "watermark": "",

      "tagDirtyBuffersOnSave": "force",

      "tagBeforePrint": "ignore",

      "allowDeEscalation": false,

      "excelTextForwardingActive": false,

  • Click on Select the Finish button

  • Verify the documents based on the config above

  • As per the config the user should be able to see the header and footer. The watermark should be blank.

...

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:

  • Image RemovedImage Added
  • As excelTextForwardingActive = Falseis configured, text from the MS Office app will not be sent to classifier for suggestions.

...

Using Wizard Mode, the user can easily enable/disable the policies related to MS office.

  • Click on Select Configuration Wizard Mode

  • Navigate to Word, Excel, PowerPoint Policies

Keep clicking Selecting on Next to only change the compliance tags. Last step of the wizard the agent will display:

...

  • Click Select Finish and the settings will be applied.

  • Verify the documents based on the selection above

  • The user should be able to see the header and footer, the watermark should be blank:

...

Anchor
_heading=h.4i7ojhp
_heading=h.4i7ojhp
Outlook Plugins

This functionality will allow users to configure Outlook classification plugin.

Expert Mode

Using Expert mode, user users can enable/disable Outlook Plugins by making changes in editing the agent configuration JSON file on agent .

  • Click on Select Expert Mode

  • Scroll down to OutlookConfiguration section

  • Add values.

    • It can be seen below that OutlookPluginActive is set to True in expert mode as an the example.

  • Click on Select the Finish Button button

  • Image RemovedImage Added
  • 'Configuration saved successfully’ message will be displayed on screen along with the OK button.

  • To verify the Configuration, open Outlook, the user will see that the Getvisibility icon on the top-right is enabled, and . The user will be able to click Select it and classify the email, if the OutlookPluginActive = false is configured the same icon will be disabled.

...

Wizard Mode

Using the Wizard modeMode, the user can enable/disable the Outlook Plugins by making changes in the agent screen.

...

Focus UI

  • Select Configuration Wizard Mode

  • There are total of 12 steps in the Wizard and Outlook Plugin is selected on the third step.

  • As seen below user has selected Outlook option Select Outlook

  • Then click Select Next.

...

  • Click Select Finish to apply configuration

  • To verify the Configuration, open word a Word document.

  • The Getvisibility icon will be enabled.

  • Clicking Selecting on the icon will show the compliance and classifications box for where the user to classify document.

...

Anchor
_heading=h.3whwml4
_heading=h.3whwml4
Outlook Policies & Visual Tagging

This functionality will allow the user to set various polies that the user would like to policies that they can enforce on documents emails when using Outlook.

Expert Mode

Using the Expert mode, the user can enable/disable the policies related to office Outlook by making changes in editing the agent configuration JSON file on the agent itself.

  • Click on the Select Expert Mode

  • Scroll down to the OutlookConfiguration section

  • The polies that we can set are as belowavailable policies:

    • Header: - This will add a Header to the email. User The user can leave it empty or customize customise it as needed

    • Footer: - This will add a Footer to the email. User The user can leave it empty or customize customise it as needed

    • TagOnPrint: - Using this option you can will Force, Warn, or Log & Ignore the user (allow) users to classify any modified email before printing .

    • TagOnSend: - Using this option you can will Force, Warn, or Log & Ignore the user (allow) users to classify any modified email before sending

    • allowUnclassifiedAttachments - Using this option you can will Block, Warn, or Log & Allow the user (allow) users to send unclassified attachments in email. emails

    • minAttachmentsTag - This option will allow the user users to Inherit the minimal classification from a classified attachment to the email.

    • allowDescalation: - This option allows the user users to lower the classification level of a classified email.

    • autoClassifyReplyForwardEmails - This option allows the user users to inherit the classification level when replying or forwarding an email.

Example of Config is as below:config:

Code Block
"outlookPluginActive": true,

...



 "header": "<h2 style=\"font-style:italic\"><span style=\"font-     size:14px\">Classified as {classification} by Getvisibility&reg;  Ashima</span></h2>",

...



      "footer": "",

...



      "tagOnSend": "force",

...



      "tagOnPrint": "force",

...



      "allowUnclassifiedAttachments": "block",

...



      "minAttachmentsTag": "block",

...



      "allowDeEscalation": true,

...



      "autoClassifyReplyForwardEmails": true,

  • Click on Select the Finish Button Verify the documents based on the config abovebutton

  • As per the config user should be able to see , the header and the footer should be blank as displayed below.

...

If the user changes the config and footer is added the config and the outlook will look as below:

...

  • :

...

Adding a footer to an Outlook email using the configuration file:

Code Block
header": "<span style=\"color:#008004;\"><h2 style=\"font-style:italic\"><span style=\"font-size:14px\">Classified as {classification} by Getvisibility&reg; </span></h2></span>",

...



 "footer": "<span style=\"color:#008004;\"><span><strong>Classified as {classification} by Getvisibility&reg; </strong></span></span>"

...

As When tagOnSend = force, the user is configured users cannot send the email emails without classifying it. The option to Select Dismiss is to keep editing the email and or OK is to classify the email.

...

  • As When tagOnSend = Warn, the user is configured users will be able to send the email without classifying it. The option to Select Dismiss is to send the email and or OK is to classify the email.

  • And if the If tagOnSend = Log&Ignore then is set no notification will be displayed.

...

As When tagOnPrint = force, the user is configure users cannot print the email emails without classifying it. The option to Select Dismiss is to keep editing the email and or OK is to classify the email.

...

  • If tagOnPrint = Warn, the user will be able to send the email without classifying it. The option to Dismiss is to send the email and OK is to classify the email.

  • And if the tagOnPrint = Log&Ignore then no notification will be displayed.

  • allowUnclassifiedAttachments = Block, the user cannot send any attachment in the email without classifying it.

...

Using Wizard mode, user can enable/disable policies related to Outlook by making changes on the screen.

  • Click on Select the Configuration Wizard Mode

  • Below we will see the settings on the wizard and the result for the same.

  • The Header is selected on wizard and footer is left blank

...

If the user changes the setting and footer is added the config and the wizard and outlook will look as below:

...

Image RemovedImage Added

Moving on to set the Outlook polices, the user has selected Force to classify and send the email, user cannot send the email without classifying it. The option to Dismiss is to keep editing the email and OK is to classify the email.

...

Anchor
_heading=h.3as4poj
_heading=h.3as4poj
Configure Emails

Expert Mode

Using the Expert modeMode, the user can enable/disable default policies related to email by making changes in the JSON file on the agent itself.

  • Click on the Select Expert Mode

  • Scroll down to the configurationOverrides section

  • The polies policies that we can set are as below:

    • Classification: - Here the user can select which type of email he wants to configure. The options are Public/Internal/Confidential/Highly Confidential

    • DefaultEmailPolicy: - Here the user can set the policy to Block/Allow/Warn about the email.

    • BlockList: - The agent gives the option to create a blocklist of specific recipients. User will just have to add the email id of recipient in the list.

    • WarnList: - The agent gives the option to create a warnlist of specific recipients. User will just have to add the email id of recipient in the list.

    • AllowList: - The agent gives the option to create an allowlist of specific recipients. User will just have to add the email id of recipient in the list.

  • Sample config file is as below:

...

  • The above configuration says that for Public type emails are blocked for sending, except for the recipient aagarwal@getvisibility.com, whom the email can be sent but with a warning message.

  • 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.

...

If we change the recipient to aagarwal@getvisibility.com, agent will give only a warning as the recipient was in the warn list, but the email can still be sent.

...

Using the Wizard mode, the user can enable/disable the policies related to Outlook by making changes in the on the screen directly.

  • Click on Select the Configuration Wizard Mode

  • There is total 12 steps in Wizard and Outlook polices starts from 8th step.

  • As shown below the Public emails are by default set to Block but 1 recipient is allowed to send the email with a warning.

...

If we change the recipient to aagarwal@getvisibility.com, agent will give only a warning as the recipient was in the warn list, but the email can still be sent.

...

Anchor
_heading=h.2p2csry
_heading=h.2p2csry
Generic Settings

WriteMetadataTags :-

This property will capture the details about the agent in office applications. The below screenshot is from the config file.

...

Based on the distribution list, the email addressed in this list will be the once that the outlook Outlook plugin will allow sending emails to.

...

Additional feature to classify the documents/emails. Few examples are: Internal/Restricted/ External/Limited

AutoLabelling

This optional feature allows to automatically classify with a default label all newly created docs in Word, Excel,Powerpoint and Outlook emails. It is possible to individually set the default label for each plugin individually. User will be able to select the classification label that he wants 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.

...

Wizard Mode for Outlook:

...

Caution

While using Expert Mode the expert mode the user has to 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 Synergy as shown below:

...

For users of Getvisibility Synergy, this report gives an overview of the security related activity undertaken by users of GVClient agents. It visualises data such as: de-escalations, mis-classifications, and confidential data in infographic form to give organisation’s a quick understanding of the data their users are passing through their network.

...

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 pattern, then the backend will process it and agent give suggestions based on the regex created.

...

Click on Select the Add New Button button to create a new Regex pattern, a new window will open to enter the regex pattern

...

The tags and be added for the new regex as shown below and click on Select Create

...

As you can see the new pattern in created but right now it is unpublished

...

User also has the option to Edit/Delete the regex pattern

...

After clicking Selecting on Publish, the classification services starts so that the backend can process the new regex pattern

...

As you can see below we have entered the student ID as per the regex and we can see the agent giving us the suggestion that is is GDPR/PII:100% and Classification as Confidential.

...

User can then select on Select Use Suggested; GDPR/PII and Confidential will get selected and the documents will be classified.

...

User also has the option to ignore the suggestion and use any other values to classify.

User Management

Using the user management users will be able to create new users to access the application. There are 2 ways to create new users:

Using the portal

Click on Select the User Management option of the portal

...

Navigate to the User Section and click on Select the Add User Buttonbutton

...

Click on Select the Save:

...

Click Select in credentials user will be able to set the password for the new login, using this method we can create a new user or view the existing users.

...

Expand
Include Page
Getvisibility Reseller Keycloak Quick Installation Guide
Getvisibility Reseller Keycloak Quick Installation Guide

End of Document