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

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

   Remarque :

   Si vous possédez déjà un certificat, vous pouvez ignorer 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 CA :

      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.

      URL DU SERVEUR: 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 de 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.

      URL DU SERVEUR: URL de votre serveur.

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

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

      Copier
2. Accédez au Référentiel GitHub d'exemples de code ExtraHop et téléchargez le ml_api_logger/ml_api_logger.go fichier sur votre machine locale.
3. Exécutez la commande suivante en remplaçant CERT_PATH avec 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 avec 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. Limitez l'enregistreur pour qu'il ne reçoive des paquets que sur une adresse IP de serveur spécifique.
   Par défaut, l'application Go reçoit des journaux sur toutes les adresses IP configurées pour le serveur. Pour limiter l'application à une seule adresse IP, exécutez la commande suivante en remplaçant IP par l' adresse IP :

   export LOGGER_IP=IP

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

   go build ml_api_logger.go

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

   ml_api_logger > extrahop-ade-log.json

   Copier

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

1. Connectez-vous aux paramètres d'administration de la sonde ou de la console via https://<extrahop-hostname-or-IP-address>/admin.
2. Dans la section Paramètres de l'appliance, cliquez sur Configuration en cours d'exécution.
3. Cliquez Modifier la configuration.
4. Dans le hop_cloud section, ajoutez une entrée où la clé est api_logging_target et la valeur est un objet avec les champs suivants :

   activé : Booléen

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

   nom d'hôte : Corde

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

   port : Numéro

   Port sur lequel le serveur tiers écoute.

   Le mis à jour hop_cloud la section doit ressembler au JSON suivant :

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

   Copier