Migrating URL Lists to Destination Profiles

La fonctionnalité Profil de destination remplace la fonctionnalité Listes d'URL . Cet article explique comment migrer vos listes d'URL vers des profils de destination.

URL Lists Versus Destination Profiles

Destination profiles use and support different objects and syntax than URL lists. Before you begin migrating your URL lists, review the differences between these two features.

Deux types de listes d'URL sont disponibles : améliorées et héritées. Les listes d'URL améliorées prennent en charge les expressions régulières (regex), contrairement aux listes d'URL classiques. Pour confirmer le type de listes d'URL activées sur votre locataire, accédez à la page URL Lists et cliquez sur New URL List.

Enhanced URL Lists

If you have enhanced URL lists, consider the following differences between your URL lists and destination profiles:

• Supported Objects
  Destination profiles support port, path, and query for all destination types, including CIDR and ranges. These are not supported in enhanced URL lists.
• Schemes
  L’URL améliorée liste des schémas de support comme http://*.domain.com, que le proxy évalue comme port 80. Cependant, les profils de destination interdisent les schémas. Pour effectuer ce même comportement avec un profil de destination, il faut spécifier un port (par exemple, *.domain.com:80).
• CIDR and Ranges
  Les listes d’URL améliorées définissent les CIDR et les plages telles qu’elles sont écrites (par exemple, 163.116.128.0/17 et 163.116.128.80-81). Pour les profils de destination, vous devez inclure des préfixes à votre CIDR et vos plages. Par exemple : CIDR:163.116.128.0/17 et RANGE:163.116.128.80-81.
• Case Sensitivity
  Pour des listes d'URL améliorées, vous pouvez définir la sensibilité à la casse pour les chemins et les requêtes globalement avec l' optionURL Case Insensitivity Match . Avec les profils de destination, vous pouvez définir la sensibilité à la casse pour chaque profil.
• Longest Prefix Match
  Les profils de destination ne prennent pas en charge la correspondance de préfixe la plus longue. Si votre locataire a été créé avant octobre 2021, alors vos listes d’URL améliorées utilisent par défaut la plus longue correspondance au préfixe. Avec la plus longue correspondance de préfixe, dans un scénario où vous avez *.example.com et www.example.com dans différentes listes d’URL, le proxy ne correspond à la liste que la définition plus longue pour les requêtes à www.example.com. Vous pouvez désactiver ce comportement avec l’option Custom URL Lookup Longest Match Mode .

Legacy URL Lists

If you have legacy URL lists, consider the following differences between your URL lists and destination profiles:

• Supported Objects
  For destination profiles, matching based on resolved IPs is supported for IPs, CIDR, and ranges. Ports and regex are also supported. These are not supported in legacy URL lists. 
• PQDN
  Les listes d’URL héritées ne correspondent qu’aux sous-domaines. Par exemple, *.example.com ne correspond qu’à des sous-domaines comme www.example.com et non au domaine supérieur example.com. Les profils de destination correspondent à la fois au sous-domaine et au domaine supérieur.
• Longest Prefix Match
  Les profils de destination ne prennent pas en charge la correspondance de préfixe la plus longue. Les listes d'URL héritées utilisent par défaut la correspondance de préfixe la plus longue. Avec la correspondance de préfixe la plus longue, dans un scénario où vous avez www.example.com et www.example.com/somepath dans des listes d'URL différentes, le proxy ne correspond qu'à la liste avec la définition la plus longue lorsqu'une requête cible www.example.com/somepath. La liste www.example.com ne correspond pas. Vous pouvez désactiver ce comportement avec l'option Custom URL Lookup Longest Match Mode .

About the Migration

You can complete the migration for URL lists to destination profiles via the UI or APIs, one URL list at a time or in bulk. 

There are two stages to the migration. The first stage is duplicating your URL lists as destination profiles. The second is migrating the newly created destination profiles to your custom categories (i.e., replacing the URL lists with the destination profiles). Migration is complete once all URL lists are duplicated as destination profiles and all of your custom categories reference the new destination profiles instead of the URL lists.

A message at the top of the URL Lists page provides details on the scope of the migration. Click the number in the In Custom Category to view a list of all related categories for the URL list.

Stage 1: Duplicating URL Lists as Destination Profiles

To begin the migration process, you must first duplicate your URL lists as destination profiles. This causes no impact on your environment until the next stage of the migration.

La migration assistée est disponible depuis la page URL Lists ou via les API REST suivantes : POST /api/v2/profiles/destinations/migrate et PATCH /api/v2/profiles/destiantions/{id}/migrate. 

When duplicating your URL lists as destination profiles, note the following:

• You can only duplicate applied URL lists. 
• When duplicating URL lists, the syntax automatically updates to maintain the configured behavior.
• The source URL list is not deleted once it is duplicated.
• During this stage, you can review all duplication changes as well as apply or revert changes. Note that changes are not automatically applied and you must manually apply all changes. 
• You can duplicate a URL list multiple times. When a URL list is duplicated again, you can either update the existing destination profile or create a new one. 
• The latest duplication (i.e., the most recently created destination profile) is recorded and shown in the Netskope UI.
• If you modify a URL list after duplicating it, then the Netskope UI will display a warning.

Stage 1 Workflow Examples

The following examples include duplicating a single URL list, duplicating multiple URL lists, reduplicating a URL list and updating the destination profile, and reduplicating a URL list and creating a new destination profile.

Example: Duplicating a Single URL List

The following is an example workflow for duplicating a single URL list from the URL Lists page for the first time.

1. From the URL Lists page, click Duplicate to Destination Profile for a URL list. 

The Dest Profile Migration column updates for the URL list.

2. Go to the Destination Profiles page and review the content of the new destination profile, i.e., the converted syntax from the original URL list. 

3. Cliquez sur Apply Changes.

Example: Duplicating Multiple URL Lists

The following is an example workflow for duplicating multiple URL lists in bulk from the URL Lists page for the first time.  

1. Depuis la page URL Lists , sélectionnez les listes d’URLs puis cliquez Duplicate to Destination Profile. 

2. Le message Bulk Duplicate to Destination Profiles apparaît. Cliquez Duplicate.

The Duplicating URL Lists to Destination Profiles window appears and displays the progress of the duplication.

3. When the process is complete, go to the Destination Profiles page and review the pending destination profiles.

4. Cliquez sur Apply Changes.

Example: Reduplicating a URL List and Updating the Destination Profile

The following is an example workflow for duplicating a URL list that was already duplicated and then updating the existing destination profile. In this example, the URL list was updated after the first duplication.

1. Pour la liste des URL, cliquez sur Duplicate Again puis sur To Override the Duplicated Destination Profile. 

2. Go to the Destination Profiles page and review the pending changes to the destination profile before applying them.

Example: Reduplicating a URL List and Creating a New Destination Profile

The following is an example workflow for duplicating a URL list that was already duplicated and then creating a new destination profile. In this example, the URL list was updated after the first duplication. 

1. Pour la liste des URL, cliquez sur Duplicate Again puis sur To a New Destination Profile. 

The name of the new destination profile appears in the Dest Profile Migration column.

2. Go to the Destination Profiles page to view and apply the new destination profile. The old destination profile will remain unchanged. 

Stage 2: Migrating Destination Profiles to Custom Categories

To complete the migration process, you must update your custom categories with the newly created destination profiles, replacing the URL lists. 

La migration assistée est disponible à partir de la page URL Lists ou via l'API REST suivante : PATCH /api/v2/profiles/customcategories/{id}. 

When migrating your destination profiles to custom categories, note the following:

• You must apply all destination profile changes before migrating to custom categories.
• You can only update applied custom categories.
• During this stage, you can review all migration changes as well as apply or revert changes. Note that changes are not automatically applied and you must manually apply all changes.
• Rolling back changes is possible even after applying changes. To roll back a change, manually edit the custom category and replace the destination profile with the original URL list.
• Netskope recommends that you avoid editing a URL list that’s no longer referenced in a custom category to prevent confusion. Instead, once all custom categories referencing a URL list are migrated, make future changes in the new destination profile. 

Stage 2 Workflow Examples

The following examples include migrating a single destination profile and migrating multiple destination profiles.

Example: Migrating a Single Destination Profile

The following is an example workflow for migrating a single destination profile (i.e., a duplicated URL list) to custom categories from the URL Lists page.

1. From the URL Lists page, click the number button in the In Custom Category column for the duplicated URL list. 

2. La fenêtre Migrate Categories apparaît. Select les catégories personnalisées à mettre à jour et cliquez sur Migrate. 

3. Go to the Custom Categories page to review the pending changes to the custom categories.

4. Cliquez sur Apply Changes. 

Once the migration for the URL list is complete (i.e., all custom categories now use the new destination profile), the In Custom Category column on the URL Lists page updates to zero.

Example: Migrating Multiple Destination Profiles

The following is an example workflow for migrating multiple destination profiles (i.e., multiple duplicated URL lists) in bulk to custom categories from the URL Lists page.

1. Depuis la page URL Lists , sélectionnez les listes d’URLs puis cliquez Migrate Categories. 

2. La fenêtre Bulk Migration In Category apparaît. Toutes les catégories personnalisées qui font référence aux listes d’URL sélectionnées sont automatiquement sélectionnées. Cliquez Migrate. 

The Migrating Categories Referencing From URL Lists To Destination Profiles window appears and displays the progress of the migration. 

3. When the process is complete, go to the Custom Categories page and review the pending changes to the custom categories.

4. Cliquez sur Apply Changes. 

Completing the Migration

Once all URL lists have been duplicated and the custom categories no longer reference them, the URL Lists page will no longer display the migration message.