Sauvegardez une sonde ou une console via l'API REST

Après avoir configuré un sonde ou console avec des personnalisations telles que des ensembles, des déclencheurs et des tableaux de bord ou des modifications administratives telles que l'ajout de nouveaux utilisateurs, ExtraHop vous recommande de créer régulièrement des sauvegardes du système afin de faciliter la restauration après une défaillance du système. Ce guide explique comment automatiser les sauvegardes du système via l' API REST ExtraHop à l'aide d'un script Python.

Before you begin

  • Vous devez vous connecter au sonde ou console avec un compte doté de privilèges d'administration du système et d'accès pour générer une clé d'API.
  • Vous devez disposer d'une clé d'API valide pour apporter des modifications via l'API REST et suivre les procédures ci-dessous. (Voir Génération d'une clé d'API.)
  • Familiarisez-vous avec Guide de l'API REST ExtraHop pour apprendre à naviguer dans l' explorateur d'API REST d'ExtraHop.

Récupérez et exécutez l'exemple de script Python

Le dépôt GitHub d'ExtraHop contient un exemple de script Python qui crée un fichier de sauvegarde sur un sonde ou console puis télécharge le fichier de sauvegarde sur la machine locale. Pour automatiser les sauvegardes du système, vous pouvez exécuter ce script régulièrement via une application de planification des tâches, telle que cron.

Remarque :Comme il est impossible de télécharger un fichier via l'explorateur d'API REST, vous devez créer des sauvegardes via l'API REST à l'aide d'une commande ou d'un script.
  1. Accédez au Référentiel GitHub d'exemples de code ExtraHop et téléchargez le create_backup/create_backup.py fichier sur votre machine locale.
  2. Dans un éditeur de texte, ouvrez create_backup.py archivez et remplacez les variables de configuration suivantes par des informations provenant de votre environnement :

    HÔTE: L'adresse IP ou le nom d'hôte de la sonde ou de la console.

    CLÉ_API: La clé d'API.

    NOM_SAUVEGARDE: Le nom de la sauvegarde. L'horodateur actuel est ajouté à ce nom lors de la création d'une sauvegarde. Par exemple, si BACKUP_NAME est défini sur Test, une sauvegarde créée le 4 mai pourrait être nommée Test 2020-05-04 12-51-46.643813.

  3. Exécutez la commande suivante :
    python create_backup.py
    Remarque :Si le script renvoie un message d'erreur indiquant que la vérification du certificat SSL a échoué, assurez-vous que un certificat de confiance a été ajouté à votre sonde ou à votre console. Vous pouvez également ajouter le verify=False possibilité 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 de certificat :
    requests.get(url, headers=headers, verify=False)
Last modified 2023-11-07