Migrer vers SAML depuis LDAP via l'API REST

Le référentiel GitHub d'ExtraHop contient un exemple de script qui récupère une liste des personnalisations des utilisateurs distants et des métadonnées de partage associées et enregistre les informations dans des fichiers JSON. Exécutez le script une fois pour chaque type de personnalisation après avoir remplacé les variables par des informations provenant de votre environnement.

1. Accédez au Référentiel GitHub d'exemples de code ExtraHop et téléchargez le migrate_saml répertoire vers votre machine locale.
2. Définissez les variables d'environnement suivantes :

   EXTRAHOP_HOST

   L'adresse IP ou le nom d'hôte de l'appliance.

   EXTRAHOP_API_KEY

   La clé API généré à partir de l'appliance.

   Par exemple, la commande Linux suivante définit le EXTRAHOP_HOST variable à https://extrahop.example.com:

   export EXTRAHOP_HOST=https://extrahop.example.com

   Copier
3. Procédez comme suit pour les tableaux de bord et les cartes d'activité.
   1. Dans un éditeur de texte, ouvrez retrieve_sharing.py fichier et configurez les variables suivantes pour spécifier le type de personnalisation. Par exemple, pour récupérer les métadonnées d'un tableau de bord, spécifiez OBJECT_TYPE=dashboards et OBJECT_FILE=dashboards.json

      TYPE_OBJET

      Type de métadonnées de personnalisation à récupérer. Les valeurs suivantes sont valides :

      • dashboards
      • activitymaps

      FICHIER_SORTIE

      Nom du fichier JSON dans lequel enregistrer les métadonnées de personnalisation. Conservez ces fichiers sur votre ordinateur pour les saisir dans des scripts ultérieurement au cours de la migration.

      • dashboards.json
      • activity_maps.json

   2. Exécutez la commande suivante :

      python3 retrieve_sharing.py

      Copier

      Remarque :

      Si le script renvoie un message d'erreur indiquant que la vérification du certificat SSL a échoué, assurez-vous que un certificat fiable a été ajouté à votre sonde ou à votre console. Vous pouvez également ajouter le 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

Dans les étapes suivantes, vous allez apprendre à conserver les requêtes d'enregistrement enregistrées par un utilisateur distant.

1. Connectez-vous au système ExtraHop via https://<extrahop-hostname-or-IP-address> avec le setup compte utilisateur.
2. Cliquez sur l'icône Paramètres système, puis sélectionnez Bundles.
3. Sur la page Bundles, sélectionnez Nouveau.
4. Entrez un nom pour identifier le bundle.
5. Cliquez sur la flèche à côté de Requêtes dans le tableau des matières et cochez les cases à côté des requêtes enregistrées que vous souhaitez exporter.
6. Cliquez OK.. Le bundle apparaît dans le tableau de la page Bundles.
7. Sélectionnez le bundle et cliquez sur Télécharger. Les requêtes sont enregistrées dans un fichier JSON.

Le référentiel GitHub d'ExtraHop contient un exemple de script qui récupère une liste d'utilisateurs distants et leurs métadonnées associées, puis enregistre les informations dans un fichier JSON nommé user_map.json.

python3 retrieve_remote_users.py

Le référentiel GitHub d'ExtraHop contient un exemple de script qui récupère une liste de groupes d'utilisateurs et de membres locaux, puis enregistre les informations dans un fichier JSON nommé user_groups.json.

python3 retrieve_local_user_groups.py

Le référentiel GitHub ExtraHop contient un exemple de script qui crée des comptes utilisateur SAML pour chaque compte utilisateur distant supprimé sur une appliance.

python3 create_saml_accounts.py

Le référentiel GitHub ExtraHop contient un exemple de script qui rétablit l'adhésion des utilisateurs SAML à des groupes d'utilisateurs locaux.

python3 create_local_user_groups.py

Le référentiel GitHub d'ExtraHop contient un exemple de script qui supprime les comptes d'utilisateurs distants et transfère les personnalisations détenues par ces comptes d'utilisateurs vers des comptes utilisateur SAML.

python3 delete_remote_users.py

Le référentiel GitHub d'ExtraHop contient un exemple de script qui transfère les paramètres de partage de personnalisation des comptes d'utilisateurs distants supprimés vers des comptes d'utilisateurs SAML. Exécutez le script une fois pour chaque type de personnalisation après avoir remplacé les variables par des informations provenant de votre environnement. Par exemple, si vous souhaitez conserver les paramètres partagés pour les tableaux de bord et les cartes d'activité, vous exécuterez le script une fois avec les variables de personnalisation pour les tableaux de bord et une fois avec les variables de personnalisation pour les cartes d'activité.