Exécuter Discovery via un appel REST HTTP ou HTTPS

Discovery peut classifier les appareils à l'aide des protocoles HTTP et HTTPS. Vous pouvez créer votre propre classifieur HTTP pour trouver des appareils et y accéder avec des informations d'identification pour l'authentification de base au lieu d'utiliser les informations d'identification SNMP ou SSH.

Avant de commencer

Rôle requis : discovery_admin

Procédure

1. Accédez à la Tout > Découverte > Informations d'identification.
2. Cliquez sur Nouveau.
3. Sélectionnez Informations d'identification pour l'authentification de base.
   Dans la plupart des cas, vous pouvez utiliser les informations d'identification pour l'authentification de base afin d'accéder à un appareil via un appel REST HTTP ou HTTPS.
4. Ajoutez le nom d'utilisateur et le mot de passe dont vous avez besoin pour accéder à l'appareil.
5. Cliquez sur Envoyer.
6. Configurez un classifieur HTTP en accédant à Définition de découverte > Classification CI > HTTP.
7. Cliquez sur Nouveau.
8. Renseignez les champs de formulaire (consultez le tableau) :

   Figure 1. La classification F5 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 : Sélectionnez l’icône de recherche pour afficher la liste des services IP. Sélectionnez Nouveau et créez un mappage de port à protocole. 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 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.

9. Cliquez avec le bouton droit de la souris sur l'en-tête, puis sélectionnez Enregistrer.
   La liste connexe Correspondance de classification HTTP s'affiche. Cette liste connexe affiche les critères que vous pouvez configurer pour qu'ils correspondent au corps de la réponse à la demande GET envoyée par Discovery.
10. Dans la liste connexe Correspondance de classification HTTP, définissez les critères de correspondance et spécifiez le modèle à exécuter pour ce classifieur :
    1. Cliquez sur Nouveau.
    2. Renseignez les champs du formulaire Correspondance de classification HTTP (consultez le tableau).
       

       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. Définissez autant de correspondances de classification HTTP que nécessaire.
       Vous pouvez effectuer cette action s'il existe différents modèles pour différentes versions de l'appareil que vous essayez de détecter.

Exemple

Dans cet exemple, la classification HTTP est configurée pour utiliser l'API d'équilibreur de charge f5 :

Que faire ensuite

Si vous n'avez pas d'autres types d'informations d'identification pouvant trouver des appareils, tels que les informations d'identification Linux ou SNMP, vous pouvez voir comment l'application Discovery traite la détection HTTP :

1. Accédez à la Découverte > Calendriers de découverte et exécuter une détection.
2. À l'issue du processus de détection, vérifiez la file d'attente ECC pour voir les résultats de la détection HTTP.

   Vous devez voir cela après le lancement de la sonde Shazzam et l'échec des sondes de classification Unix et SNMP. La sonde HTTP : classifier et le modèle que vous spécifiez dans l'enregistrement de classification HTTP doivent être lancés.