Skip to main content

InfoSecurity Guard Installation Guide

Raise a support ticket

DISCLAIMER​

Any advice FYB provides in relation to setting up any FYB App, FYB Add-in, FYB Connector and or advice in relation to opening access to your on-premise or in the cloud systems will be general advice only. This means that the advice is of a general nature and will not take into account your network setup, network infrastructure or any security requirements that you may have or in fact need. It is highly advised that you seek advice from internal or external providers to ensure that they are comfortable with what is required prior to going ahead with any deployment, setup or configuration for external access.

LICENSE DETAILS​

Please contact FYB for a valid license if you have yet to obtain one for your Connector.

INSTALLATION COMPONENTS​

The following installation components are required to ensure the full functionality of InfoSecurity Guard:

  • Installation of InfoSecurity Guard External Link, this is a server-side installation
  • Installation of InfoSecurity Guard Event Add-in, this is a server-side installation

INSTALLING INFOSECURITY GUARD​

INSTALLATION​

  1. Create a folder for FYB Addins on your Workgroup Server For Example: ‘X:\HPE Content Manager\FYB Addins\

  2. Right click on the FYB Addins folder > Properties > click on the Sharing tab

  3. If the Network Path is set to ‘Not Shared’

    image.png

  4. Click on the Advanced Sharing button

image.png

  1. In the Advanced Sharing window, enable Share this folder option and remove the space between FYB and Addins, then add a ‘$’ sign which will keep the folder hidden

    image.png

  2. Click on the Permissions button

  3. Give Everyone the ‘Read’ permission

    image.png

  4. A Network Path will now be available

  5. Create a license folder inside the FYB Addins folder and place the license in this folder. This path will be required during the MSI installation

    Example

    X:\HPE Content Manager\FYB Addins\Licenses

  6. Once the above folders have been created run the infosecurityguard-111-32bit/64bit.msi from the desired Workgroup Server

  7. Before running the installer, please ensure you have administrative privileges.

  8. Run the installer and click on the Next button

    image.png

  9. On the Configuration Settings screen, enter the dataset ID, License Path and Internal Domain

    image.png

    NAME OF FIELDFUNCTIONALITY
    Dataset IDThe ID of the Content Manager dataset to be used with InfoSecurity Guard.
    Workgroup Sever NameThe workgroup server name used to connect to the Content Manager dataset. The workgroup server name OR workgroup URL can be utilised.
    Workgroup Sever URLThe workgroup server URL used to connect to the Content Manager dataset. The workgroup server name OR workgroup URL can be utilised.
    License PathThe path of the license file for InfoSecurity Guard within the network shared folder created in step 9. E.g “\Server\fybaddins$\Licenses\InfoSecurityGuard_ddMMyyyy.lic”
    Internal DomainUse this option to indicate the domain of the organisation. Prior to sending an email, this domain will be checked to determine if the email is being sent internally or externally.
  10. Click on the Next button

  11. On the Configuration Settings (Cont.) screen, select the configuration for: a. The Security Classification; b. Document Marker Action; and c. Dissemination Limiting Markers.

2020-08-10_12-32-06

NAME OF FIELDFUNCTIONALITY
Security Classification
- Use Security Level
- Use Additional Field
Use this option to indicate how Security Classifications are to be set in Content Manager. For more information, refer to the section **Creating Security Classifications and DLMs **
Document Marker Action
- Prevent
- Warn
- Do Nothing
Use this option to indicate the action that should happen when security markers are set on a record, but not present in the document.
Prevent: Users cannot confirm or send documents that do not contain all the security markers that are on the record.
Warn: Users receive a warning message when they email a document that does not contain all the security markers that are on the record.
Do Nothing: Users are not notified if a document does not contain all of the security markers that are on the record.
Dissemination Limiting Markers
- Use Security Caveats
- Use Additional Fields
Use this option to indicate how Dissemination Limiting Markers are to be set in Content Manager. For more information, refer to the section **Creating Security Classifications and DLMs **
  1. Click on the Next button

  2. On the Configuration Settings (Cont.) screen, choose additional settings as required.

    2020-08-10_12-30-53

  3. Click on the Next button

  4. Confirm the install directory. Ensure to use the directory created in step 1 followed by “FYB InfoSecurity Guard\”.

    image.png

  5. Click on the Install button

2020-08-10_12-32-56

  1. If a security prompt appears, click on the Yes button

    image.png

  2. Once the installation is complete, click on the Finish button

    image.png

CONFIGURATION​

  1. In Content Manager click on Tools > Administration > External Links

    image.png

  2. Right click in the Content Manager external links window and select New External Link

    2023-09-11_16-50-07.png

  3. Click on the External Executable listing

    2023-09-11_16-51-47.png

  4. Enter the Link Name as Email Record(s)

  5. Under ‘Folder or Subfolder’, enter the Shared Path of the folder InfoSecurity Guard was installed into.

    Note

    Please use the fully qualified domain name (FQDN) when adding the External Link. For Example: If the share has been set up as \server\FYBAddIns$\InfoSecurity Guard The FQDN is \server.domain.local\FYBAddIns$\InfoSecurity Guard You can obtain the FQDN from the Server you are installing at Computer > Properties

  6. Under Executable File Name browse to the InfoSecurity Guard folder and select

    image.png

  7. Check ‘Link supports tagged processing’

  8. Enter ^!Uri^ into the Default Command line parameters field

    image.png

  9. On the Usage(Record) tab, select the appropriate Record Types then click Ok

    2023-09-11_17-04-09.png

ADD TO THE CONTENT MANAGER RIBBON​

To add the button to the Content Manager Ribbon for all users, you will need to update the Global Settings by following these steps:

  1. In Content Manager, click on the File button, then click Get Global Options

    2023-10-10_11-50-23.png

  2. Select the Ribbon option then click Ok

    2023-10-10_11-51-27.png

  3. When a confirmation prompt appears, Click OK

    2023-10-10_11-56-18.png

  4. Add the Email Record(s) button to the Ribbon for both Desktop and Context versions of Content Manager. It can be added under the FYB Add-Ins and Connectors tab, or a different tab can be used.

    image.png

  5. Open Content Manager Context, on the Administration tab, Click Global Settings

    image.png

  6. Select Ribbon and frame settings, click the OK button

  7. When a confirmation prompt appears, click the OK button

  8. Each user will need to perform a Get Globals for the InfoSecurity Guard buttons to appear in the relevant Ribbon.

REMOVING SEND TO MAIL MENU OPTION (OPTIONAL)​

Content Manager users may currently be able to right-click on a record and select Send To -> Mail. This option can be removed if required. To remove the Send To -> Mail menu option, follow these steps for each record type that the option needs to be removed from:

  1. Right click on the record type and select the Properties option

    image.png

  2. Select the Menu tab

  3. Uncheck the Menu item Mail

    image.png

  4. Click on the OK button

CREATING SECURITY CLASSIFICATIONS AND DLMS​

To enable the InfoSecurity Guard to be used effectively, Security Classifications and Dissemination Limiting Markers (DLMs) need to be created in Content Manager.
Security Classifications can be managed in Content Manager by using either security levels or additional fields.
DLMs can be managed in Content Manager by using either security caveats or additional fields. When using additional fields to manage security, it is important to understand that these additional fields add just a ‘stamp’ or marking in the metadata of the record. No system settings are updated when these additional fields are used. Alternatively, if security levels and security caveats are being used, any users who try to access the record will only be able to see the record if their profile in Content Manager has the appropriate security applied. If you are unsure how to set up additional security levels, security caveats or additional fields, please contact FYB for advice and assistance.

SETTING UP SECURITY LEVELS FOR SECURITY CLASSIFICATIONS​

There needs to be a security level for each security classification.
When creating security levels, the level with the lowest risk has a Ranking of 1.
The abbreviation for each Security Classification must include a prefix of ’SCL’, as shown in the screenshot below

image.png

SETTING UP ADDITIONAL FIELDS FOR SECURITY CLASSIFICATIONS​

To create a new additional field for Security Classifications, firstly a lookup set and lookup items will need to be created. These will then be linked to a new additional field. The steps below provide an outline of this process.

  1. Create a new lookup set called ’Security Classifications’, as shown in the screenshot below

    image.png

  2. Each security classification needs to be created as a lookup item and added to the Security Classification lookup set, e.g.

    image.png

  3. Create a new additional field with the format ’String’

    image.png

  4. Name the additional field ’Security Classification’ Set the abbreviation to ’SCL’ (or something that includes SCL) In the ‘Use a value from the lookup set’ field, select Security Classifications

image.png

  1. Add the additional field to each record type that InfoSecurity Guard will be used with.

    image.png

SETTING UP SECURITY CAVEATS FOR DISSEMINATION LIMITING MARKERS​

For each dissemination limiting marker, a new Security Caveat will need to be created in Content Manager. The abbreviation for each dissemination limiting marker must include DLM, as shown in the screenshot below.

image.png

SETTING UP ADDITIONAL FIELDS FOR DISSEMINATION LIMITING MARKERS​

For each dissemination limiting marker, a new additional field will need to be created. The steps below provide an outline of this process.

  1. Create a new additional field with the format “Boolean”

    2020-08-10_13-51-53

  2. Enter the Name and Abbreviation. The abbreviation must include “DLM”, as shown in the screenshot below

    image.png

  3. Add the additional field to each record type that InfoSecurity Guard will be used with

    image.png

CONFIGURING SETTINGS​

The InfoSecurity Guard Configuration tool is used to configure and customize InfoSecurity Guard settings. To open the configuration tool, run the InfoSecurityGuard and click the setting icon on the first screen

image.png

The table below provides an explanation of the different fields in the Configuration Dashboard

NAME OF FIELDFUNCTIONALITY
Dataset IDThe ID of the Content Manager dataset to be used with InfoSecurity Guard.
Workgroup Server NameThe Workgroup Server Name used to connect to the dataset. The workgroup server name or URL can be utilized
Workgroup Server URLThe Workgroup Server URL used to connect to the dataset. The workgroup server name or URL can be utilized
LicenseClick the Browse button to select the license file for InfoSecurity Guard. The license file should be in the FYB Addins shared folder and the path specified should be the fully qualified shared path.
Internal DomainUse this option to indicate the domain of the organisation. Prior to sending an email, this domain will be checked to determine if the email is being sent internally or externally.
Security Confirmation Required for Internal EmailsTicking this checkbox means that users will need to confirm the security settings for each record they email internally. If this checkbox is unticked, users will be able to email records internally without confirming the security settings.
Create Single Reference File for Email AttachmentsWhen checked, only a single reference file for electronic documents will be generated for internal emails. If unchecked, a reference file will be created for each electronic record.
Use Document Content IndexingWhen checked, Document Content Indexing will be enabled. When Document Content Indexing is enabled, Security Markings will be displayed for each record that is sent.
X Second DelayThere is a delay between a document being updated, and its contents being indexed and searchable via Content Manager. To allow for this, InfoSecurity Guard will evaluate security markings by searching documents directly until the delay period has elapsed.
Dissemination Limiting Markers
- Use Security Caveats
- Use Additional Fields
Use this option to indicate how Dissemination Limiting Markers are to be set in Content Manager.
Security ClassificationUse this option to indicate how Security Classifications are to be set in Content Manager.
Security Classification RankingThis section is only enabled if the option Use Additional Field is selected for Security Classifications. It shows the ranking of the Security Classifications. Each security classification should be listed here, with the lowest ranking classification numbered 1. These rankings are added by the Configuration tool, it is not necessary to add them to the name of the security classification.
Please note: This list of security classifications must match the security classification lookup set in Content Manager. For a new security classification, it should be added to this list, and to the security classification lookup set in Content Manager.
image.pngClicking this button opens a dialogue to enter the name of a new security classification to be added to the list.
image.pngClicking this button removes the selected security classification from the list.
image.pngClicking this button opens a dialogue to rename the selected security classification.
image.pngClicking this button moves the selected security classification further up the list. As the security classification is moved up and down the list, the ranking assigned to the security classification changes.
image.pngClicking this button moves the selected security classification down the list. As the security classification is moved up and down the list, the ranking assigned to the security classification changes.
Document Marker Action
- Prevent
- Warn
- Do Nothing
Use this option to indicate what should happen when security markers are set on a record, but not present in the document.
Prevent: Users cannot confirm or send documents that do not contain all of the security markers that are on the record.
Warn: Users receive a warning message when they email a document that does not contain all of the security markers that are on the record.
Do Nothing: Users are not notified if a document does not contain all of the security markers that are on the record.
Notes TextThis text will be added to the notes of each Record that has its security settings confirmed through InfoSecurity Guard. The text “(USER)” will be replaced with the username of the user. The text “(INTERNAL OR EXTERNAL)” will be replaced with “internal” or “external”, depending on the recipients of the email being sent.
Document Marker Warning TextThis text will be displayed if the Document Marker Action is set to warn.
Document Marker Prevent TextThis text will be displayed if the Document Marker Action is set to prevent.
Disclaimer HeadingThis text will be displayed as the heading of the disclaimer message.
Disclaimer BodyThis text will be displayed as the body of the disclaimer message.
Unauthorised Message TextThis text will be displayed when a user tries to update the security settings for a record for which they do not have the update metadata permission.
No Classification Message TextThis text will be displayed when a user tries to confirm the security settings for a record that does not have a security classification set.
Confirm Button Tool-TipThe tooltip text that will appear when hovering the mouse over the Confirm button.
Update Button Tool-TipThe tooltip text that will appear when hovering the mouse over the update button.
Email Button Tool-TipThe tooltip text that will appear when hovering the mouse over the email button.
image.pngClick this button to save any changes and close the InfoSecurity Guard Configuration tool.
image.pngClick this button to discard any changes and close the InfoSecurity Guard Configuration tool.

INSTALLING THE INFOSECURITY GUARD EVENT ADD-IN​

If the organisation has decided to use additional fields for managing Security Classifications and/or DLMs, then the Event add-in will need to be deployed. The event add-in will update the security values on contained records so that it matches the parent container’s security classification and DLMs when:

  • A new record is created within the container.
  • The parent container's classification or DLM has been updated

It’s recommended you install this add-in on an appropriate event processing server.

INSTALLATION​

To install the event add-in please follow the steps below:

  1. Copy the InfoSecurityGuardEventAddIn-XXX.zip file over to the server you wish to install it on NOTE: Please contact FYB if you do not have a copy of InfoSecurityGuardEventAddIn-XXX.zip

  2. Extract the zip file, copy the contents, and paste them into Content Manager installation directory. This is usually located at C:\Program Files\Micro Focus\Content Manager\

    Note

    For the Event Processing to function, the InfoSecurityGuardEventAddIn.dll needs to be copied to the installation directory. This is a Content Manager requirement, not an FYB InfoSecurity Guard requirement.

  3. Locate and open the InfoSecurityGuardEventAddin.xml file and apply the required settings

    image.png

    FUNCTIONALITYDESCRIPTION
    DLMsSet to true if DLMs is set to use additional fields
    SecurityClassificationSet to true if Security Classification is set to use an additional field
    LogFolderThe path where you would like the log file to be written to
    LicenseThe path of the InfoSecurity Guard license file
  4. Open Enterprise Studio and drop down the Datasets list

    image.png

  5. Right click on the Dataset that Information Security Guard will connect to, and click on Event Processing, then Configure

    image.png

  6. Click on the Custom Processes tab and proceed with clicking on the Add button

    image.png

  7. Enter the following details and click on the OK button

    image.png

    Note

    The Class Name/Add-in Name field above is case-sensitive

  8. Highlight the InfoSecurityGuardEventAddin. Set the Configuration Status to Enabled and the Run on Workgroup Server to the Event Processing Server

    image.png

  9. Click on the OK button to save the changes

  10. Complete a Save and Deploy through Content Manager Enterprise

    Warning

    A Save and Deploy will result in a short outage of Content Manager