Fortinet black logo

Administration Guide

Configuring the global object white list

Configuring the global object white list

Go to Server Objects > Global > Global White List, the Predefined Global White List tab displays a predefined list of common Internet entities, such as:

  • the FortiWeb session cookie named cookiesession1
  • Google Analytics cookies such as __utma
  • the URL icon /favicon.ico
  • AJAX parameters such as __LASTFOCUS

that your FortiWeb appliance can ignore when it enforces your policies. FortiGuard FortiWeb Security Service updates the predefined global white list. However, you can also whitelist your own custom URLs, header field, cookies, and parameters on the Custom Global White List tab in Server Objects > Global > Global White List.

When enabled, white-listed items will skip the subsequent scans after Global Object White List (See the scan sequence of Global Object White List inSequence of scans) . This feature reduces false positives and improves performance.

To include white list items during policy enforcement, you must first disable them in the global white list.

To disable an item in the predefined global white list
  1. Go to Server Objects > Global > Global White List and select the Predefined Global White List tab.
  2. To access this part of the web UI, your administrator’s account access profile must have Read and Write permission to items in the Server Policy Configuration category. For details, see Permissions.

  3. To see the items that each section contains and to expose those items’ Enable check box, click the plus (+) and minus (-) icons.
  4. In the row of the item that you want to disable, click the switch to off in the Enable column.
  5. Click Apply.
To configure a custom global white list
  1. Go to Server Objects > Global > Global White List and select the Custom Global White List tab.
  2. To access this part of the web UI, your administrator’s account access profile must have Read and Write permission to items in the Server Policy Configuration category. For details, see Permissions.

  3. Click Create New.
  4. From Type, select the part of the HTTP request where you want to white list an object. Available configuration fields vary by the type that you choose.
  • If Type is URL:
  • Request Type Indicate whether the Request URL field will contain a literal URL (Simple String), or a regular expression designed to match multiple URLs (Regular Expression).
    Request URL

    Depending on your selection in the Request Type field, enter either:

    • The literal URL, such as /robots.txt, that the HTTP request must contain in order to match the rule. The URL must begin with a backslash ( / ).
    • A regular expression, such as ^/*.html, matching all and only the URLs to which the rule should apply. The pattern does not require a slash ( / ); however, it must at match URLs that begin with a slash, such as /index.html.

    Do not include the domain name, such as www.example.com.

    To create and test a regular expression, click the >> (test) icon. This opens the Regular Expression Validator window where you can fine-tune the expression. For details, see Regular expression syntax.

  • If Type is Parameter:

    Name Type

    Indicate whether the Name field will contain a literal parameter name (Simple String), or a regular expression designed to match all parameter names (Regular Expression).
    Name

    Enter one of the following:

    • The name of the parameter as it appears in the URL or HTTP body if Name Type is Simple String.

      For example, if the URL ends with the parameter substring ?userName=rowan, you would type userName.

    • A regular expression that matches the name attribute of the parameter if Name Type is Regular Expression.

    Note: FortiWeb does not support regular expressions that begin with an exclamation point ( ! ). For information on language and regular expression matching, see Regular expression syntax.

    Request Status

    Enable to apply this rule only to HTTP requests for specific URLs. Configure Request URL if it is enabled.

    Request Type

    Indicate whether the Request URL field will contain a literal URL (Simple String), or a regular expression designed to match multiple URLs (Regular Expression).

    Request URL

    Depending on your selection in the Request Type field, enter either:

    • The literal URL, such as /robots.txt, that the HTTP request must contain in order to match the rule. The URL must begin with a backslash ( / ).
    • A regular expression, such as ^/*.html, matching all and only the URLs to which the rule should apply. The pattern does not require a slash ( / ); however, it must match URLs that begin with a slash, such as /index.html.

    Do not include the domain name, such as www.example.com.

    To create and test a regular expression, click the >> (test) icon. This opens the Regular Expression Validator window where you can fine-tune the expression. For details, see Regular expression syntax.

    Domain Status

    Enable to apply this rule only to HTTP requests for specific domains.

    If enabled, also configure Domain.

    Domain Type

    Indicate whether the Domain field will contain a literal domain/IP address (Simple String), or a regular expression designed to match multiple domains/IP addresses (Regular Expression).

    Domain

    Depending on your selection in the Domain Type field, enter either:

    • The literal domain, such as /robots.com, that the HTTP request must contain in order to match the rule. The domain must begin with a backslash ( / ).
    • A regular expression, such as ^/*.com, matching all and only the domains to which the rule should apply. The pattern does not require a slash ( / ); however, it must match domains that begin with a slash, such as /robots.com.

    To create and test a regular expression, click the >> (test) icon. This opens the Regular Expression Validator window where you can fine-tune the expression. For details, see Regular expression syntax.

    Caution: Do not whitelist untrusted subdomains that use vulnerable cookies. It could compromise the security of that domain and its network.

  • If Type is Cookie:
  • Name Type the name of the cookie as it appears in the HTTP request, such as NID.
    Domain

    Type the partial or complete domain name or IP address as it appears in the cookie, such as:

    www.example.com

    .google.com

    10.0.2.50

    If clients sometimes access the host via IP address instead of DNS, create white list objects for both.

    Caution: Do not whitelist untrusted subdomains that use vulnerable cookies. It could compromise the security of that domain and its network.

    Path Type the path as it appears in the cookie, such as / or /blog/folder.
  • If Type is Header Field:
  • Header Name Type Indicate whether the Name field will contain a literal name (Simple String), or a regular expression designed to match multiple names (Regular Expression).
    Name

    Depending on your selection in the Header Name Type field, enter either:

    • The literal name, such as Accept-Encoding, that the HTTP request must contain in order to match the rule.
    • A regular expression, such as */*\r\n, matching the names to which the rule should apply. .

    To create and test a regular expression, click the >> (test) icon. This opens the Regular Expression Validator window where you can fine-tune the expression. For details, see Regular expression syntax.

    Value Status

    Enable to also check the value of the HTTP header. Only the HTTP headers which match both the name and the value will be whitelisted.

    Header Value Type

    Indicate whether the Name field will contain a literal name (Simple String), or a regular expression designed to match multiple names (Regular Expression).

    Value

    The value of the HTTP header.

    Depending on your selection in the Header Value Type field, enter either a literal value or a regular expression.

  • Click OK.
  • See also

    Configuring the global object white list

    Go to Server Objects > Global > Global White List, the Predefined Global White List tab displays a predefined list of common Internet entities, such as:

    • the FortiWeb session cookie named cookiesession1
    • Google Analytics cookies such as __utma
    • the URL icon /favicon.ico
    • AJAX parameters such as __LASTFOCUS

    that your FortiWeb appliance can ignore when it enforces your policies. FortiGuard FortiWeb Security Service updates the predefined global white list. However, you can also whitelist your own custom URLs, header field, cookies, and parameters on the Custom Global White List tab in Server Objects > Global > Global White List.

    When enabled, white-listed items will skip the subsequent scans after Global Object White List (See the scan sequence of Global Object White List inSequence of scans) . This feature reduces false positives and improves performance.

    To include white list items during policy enforcement, you must first disable them in the global white list.

    To disable an item in the predefined global white list
    1. Go to Server Objects > Global > Global White List and select the Predefined Global White List tab.
    2. To access this part of the web UI, your administrator’s account access profile must have Read and Write permission to items in the Server Policy Configuration category. For details, see Permissions.

    3. To see the items that each section contains and to expose those items’ Enable check box, click the plus (+) and minus (-) icons.
    4. In the row of the item that you want to disable, click the switch to off in the Enable column.
    5. Click Apply.
    To configure a custom global white list
    1. Go to Server Objects > Global > Global White List and select the Custom Global White List tab.
    2. To access this part of the web UI, your administrator’s account access profile must have Read and Write permission to items in the Server Policy Configuration category. For details, see Permissions.

    3. Click Create New.
    4. From Type, select the part of the HTTP request where you want to white list an object. Available configuration fields vary by the type that you choose.
    • If Type is URL:
    • Request Type Indicate whether the Request URL field will contain a literal URL (Simple String), or a regular expression designed to match multiple URLs (Regular Expression).
      Request URL

      Depending on your selection in the Request Type field, enter either:

      • The literal URL, such as /robots.txt, that the HTTP request must contain in order to match the rule. The URL must begin with a backslash ( / ).
      • A regular expression, such as ^/*.html, matching all and only the URLs to which the rule should apply. The pattern does not require a slash ( / ); however, it must at match URLs that begin with a slash, such as /index.html.

      Do not include the domain name, such as www.example.com.

      To create and test a regular expression, click the >> (test) icon. This opens the Regular Expression Validator window where you can fine-tune the expression. For details, see Regular expression syntax.

    • If Type is Parameter:

      Name Type

      Indicate whether the Name field will contain a literal parameter name (Simple String), or a regular expression designed to match all parameter names (Regular Expression).
      Name

      Enter one of the following:

      • The name of the parameter as it appears in the URL or HTTP body if Name Type is Simple String.

        For example, if the URL ends with the parameter substring ?userName=rowan, you would type userName.

      • A regular expression that matches the name attribute of the parameter if Name Type is Regular Expression.

      Note: FortiWeb does not support regular expressions that begin with an exclamation point ( ! ). For information on language and regular expression matching, see Regular expression syntax.

      Request Status

      Enable to apply this rule only to HTTP requests for specific URLs. Configure Request URL if it is enabled.

      Request Type

      Indicate whether the Request URL field will contain a literal URL (Simple String), or a regular expression designed to match multiple URLs (Regular Expression).

      Request URL

      Depending on your selection in the Request Type field, enter either:

      • The literal URL, such as /robots.txt, that the HTTP request must contain in order to match the rule. The URL must begin with a backslash ( / ).
      • A regular expression, such as ^/*.html, matching all and only the URLs to which the rule should apply. The pattern does not require a slash ( / ); however, it must match URLs that begin with a slash, such as /index.html.

      Do not include the domain name, such as www.example.com.

      To create and test a regular expression, click the >> (test) icon. This opens the Regular Expression Validator window where you can fine-tune the expression. For details, see Regular expression syntax.

      Domain Status

      Enable to apply this rule only to HTTP requests for specific domains.

      If enabled, also configure Domain.

      Domain Type

      Indicate whether the Domain field will contain a literal domain/IP address (Simple String), or a regular expression designed to match multiple domains/IP addresses (Regular Expression).

      Domain

      Depending on your selection in the Domain Type field, enter either:

      • The literal domain, such as /robots.com, that the HTTP request must contain in order to match the rule. The domain must begin with a backslash ( / ).
      • A regular expression, such as ^/*.com, matching all and only the domains to which the rule should apply. The pattern does not require a slash ( / ); however, it must match domains that begin with a slash, such as /robots.com.

      To create and test a regular expression, click the >> (test) icon. This opens the Regular Expression Validator window where you can fine-tune the expression. For details, see Regular expression syntax.

      Caution: Do not whitelist untrusted subdomains that use vulnerable cookies. It could compromise the security of that domain and its network.

    • If Type is Cookie:
    • Name Type the name of the cookie as it appears in the HTTP request, such as NID.
      Domain

      Type the partial or complete domain name or IP address as it appears in the cookie, such as:

      www.example.com

      .google.com

      10.0.2.50

      If clients sometimes access the host via IP address instead of DNS, create white list objects for both.

      Caution: Do not whitelist untrusted subdomains that use vulnerable cookies. It could compromise the security of that domain and its network.

      Path Type the path as it appears in the cookie, such as / or /blog/folder.
    • If Type is Header Field:
    • Header Name Type Indicate whether the Name field will contain a literal name (Simple String), or a regular expression designed to match multiple names (Regular Expression).
      Name

      Depending on your selection in the Header Name Type field, enter either:

      • The literal name, such as Accept-Encoding, that the HTTP request must contain in order to match the rule.
      • A regular expression, such as */*\r\n, matching the names to which the rule should apply. .

      To create and test a regular expression, click the >> (test) icon. This opens the Regular Expression Validator window where you can fine-tune the expression. For details, see Regular expression syntax.

      Value Status

      Enable to also check the value of the HTTP header. Only the HTTP headers which match both the name and the value will be whitelisted.

      Header Value Type

      Indicate whether the Name field will contain a literal name (Simple String), or a regular expression designed to match multiple names (Regular Expression).

      Value

      The value of the HTTP header.

      Depending on your selection in the Header Value Type field, enter either a literal value or a regular expression.

  • Click OK.
  • See also