Créer une classification HTTP

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 3 minutes de lecture
  • Un classifieur HTTP permet au processus de détection horizontale de rechercher des appareils via le protocole HTTP.

    Avant de commencer

    Rôle requis : discovery_admin

    Pourquoi et quand exécuter cette tâche

    Vous pouvez créer des classifications HTTP supplémentaires pour classifier les appareils via HTTP/REST, plutôt que par le biais d'un autre protocole. Utilisez la classification HTTP uniquement pour la détection d'appareils, et non pour la détection d'applications.

    Remarque :
    Par défaut, le classifieur F5 HTTP est fourni pour classifier les équilibreurs de charge F5 à l'aide de REST. Le modèle REST F5 LB est également fourni pour explorer l'appareil. Vous n'avez pas besoin de créer un nouveau classifieur HTTP pour les équilibreurs de charge F5.
    Parmi tous les protocoles utilisés par Découverte (y compris WMI, SSH et SNMP), HTTP a la priorité la plus basse par défaut. Discovery utilise la classification HTTP uniquement si :
    • Shazzam détermine que les ports pour le trafic HTTP (80) et HTTPS (443) sont ouverts.
    • Le processus de détection horizontal échoue pour les sondes de ports avec une priorité plus élevée (WMI, SSH et SNMP) si les ports de ces protocoles ne sont pas ouverts ou si la détection pour ces protocoles échoue. Le processus de détection horizontal peut échouer, par exemple, si les informations d'identification SSH et SNMP ne sont pas configurées ou sont incorrectes.
      Remarque :
      Consultez Sondes de ports pour en savoir plus sur le fonctionnement de l'analyse des ports et pour voir les priorités des différents protocoles.
    La classification HTTP lance la sonde HTTP Classify pour classer l'appareil. La sonde HTTP - Classify exécute une demande GET pour chaque appareil et pour chaque classification HTTP. L'URL de la demande est créée comme suit : PROTOCOL://IP:PORT/PATH, où :

    Procédure

    1. Accédez à la Tout > Définition de découverte > Classification CI > HTTP.
    2. Cliquez sur Nouveau.
    3. Renseignez les champs de formulaire (consultez le tableau) :
      Figure 1. La classification F5 HTTP
      Classification HTTP
      Champ Description
      Nom Entrez un nom pour le classifieur.
      Chemin d'accès Entrez le chemin d'accès de la demande HTTP GET.
      En-têtes Ajoutez un en-tête d'option avec une valeur. Vous pouvez utiliser une variable au format ${variable} au lieu d'une valeur statique.

      Les en-têtes pris en charge dépendent du fournisseur de service Web REST auquel vous souhaitez vous connecter. Consultez la documentation de votre fournisseur de services Web pour identifier quels en-têtes sont valides ou requis.

      Port (Service IP)

      Si vous souhaitez que ce classifieur utilise un port personnalisé qui n'est pas déjà une valeur par défaut dans la table Service IP [cmdb_ip_service], procédez comme suit :

      1. Sélectionnez l’icône de recherche pour afficher la liste des services IP.
      2. Sélectionnez Nouveau et créez un mappage de port à protocole.
      3. Sélectionnez ce mappage de port à protocole pour le champ Port.

      De nombreux protocoles couramment utilisés sont déjà mappés aux ports par défaut, tels que http pour le port 80 et https pour le port 443.

      Si vous souhaitez utiliser l’un de ces mappages de port à protocole par défaut, ne saisissez aucune valeur dans le champ Port . La sonde de port HTTP utilise la sonde appropriée par défaut.

      Ordre

      Entrez un nombre qui représente la priorité de ce classifieur. Si la détection Découverte trouve plusieurs classifieurs qui s'appliquent, elle utilise le classifieur avec le nombre Ordre le plus bas.

      Protocole

      [facultatif]

      Ce champ n’est pas visible par défaut. Vous devez configurer le formulaire pour l'ajouter.

      Si vous configurez un mappage de port à protocole unique pour le champ Port, entrez un remplacement de protocole facultatif que Discovery utilise avec ce classifieur.

      Par exemple, si vous souhaitez utiliser le port 5000 et le protocole HTTP, ajoutez le mappage de port à protocole 5000/HTTP au champ Port, puis choisissez http dans le champ Protocole.
    4. Cliquez avec le bouton droit de la souris sur l'en-tête, puis choisissez Enregistrer.

      Un enregistrement est créé dans la table Classifications HTTP [discovery_classy_http].

      La liste connexe Correspondance de classification HTTP s'affiche. Cette liste connexe affiche les critères que vous configurez pour qu'ils correspondent au corps de la réponse de la demande GET qu'envoie Découverte.

    5. Dans la liste connexe Correspondance de classification HTTP, définissez les critères et spécifiez le modèle à exécuter pour ce classifieur.
      Il est nécessaire de respecter ces critères pour que Découverte utilise ce classifieur HTTP.
      1. Cliquez sur Nouveau.
      2. Renseignez les champs du formulaire Correspondance de classification HTTP (consultez le tableau).
        Correspondance de classification HTTP
        Champ Description
        Opérateur Choisissez l'opérateur que le système utilise pour évaluer la condition :
        • Contient
        • Est égal à
        • Regex
        Ordre

        Entrez un nombre qui représente la priorité de cette condition. Si la détection Découverte trouve plusieurs conditions qui s'appliquent, elle utilise la condition avec le nombre Ordre le plus bas.

        Modèle Spécifiez le modèle à lancer en cas de correspondance appropriée. Ce modèle doit utiliser http pour détecter l'appareil.
        Valeur Entrez la valeur que le corps de la méthode REST renvoyée doit avoir.
      3. Cliquez sur Envoyer.
      4. S'il existe des modèles différents selon les versions de l'appareil que vous tentez de détecter, définissez autant de correspondances de classification HTTP que nécessaire.