KB Article | Forcepoint Support

Problem Description

Several types of messages are displayed on the Forcepoint DLP Endpoint machine. Examples include:
  • Status details
  • Alert messages
  • Block messages
  • Confirmation messages
  • Bypass code requests

Bypass message

These messages are configured in XML templates stored on the management server and deployed in endpoint profiles. By editing the templates, you can customize the messages and languages that end users see in their Forcepoint DLP Endpoint client software.

Resolution

To customize an endpoint message, create a custom message file and then configure each endpoint profile to use the custom message file:
 
  1. Go to %dss_home%\custom\endpoint\msgFiles folder.
  2. Make a copy of the preferred language XML file, such as English.xml, and save it using a custom filename. Make sure the file is writable.
    NOTE: If you already have a custom XML file, copy it into %dss_home%\custom\endpoint\msgFiles folder. 
  3. Edit the new XML file.
    • Messages are stored in the form:
      <Message ID="nnnnnnnn">
         <Content>Message Content</Content>
         <Description>Message Description</Description>
      </Message>
    • Every type of message has a different ID.
    • Only change the text within the <Content></Content> tags. Do not change, add, or delete any existing XML format, including the Message ID.
    • Do not edit the text within the <Content></Content> tags if it is enclosed within square brackets. For example, [DLPUNDEFINED].
    • Message content should be limited to 511 characters or the system will use the default message.
    • The text should be UTF-8 encoded.
    NOTE: If the edited file has incorrect syntax (e.g., a tag is not closed correctly), Forcepoint One Endpoint rejects the XML file when it is deployed to the endpoint machine. If the new file is rejected, Forcepoint One Endpoint will continue to use the old XML file.
  4. To configure the endpoint bypass message, find message 10010100, then modify the message content between the <Content></Content> tags as desired.
  5. To add new confirmation dialog messages (Forcepoint One Endpoint/Forcepoint DLP Endpoint v19.06):
    NOTE: Forcepoint DLP Endpoint v19.06 contains new message files for the confirmation dialog window. All customers upgrading to Forcepoint One Endpoint v19.06 and enabling the new confirmation dialog window must deploy the new message files through the Forcepoint DLP Manager. The new message files are also compatible with lower versions of Forcepoint One Endpoint (v19.04 or lower) and the conventional Forcepoint DLP Endpoint (v8.5 or lower). Customers with custom message files must include the new confirmation dialog messages in their custom files. Otherwise, the confirmation dialog does not display correctly:
    User-added image
    1. Open the default XML file in your preferred language.
    2. Copy your custom messages into the default file. By copying your custom messages into the default file, you ensure that the new confirmation dialog messages are included.
      For reference, the new confirmation dialog messages are:
      • 20190001
      • 20190002
      • 20190003
      • 20190004
      • 20190005
      • 20190006
      • 20190007
      • 20190008
      • 20190009
      • 20190010
      • 20190011
  6. The five messages that an end user can select on the confirmation dialog window can be customized to match your organization's requirements.
    NOTES: There is a maximum of 5 messages. You cannot add an extra message to the file. Each selectable message is limited to 70 characters. If you go over 70 characters, the message will be truncated with ellipses (...).
    • To customize the selectable messages shown to end users, update the text within the <Content></Content> tags in the following messages: 20190004, 20190005, 20190006, 20190007, and 20190008. For example, if you want to edit message 20190004, you would edit the bold text in the following message:
      <Message ID="20190004">
         <Content>Acceptable operation (false positive)</Content>
         <Description>ILP controls\UI\Confirmation Dialog\Reason Radio button 1</Description>
      </Message>
    • To hide a message (for example, if you want to only display 4 messages), change the text within the <Content></Content> tags to [DLPUNDEFINED]. For example, if you want to hide/disable the last message and its radio button, edit the last message (20190008) to the following:
      <Message ID="20190008">
         <Content>[DLPUNDEFINED]</Content>
         <Description>ILP controls\UI\Confirmation Dialog\Reason Radio button 5</Description>
      </Message>
      [DLPUNDEFINED] should always be in English even if the message file is for a different language.
  7. To show or hide a link to your organization's policy:
    • To hide/disable the corporate policy hyperlink (located at the bottom of the confirmation dialog window), change the text within the <Content></Content> tags to [DLPUNDEFINED] in message 20190011:
      <Message ID="20190011">
         <Content>[DLPUNDEFINED]</Content>
         <Description>ILP controls\UI\Confirmation Dialog\Company policy URL\[DLPUNDEFINED] to disable this feature</Description>
      </Message>
      [DLPUNDEFINED] should always be in English even if the message file is for a different language.
    • To show/enable the corporate policy hyperlink, change the text within the <Content></Content> tags to a valid URL (in XML format) in message 20190011:
      <Message ID="20190011">
         <Content>https://www.forcepoint.com</Content>
         <Description>ILP controls\UI\Confirmation Dialog\Company policy URL\[DLPUNDEFINED] to disable this feature</Description>
      </Message>
  8. To change the company name shown in the confirmation dialog title bar, change the text within the <Content></Content> tags in message 10010120:
    <Message ID="10010120">
       <Content>Forcepoint One Endpoint</Content>
       <Description>ILP controls\UI\Confirmation Dialog\Caption</Description>
    </Message>
  9. Save the file.
To install the new XML file:
  1. Log on to the Data Security manager.
  2. On the Settings tab, under Deployment, click Endpoint and select an endpoint profile.
  3. Click the Properties tab.
  4. Under Endpoint Message Template, select the new XML file.
    User-added image
  5. Click Save & Close.
  6. Deploy the changes.
  7. On the endpoint machine, click Update. Alternatively you can let the update run automatically based on a configured interval.

Article Feedback



Thank you for the feedback and comments.