It seems like your browser didn't download the required fonts. Please revise your security settings and try again.
Barracuda CloudGen Firewall

Migration of URL Filter Categories from WCS Version 2.0 to Version 3.2

  • Last updated on

URL filter objects have been used up to CloudGen firewall's firmware version 8.3 based on a database with version WCS 2.0. As of this new firmware version 9.0, a new set of URL filter categories is now used under version WCS 3.2.

Due to the change of the underlying WCS system (database of URL filters) in the CloudGen Firewall, some categories have been completely removed, while other categories now refer to new namings, have different IDs for the same category name, or share the same ID for a different category.

While these URL filter matching objects are applied in firmware version <=8.3 in Application Rules, the URL filter objects are used in firmware 9.0 as part of the new policy profiles.

This change affects some aspects of understanding how to handle these new URL filter categories when migrating them from firmware release <=8.3 to firmware >=9.0.

Migrating URL categories from firmware <=8.3 to 9.0 can not be reversed!

Migrating URL Filter Categories for a Standalone Firewall and HA Pairs from Firmware <=8.3 to firmware 9.0

When migrating a standalone firewall from firmware <=8.3 to 9.0, all URL category objects will be updated from WCS 2.0 to WCS 3.2.

After migrating a standalone firewall from firmware <=8.3 to firmware 9.0, it is recommended to check the category objects if their categorization refers correctly to your individual requirements. If a certain category does not relate correctly, you must reconfigure its usage in its special context.

As an example, the URL filter object list on the box level (and Cluster level in a Control Center) will display the following table:

url_filter_object_list.png

 

When migrating an HA pair of firewalls, you must first migrate the secondary firewall.

Migrating URL Filter Categories in a CGF Control Center

Because a CC-managed firewall has the same relation to its parenting cluster as a standalone firewall to the root node in Firewall Admin, all URL filter objects in the cluster will be updated from WCS 2.0 to WCS 3.2.

Therefore, you must perform the following steps:

  1. Update all firewalls in a cluster.
  2. Migrate the cluster.

When updating the Control Center to version 9.0, you must consider that the handling of URL filter objects will be different, because some categories changed completely and policy objects can also be managed on a global or range level and can be referenced in all clusters:

  • The firewall feature level of global and range sets will be updated accordingly, but there will be no WCS migration for the URL filter objects.
  • After the update to version 9.0, all firewalls still reference the former version of WCS 2.0.

As an example, the URL filter object list on the Global/Range level in a Control Center will display the following table:

url_filter_object_list_on_global_range_level.png

Note that not all policies use URL categories (e.g., Applications, IPS, File Content,...), and in consequence, WCS issues do not affect those policies. The other policies derive their WCS version from the contained URL filter objects, which may also be "not available" ("N.A.") if no URL filter match is used in a specific policy. The following table shows the meaning of the different entries in the user interface table "URL Filtering Shared Policy Profiles":

url_filter_url_filtering_shared_policy_profiles.png

See the meaning of the entries in the column "URL Filter Version" of the following table:

URL Filter VersionMeaning
“N.A.”No Url Filter Object is used in this policy
“up to 8.3”No WCS3.2 Object and at least one WCS2.0 Object are used
“9.0 and above”At least one WCS3.2 Object is used

Referencing and Creating Explicit Url Filter Objects...

...on global or range sets

When you edit policies, the column for URL Filter Version can contain the following values:

URL Filter Version Result
“N.A.”…referencing a URL filter objectIn case there is an 8.3 reference for this policy (see migration chapter for more details), only WCS2.0 Objects are offered. No 8.3 ref: Objects for both versions are offered.
“N.A.”…creating an explicit URL filter objectIn case there is an 8.3 reference for this policy (see migration chapter for more details), Explicit Object is set to WCS2.0. No 8.3 ref: User gets asked which Version he wants.
“up to 3.2”…referencing a URL filter objectOnly WCS2.0 Objects are offered.
“up to 3.2”…creating an explicit URL filter objectObjects of both versions are offered, WCS2.0 Objects are marked as “8.3 – will be migrated for usage”.
“9.0 and above”…referencing a URL filter objectObjects of both versions are offered, WCS2.0 Objects are marked as “8.3 – will be migrated for usage”.
“9.0 and above”…creating an explicit URL filter objectExplicit Object is set to WCS3.2.

 

When you create new URL Filter objects, you can select in the following window which WCS version you want to relate the object to:

url_filter_decide_for_8_or_9_firmware.png

Manual Migration of global/range URL Filter Objects and Policies

URL Filter objects can be migrated up to version 8.3. When you trigger the migration, the version number of the references in all shared policies will be checked. If just a single reference refers to a former URL filter version 2.0, the policy will not be migrated.

URL Filter objects can be migrated up to version 8.3. When you trigger the migration, all references will be checked according to the following constraints:

  • If direct references in rulesets or cluster sets are present and if their current version is <9.0., the migration is not done.
  • If references are used in policies of the same object set, the references of these policies are checked. If the references are used in rulesets <9.0, the migration is not done.
  • Only for global objects: if references are used in range policies, the references of the range policy are checked.

For migrating an object, perform the following steps:

  1. Log into your Control Center.
  2. Depending on where you want to migrate your URL Filter objects and policies:
    1. On a global level – Go to CONFIGURATION > Configuration Tree > Multi-Range > Global Settings > Firewall Objects/Policies.
    2. On a range level – Go to CONFIGURATION > Configuration Tree > Multi-Range > Global Settings > your range > Range Settings > Firewall Objects/Policies.
  3. Select and right-click the related row with a column text "up to 8.3" in the table.
  4. From the list, select Migrate to URL Filer Version 9.0 and above.
    url_filter_migrate_objects_up_to_8.3.png
  5. If all required conditions are met, the migration process will start.
    1. If the migration is not possible for some reason or fails, you will be presented with a dialog window informing you about some details.