Lancer la Démo

Restaurer le microprogramme via l'API REST

L'API REST ExtraHop vous permet de restaurer le microprogramme d'un sonde ou ECA VM vers une version précédente. Dans cette rubrique, nous présentons les méthodes permettant d'annuler le microprogramme sur un seul système via l'explorateur d'API REST ExtraHop et de restauration du microprogramme sur plusieurs systèmes à l' aide d'un script Python.

Si vous avez mis à niveau à la fois une machine virtuelle ECA et que vous vous êtes connecté capteurs, vous devez annuler le capteurs avant de restaurer la machine virtuelle ECA.

Avertissement :L'annulation du microprogramme d'une sonde réinitialise la banque de données et supprime toutes les métriques. Les capteurs connectés ne sont pas affectés.
Important :Le rollback n'est pas pris en charge pour les magasins de disques ou de packages ExtraHop. Si vous devez annuler les magasins de disques ou les magasins de paquets ExtraHop, contactez le support ExtraHop pour obtenir de l'aide.

Restaurer le microprogramme via l'explorateur d'API REST

Important :L'explorateur d'API REST n'est pas disponible sur Reveal (x) 360.
  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 de /api/v1/explore/. Par exemple, si votre nom d'hôte est seattle-eda, l'URL est https://seattle-eda/api/v1/explore/.
  2. Cliquez Entrez la clé d'API puis collez ou saisissez votre clé d'API dans le Clé d'API champ.
  3. Cliquez Autoriser puis cliquez sur Fermer.
  4. Consultez la version précédente du microprogramme à laquelle vous pouvez revenir.
    1. Cliquez Hop supplémentaire puis cliquez sur GET /extrahop/firmware/previous.
    2. Cliquez Essayez-le.
    3. Cliquez Envoyer une demande.
      La section Réponse du serveur affiche les informations suivantes :

      version: Version du microprogramme précédente à laquelle le système peut être restauré.

      heure de sauvegarde: La dernière fois que la sonde ou la console a généré un fichier de sauvegarde avant d'être mis à niveau vers la version actuelle, exprimée en millisecondes depuis l'époque. La sonde ou la console crée automatiquement une sauvegarde à chaque mise à niveau du système.

      Les informations apparaissent dans un format similaire au texte suivant :

      {
  "version": "8.4.0.1522",
  "backup_time": 1617229294388
}

  5. Restaurez la version du microprogramme.
    1. Cliquez POST /extrahop/firmware/précédent/rollback.
    2. Cliquez Essayez-le.
    3. Cliquez Envoyer une demande.
      La section Réponse du serveur affiche un code dstatus 202.
      Remarque :Le processus de restauration peut prendre plusieurs minutes .
  6. Vérifiez que la mise à niveau du microprogramme est terminée.
    1. Cliquez OBTENIR /extrahop.
    2. Cliquez Essayez-le.
    3. Cliquez Envoyer une demande.
      Si le processus de restauration du microprogramme est terminé, la section de réponse du serveur affiche le code d'état 200 et la version du microprogramme sonde ou console est actuellement en cours d'exécution.

      Si le processus de restauration du microprogramme est toujours en cours, la section de réponse du serveur affiche un code d'erreur 503.

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

Le référentiel GitHub d'ExtraHop contient un exemple de script Python qui annule le microprogramme pour plusieurs capteurs ou consoles en lisant des URL et des clés d'API à partir d'un fichier CSV.

Important :L'exemple de script python s'authentifie auprès de la sonde ou de la console via une clé API, qui n'est pas compatible avec l' API REST Reveal (x) 360. Pour exécuter ce script avec Reveal (x) 360, vous devez modifier le script pour vous authentifier à l'aide de jetons d'API. Consultez le py_rx360_auth.py script dans le référentiel GitHub ExtraHop pour un exemple de procédure d'authentification à l'aide de jetons API.
  1. Accédez au Référentiel GitHub d'exemples de code ExtraHop et téléchargez le rollback_firmware/rollback_firmware.py fichier sur votre machine locale.
  2. Créez un fichier CSV avec des lignes contenant les colonnes suivantes dans l' ordre indiqué :
    Nom d'hôte du système Clé d'API
    Conseil :Le rollback_firmware le répertoire contient un exemple de fichier CSV nommé systems.csv.
  3. Dans un éditeur de texte, ouvrez upgrade_system.py archivez et remplacez les variables de configuration suivantes par des informations provenant de votre environnement :

    LISTE_SYSTÈME: Le chemin de fichier relatif du fichier CSV.

  4. Exécutez la commande suivante : 
    python3 rollback_firmware.py

    Le script renvoie la version que chaque sonde ou console peut être ramené à.

    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)
  5. Pour démarrer le processus de restauration, tapez y et appuyez sur ENTER.
Last modified 2023-11-07