Exporter les journaux des interactions API du service d'apprentissage automatique

1. Générez un certificat de serveur pour le serveur HTTP.

   Remarque :

   Si vous disposez déjà d'un certificat, vous pouvez sauter cette étape.

   1. Exécutez la commande suivante pour générer la clé de l'autorité de certification (CA) :

      openssl genrsa -aes256 -out serverca.key 4096

      Copier
   2. Exécutez la commande suivante pour générer le certificat de l'autorité de certification :

      openssl req -new -key serverca.key -x509 -out serverca.crt -days 3650

      Copier
   3. Exécutez la commande suivante avec vos variables pour générer une demande de signature de certificat :

      openssl req -new \
          -nodes \
          -newkey rsa:4096 \
          -keyout server.key \
          -out server.req \
          -batch \
          -subj "/C=US/ST=WA/L=Seattle/O=ORGANIZATION_NAME/OU=router/CN=SERVER_URL" \
          -reqexts SAN \
          -config <(cat /etc/ssl/openssl.cnf <(printf "[SAN]\nsubjectAltName=DNS:SERVER_URL,IP:SERVER_IP_ADDRESS"))

      Copier

      Remplacez les variables suivantes dans la commande ci-dessus :

      ADRESSE_IP_DU_SERVEUR: L'adresse IP de votre serveur.

      SERVER_URL: L'URL de votre serveur.

      NOM_ORGANISATION: Le nom de votre organisation.

   4. Exécutez la commande suivante avec vos variables pour générer le certificat du serveur :

      openssl x509 -req \
          -in server.req \
          -CA serverca.crt \
          -CAkey serverca.key \
          -CAcreateserial \
          -out server.crt \
          -days 3650 \
          -sha256 \
          -extfile <(printf "subjectAltName=DNS:SERVER_URL,IP:SERVER_IP_ADDRESS")

      Copier

      Remplacez les variables suivantes dans la commande ci-dessus :

      ADRESSE_IP_DU_SERVEUR: L'adresse IP de votre serveur.

      SERVER_URL: L'URL de votre serveur.

   5. Exécutez la commande suivante pour créer un certificat dans un format que vous pouvez télécharger vers le capteur ou la console.

      cat server.key server.crt serverca.crt > trusted-server.pem

      Copier
2. Allez sur le dépôt GitHub ExtraHop code-examples et téléchargez le fichier ml_api_logger/ml_api_logger.go sur votre machine locale.
3. Exécutez la commande suivante, en remplaçant CERT_PATH par le chemin du certificat TLS que vous avez généré pour le serveur :

   export LOGGER_CERT=CERT_PATH

   Copier
4. Exécutez la commande suivante, en remplaçant KEY_PATH par le chemin de la clé avec laquelle vous avez signé le certificat :

   export LOGGER_KEY=KEY_PATH

   Copier
5. Exécutez la commande suivante, en remplaçant PORT par le port sur lequel le serveur écoute :

   export LOGGER_PORT=PORT

   Copier
6. Dans le répertoire ml_api_logger, exécutez la commande suivante pour compiler le code Go :

   go build ml_api_logger.go

   Copier
7. Exécutez la commande suivante pour démarrer le serveur et enregistrer les journaux de l'API à l'adresse extrahop-ade-log.json:

   ml_api_logger > extrahop-ade-log.json

   Copier

Vous devez configurer le capteur ou la console pour exporter les journaux vers le serveur que vous avez configuré.

1. Connectez-vous aux paramètres d'administration du capteur ou de la console via https://<extrahop-hostname-or-IP-address>/admin.
2. Dans la section Appliance Settings (Paramètres de l'appareil), cliquez sur Running Config (Configuration en cours d'exécution).
3. Cliquez sur Edit config.
4. Dans la section hop_cloud, ajoutez une entrée dont la clé est api_logging_target et la valeur est un objet avec les champs suivants :

   enabled : Booléen

   Spécifie si la journalisation des interactions API est activée. Spécifiez true.

   hostname : Chaîne

   Le nom d'hôte du serveur que vous avez configuré pour recevoir les journaux d'interaction avec l'API.

   port : Nombre

   Le port sur lequel le serveur tiers écoute.

   La section hop_cloud mise à jour doit ressembler au JSON suivant :

      "hopcloud" : {"api_logging_target" : {"enabled" : true "hostname" : "example.extrahop.com" "port" : 100 } "analysis_settings" : {} }

   Copier