URLs

URLs in the system are defined according to RFC 3986.

  • Only the hostname field (part of the authority) is required.
  • Other parts are optional, but can be used to define a stricter match.
  • CGI parameters (anything after the “?” in a URL) are automatically removed from the URL before it is saved in the Management API local database.
  • If no protocol is specified, the Management API automatically adds all 3 of the following to its database: http://, https://, and ftp://.

Use Punycode to add URLs containing non-ASCII characters to API-managed categories.

URLs can be added to more than one API-managed category with multiple calls to the add methods (see Add URLs and IP addresses to an API-managed category). When the URL is matched, all categories for the URL are returned for use in policy enforcement.