Web Add-in: Forbidden Lists and Recipients

Written By Marissa Fegan (Super Administrator)

Updated at November 4th, 2021

The Forbidden Lists and Forbidden Recipients features in SafeSend allow administrators to limit which distribution lists or specific recipients their users are permitted to send emails to.


Forbidden Lists

The ForbiddenLists setting prevents users from being able to send email to any Outlook or Exchange distribution list.

  1. Navigate to the settings.json file within the SafeSend Web Add-in site folder and open it by right-clicking on the file to open it with Notepad or any other desired text/code editor
  2. Under the Advanced section header, look for the //ForbiddenLists setting; this is disabled by default
  3. To enable this feature:
    1. Uncomment "ForbiddenLists": true, by removing // at the front of the line
  4. Save and close the window when done or continue to Forbidden Recipients below


Forbidden Recipients

The ForbiddenRecipients setting prevents users from being able to send email to an included email address.

  1. Navigate to the settings.json file within the SafeSend Web Add-in site folder and open it by right-clicking on the file to open it with Notepad or any other desired text/code editor
  2. Under the Advanced section header, look for the //ForbiddenRecipients setting; this is disabled by default
  3. To enable this feature:
    1. Uncomment // "ForbiddenRecipients": [ "user1@email.example", "user2@email.example" ], by removing // at the front of the line
    2. Replace the example emails with the desired, individual email addresses you wish to blacklist
      • Each email address should be separated with a comma, as seen in the example image below
  4. Save and close the window when done


Additional Steps

If you'd like to customize the popup message a user sees when they've attempted to email an address on the Forbidden lists:

  1. Navigate to the Localization.xlsx file within the SafeSend Web Add-in site folder and open it in Microsoft Excel or another spreadsheet application that supports .xlsx file extensions
  2. if the Protected View warning shows at the top, click Enable Editing
  3. Look for the following strings and edit as necessary:
    • SS_StringForbiddenRecipient: This string determines the text on the popup window for an individual email address listed in the ForbiddenRecipient setting, a singular Outlook group, or a singular Exchange list
    • SS_StringForbiddenRecipients: This string determines the text on the popup window for multiple email addresses listed in the ForbiddenRecipient setting, multiple Outlook groups, and/or multiple Exchange lists
    • SS_StringForbiddenRecipientTitle: This string determines the title of the popup window for both of the above strings
  4. Save and close the spreadsheet when done

Delete

Important Note

Any changes made to Settings.json require the website to be restarted to take effect. This should be done outside of normal operating hours to avoid potential service interruptions.