Fortinet black logo

Administration Guide

Configuring replacement message profiles and variables

Configuring replacement message profiles and variables

Starting from v7.2.0, replacement message customization for content and DLP actions and variable customization has been moved from System > Customization > Custom Message to Profile > Replacement Message.

The replacement messages are used in the content/DLP action profiles when specifying the "Replace with message" action (see Configuring content profiles and content action profiles), and in the antivirus action profiles when you specifying the "Replace infected/suspicious body or attachment" action (see Configuring antivirus profiles, file signatures, and antivirus action profiles).

You can customize replacement messages for the subject, body, or attachment part, depending on which part triggers the content/DLP scanning. For virus-infected email, you can replace either the email body or attachments.

Modifying replacement messages

You can modify the text and HTML code within a replacement message to suit your requirements.

You can change the content of the replacement message by editing the text and HTML codes and by working with replacement message variables.

All message groups can be edited to change text, or add text and variables.

To customize replacement messages
  1. Go to Profile > Replacement Message > Replacement Message.
  2. Click New to add a message or click edit to modify an existing message.
  3. Enter a name for the message.
  4. Enter a description.
  5. Under Replacement Message, click New.
  6. Select a type.
  7. In the Replacement massage area, enter the content There is a limit of 8191 characters for each replacement message.
  8. If custom variables exist, you can add them to the text. To do so:
  • Insert Variables. A pop-up window appears.
  • Place your mouse cursor in the text message at the insertion point for the variable.
  • Click the name of the variable to add. It appears at the insertion point.
  • Click the Close (X) icon to close the window.

If no custom variables exist, the Insert Variables link does not appear. Some message types include predefined variables.

  • Click OK, or click Reset To Default to revert the replacement message to its default text.
  • Creating variables

    In addition to the predefined variables, you can create new ones to customize replacement messages and email templates. Typically, these variables represent messages that you will use frequently. You can modify the variables that you create, but you cannot edit or delete the predefined variables.

    To create a new variable
    1. To create new variables to be used in the replacement messages, go to Profile > Replacement Message > Variable.
    2. Click New.
    3. A dialog appears.

    4. Configure the following:
    • In Name, enter the variable name to use in the replacement message. Its format is: %%<variable_name>%%. For example, if you enter the word virus, this variable will appear as %%virus%% in the replacement message if you select to insert it. This is usually a simple and short form for a variable.
    • In Display Name, enter words to describe the variable. For example, use virus name for the variable virus. The display name appears in the variable list when you select Insert Variables while customizing a message or creating a variable.
    • In Content, enter the variable’s content. Click Insert Variables to include any other existing variables, if needed. For example, you may enter
      The file %%FILE%% has been detected containing virus %%VIRUS%%, and has been removed. File type is %%FILE_TYPE%%.
      where %%FILE%% is the file name, %%VIRUS%% provides the virus name, and %%FILE_TYPE%% is the file type of the infected file.

    To add a color code, use HTML tags, such as <tr bgcolor="#3366ff">. You can select a color code, such as "#3366ff" in the HTML tag, from the color palette after selecting Insert Color Code.

  • Click Create.
  • Configuring replacement message profiles and variables

    Starting from v7.2.0, replacement message customization for content and DLP actions and variable customization has been moved from System > Customization > Custom Message to Profile > Replacement Message.

    The replacement messages are used in the content/DLP action profiles when specifying the "Replace with message" action (see Configuring content profiles and content action profiles), and in the antivirus action profiles when you specifying the "Replace infected/suspicious body or attachment" action (see Configuring antivirus profiles, file signatures, and antivirus action profiles).

    You can customize replacement messages for the subject, body, or attachment part, depending on which part triggers the content/DLP scanning. For virus-infected email, you can replace either the email body or attachments.

    Modifying replacement messages

    You can modify the text and HTML code within a replacement message to suit your requirements.

    You can change the content of the replacement message by editing the text and HTML codes and by working with replacement message variables.

    All message groups can be edited to change text, or add text and variables.

    To customize replacement messages
    1. Go to Profile > Replacement Message > Replacement Message.
    2. Click New to add a message or click edit to modify an existing message.
    3. Enter a name for the message.
    4. Enter a description.
    5. Under Replacement Message, click New.
    6. Select a type.
    7. In the Replacement massage area, enter the content There is a limit of 8191 characters for each replacement message.
    8. If custom variables exist, you can add them to the text. To do so:
    • Insert Variables. A pop-up window appears.
    • Place your mouse cursor in the text message at the insertion point for the variable.
    • Click the name of the variable to add. It appears at the insertion point.
    • Click the Close (X) icon to close the window.

    If no custom variables exist, the Insert Variables link does not appear. Some message types include predefined variables.

  • Click OK, or click Reset To Default to revert the replacement message to its default text.
  • Creating variables

    In addition to the predefined variables, you can create new ones to customize replacement messages and email templates. Typically, these variables represent messages that you will use frequently. You can modify the variables that you create, but you cannot edit or delete the predefined variables.

    To create a new variable
    1. To create new variables to be used in the replacement messages, go to Profile > Replacement Message > Variable.
    2. Click New.
    3. A dialog appears.

    4. Configure the following:
    • In Name, enter the variable name to use in the replacement message. Its format is: %%<variable_name>%%. For example, if you enter the word virus, this variable will appear as %%virus%% in the replacement message if you select to insert it. This is usually a simple and short form for a variable.
    • In Display Name, enter words to describe the variable. For example, use virus name for the variable virus. The display name appears in the variable list when you select Insert Variables while customizing a message or creating a variable.
    • In Content, enter the variable’s content. Click Insert Variables to include any other existing variables, if needed. For example, you may enter
      The file %%FILE%% has been detected containing virus %%VIRUS%%, and has been removed. File type is %%FILE_TYPE%%.
      where %%FILE%% is the file name, %%VIRUS%% provides the virus name, and %%FILE_TYPE%% is the file type of the infected file.

    To add a color code, use HTML tags, such as <tr bgcolor="#3366ff">. You can select a color code, such as "#3366ff" in the HTML tag, from the color palette after selecting Insert Color Code.

  • Click Create.