Migrer les règles d'exceptions

1. Récupérez les métadonnées des règles de réglage depuis le système source.
   1. Dans un navigateur, accédez à l'explorateur d'API REST.
      L'URL est le nom d'hôte ou l'adresse IP de votre sonde ou console, suivi par /api/v1/explore/. Par exemple, si votre nom d'hôte est seattle-eda, l'URL est https://seattle-eda/api/v1/explore/.
   2. Entrez les informations d'identification de votre API REST.
      • Pour les capteurs et les machines virtuelles ECA, cliquez Entrez la clé API puis collez ou saisissez votre clé API dans Clé API champ.
      • Pour RevealX 360, cliquez sur Entrez les identifiants de l'API puis collez ou saisissez l'ID et le code secret de vos informations dìidentification API dans le IDENTIFIANT et Secret champs.
   3. Cliquez Autoriser puis cliquez sur Fermer.
   4. Cliquez Détections.
   5. Cliquez GET /detections/rules/masquage.
   6. Cliquez Essayez-le.
   7. Cliquez Envoyer la demande.
   8. Dans le champ Corps de la réponse, copiez l'objet JSON qui représente la règle de réglage que vous souhaitez copier.
2. Recréez la règle de réglage sur le système cible.
   1. Dans un navigateur, accédez à l'explorateur d'API REST.
      L'URL est le nom d'hôte ou l'adresse IP de votre sonde ou console, suivi par /api/v1/explore/. Par exemple, si votre nom d'hôte est seattle-eda, l'URL est https://seattle-eda/api/v1/explore/.
   2. Entrez les informations d'identification de votre API REST.
      • Pour les capteurs et les machines virtuelles ECA, cliquez Entrez la clé API puis collez ou saisissez votre clé API dans Clé API champ.
      • Pour RevealX 360, cliquez sur Entrez les identifiants de l'API puis collez ou saisissez l'ID et le code secret de vos informations dìidentification API dans le IDENTIFIANT et Secret champs.
   3. Cliquez Autoriser puis cliquez sur Fermer.
   4. Cliquez Détections.
   5. Cliquez POST /détections/règles/masquage.
   6. Cliquez Essayez-le.
   7. Dans la zone de texte du corps, collez l'objet JSON que vous avez copié depuis la source sonde ou console.

      L'entrée doit ressembler au texte suivant :

      {
          "id": 1,
          "enabled": false,
          "detection_type": "cifs_round_trip_time",
          "offender": {
            "object_type": "device",
            "object_id": 123
          },
          "victim": {
            "object_type": "device",
            "object_id": 321
          },
          "author": "example_user",
          "create_time": 1615588932838,
          "expiration": 1615675096000,
          "detections_hidden": 0
      }

      Copier

      Remarque :

      Si le description ou properties le champ est défini sur null null, vous devez supprimer ces champs du JSON avant d'envoyer la demande.

   8. Cliquez Envoyer la demande.
3. Facultatif : Désactivez la règle de réglage sur le système cible.

   Si la règle de réglage a été désactivée sur le système source, indiqué par le champ activé défini sur false, définissez le champ activé sur False sur le système cible.

   1. Dans un navigateur, accédez à l'explorateur d'API REST.
      L'URL est le nom d'hôte ou l'adresse IP de votre sonde ou console, suivi par /api/v1/explore/. Par exemple, si votre nom d'hôte est seattle-eda, l'URL est https://seattle-eda/api/v1/explore/.
   2. Entrez les informations d'identification de votre API REST.
      • Pour les capteurs et les machines virtuelles ECA, cliquez Entrez la clé API puis collez ou saisissez votre clé API dans Clé API champ.
      • Pour RevealX 360, cliquez sur Entrez les identifiants de l'API puis collez ou saisissez l'ID et le code secret de vos informations dìidentification API dans le IDENTIFIANT et Secret champs.
   3. Cliquez Autoriser puis cliquez sur Fermer.
   4. Cliquez Détections.
   5. Cliquez PATCH /détections/règles/masquage.
   6. Cliquez Essayez-le.
   7. Dans le corps du texte, collez le code JSON suivant :

      {
          "enabled": false
      }

      Copier
   8. Cliquez Envoyer la demande.

Le référentiel GitHub ExtraHop contient un exemple de script Python qui migre toutes les règles d'exceptions d'une machine virtuelle ECA vers RevealX 360.

1. Accédez au Référentiel GitHub d'exemples de code ExtraHop et téléchargez le migrate_detection_hiding/migrate_detection_hiding.py fichier sur votre machine locale.
2. Dans un éditeur de texte, ouvrez migrate_detection_hiding.py archivez et remplacez les variables de configuration suivantes par des informations provenant de votre environnement :

   HÔTE SOURCE: Le nom d'hôte de la machine virtuelle ECA à partir de laquelle vous migrez les règles d'exceptions

   CLÉ_SOURCE DE L'API: La clé API de la machine virtuelle ECA à partir de laquelle vous migrez les règles d'exceptions

   HÔTE_CIBLE: Le nom d'hôte de l'API RevealX 360 vers laquelle vous migrez les règles d'exceptions. Ce nom d'hôte est affiché sur la page d'accès à l'API RevealX 360 sous API Endpoint. Le nom d'hôte n'inclut pas /oauth2/token.

   IDENTIFIANT_CIBLE: L'ID des informations dcessaires d'identification de l'API REST pour RevealX 360

   CIBLE_SECRET: Le secret des informations dcessaires d'identification de l'API REST pour RevealX 360

3. Exécutez la commande suivante :

   python3 migrate_detection_hiding.py

   Copier

   Si les règles d'exceptions spécifient les appareils participants ou les groupes d'appareils par un ID, le script essaie de trouver les identifiants des participants équivalents sur RevealX 360 en recherchant les adresses IP des appareils et les noms des groupes d'appareils.

   Si le script ne trouve pas les identifiants des participants équivalents sur RevealX 360, il vous invite à migrer les autres règles pour lesquelles des participants équivalents ont été trouvés. Pour continuer, tapez y et appuyez sur ENTER.

   Remarque :

   Si le script renvoie un message d'erreur indiquant que la vérification du certificat TLS a échoué, assurez-vous que un certificat fiable a été ajouté à votre sonde ou à votre console. Vous pouvez également ajouter verify=False option permettant de contourner la vérification des certificats. Cependant, cette méthode n'est pas sûre et n'est pas recommandée. Le code suivant envoie une requête HTTP GET sans vérification du certificat : requests.get(url, headers=headers, verify=False) Copier

Le référentiel GitHub ExtraHop contient un exemple de script Python qui migre toutes les règles d'exceptions d'une machine virtuelle ECA vers une autre machine virtuelle ECA.

1. Accédez au Référentiel GitHub d'exemples de code ExtraHop et téléchargez le migrate_detection_hiding/migrate_detection_hiding_enterprise.py fichier sur votre machine locale.
2. Dans un éditeur de texte, ouvrez migrate_detection_hiding_enterprise.py archivez et remplacez les variables de configuration suivantes par des informations provenant de votre environnement :

   HÔTE SOURCE: Le nom d'hôte de la machine virtuelle ECA à partir de laquelle vous migrez les règles d'exceptions

   CLÉ_SOURCE DE L'API: La clé API de la machine virtuelle ECA à partir de laquelle vous migrez les règles d'exceptions

   HÔTE_CIBLE: Le nom d'hôte de la machine virtuelle ECA vers laquelle vous migrez les règles d'exceptions

   CLÉ_API_CIBLE: La clé d'API de la machine virtuelle ECA vers laquelle vous migrez les règles d'exceptions

3. Exécutez la commande suivante :

   python3 migrate_detection_hiding_enterprise.py

   Copier

   Si les règles d'exceptions spécifient les appareils participants ou les groupes d'appareils par un ID, le script essaie de trouver les ID des participants équivalents sur la machine virtuelle ECA cible en recherchant les adresses IP des équipements et les noms des groupes d'appareils.

   Si le script ne trouve pas les ID des participants équivalents sur la machine virtuelle ECA cible, il vous invite à migrer les autres règles pour lesquelles des participants équivalents ont été trouvés. Pour continuer, tapez y et appuyez sur ENTER.

   Remarque :

   Si le script renvoie un message d'erreur indiquant que la vérification du certificat TLS a échoué, assurez-vous que un certificat fiable a été ajouté à votre sonde ou à votre console. Vous pouvez également ajouter verify=False option permettant de contourner la vérification des certificats. Cependant, cette méthode n'est pas sûre et n'est pas recommandée. Le code suivant envoie une requête HTTP GET sans vérification du certificat : requests.get(url, headers=headers, verify=False) Copier