Définir une requête HTTP Get Call
Dans le cadre de la création ou de la modification d'un modèle de détection, vous pouvez utiliser l'opération Http Get Call pour extraire des informations des éléments de configuration (CI) qui utilisent le protocole HTTP.
Avant de commencer
Rôle requis : pd_admin
- Sur le formulaire de modèle, sélectionnez la section d'identification pertinente pour Détection.
Vous pouvez également sélectionner la section d'identification ou de connexion pertinente pour Mappage des services.
- Sélectionnez l'étape de modèle pertinente ou cliquez sur le bouton
pour ajouter une étape.
Une connaissance de base de la programmation est souhaitée.
Procédure
- Sélectionnez Http Get Call dans la liste Opération.
-
Définissez les paramètres de requête si nécessaire :
Avertissement :Si vous avez personnalisé cette opération comme décrit dans Personnaliser les opérations de modèle, les paramètres de requête peuvent être différents.
Champ Description Authentification requise Si l'authentification est requise pour détecter le CI : - Définissez ce paramètre sur true.
- Configurez les informations d’identification du CI que vous souhaitez détecter, comme décrit dans Informations d’authentification de base.
Définissez ce paramètre sur false ou laissez-le vide si aucune authentification n'est requise pour accéder au CI.
URL Spécifiez l'URL du CI à détecter à l'aide de ce modèle. Vous pouvez utiliser des variables. Vous pouvez également saisir une valeur du champ spécifique dans une variable tabulaire, comme décrit dans Saisir des valeurs et des variables dans les modèles.
En-têtes (Facultatif) Définissez des en-têtes HTTP pour définir le format de sortie. Par exemple, pour afficher la sortie au format JSON et ajouter les données de politique de sécurité, configurez l'en-tête comme suit : content-type:text/JSON,content-security-policy:object-src 'none';base-uri 'self';script-src 'unsafe-inline' https: http: 'unsafe-eval';report-uri /_/NotificationsOgbUi/cspreport - Pour enregistrer l'intégralité de la sortie de commande en tant que variable, sélectionnez AUCUN dans la liste Définir l'analyse et définissez la variable comme décrit dans l'étape 6.
-
Sélectionnez la stratégie d'analyse dans la liste Définir l'analyse.
Stratégie d'analyse Description Oracle
Fichier LDAP
Fichier XML
Fichier INI
Fichier de propriétés
Fichier JSON (personnalisé)
Stratégie d'analyse horizontale du fichier (pas verticale). Vous pouvez utiliser cette stratégie d'analyse uniquement pour les fichiers texte. Pour en savoir plus, consultez Analyser du texte à partir d'un fichier horizontal. Fichier vertical Récupérez le texte à partir d'un fichier texte structuré où chaque ensemble de données s'étend sur plusieurs lignes. Pour en savoir plus, consultez Analyser du texte à partir d'un fichier vertical. Après le mot clé
Récupérez le texte directement en suivant un mot clé spécifique. Pour en savoir plus, consultez Analyser du texte à l'aide d'un mot clé, d'une commande et d'un type de position.
Style de ligne de commande Java
Récupérez la valeur d'un paramètre de ligne de commande à l'aide des paramètres de style Java. Pour en savoir plus, consultez Analyser du texte à l'aide d'un mot clé, d'une commande et d'un type de position.
Style de ligne de commande Unix
Récupérez la valeur d'un paramètre de ligne de commande à l'aide des paramètres Unix standard. Pour en savoir plus, consultez Analyser du texte à l'aide d'un mot clé, d'une commande et d'un type de position.
Position à partir de la fin
Récupérez le texte spécifié par sa position à partir de la fin de la ligne. Pour en savoir plus, consultez Analyser du texte à l'aide d'un mot clé, d'une commande et d'un type de position.
Position à partir du début
Récupérez le texte spécifié par sa position à partir du début de la ligne. Pour en savoir plus, consultez Analyser du texte à l'aide d'un mot clé, d'une commande et d'un type de position.
Expression régulière Récupérez le texte spécifié par une expression régulière. Cette option nécessite de connaître la syntaxe Regex Java. Pour en savoir plus, consultez Analyser du texte à l'aide d'une expression régulière. Texte délimité Récupérez le texte spécifié par les délimiteurs et la position dans la ligne (la manière la plus courante de récupérer le texte à partir des fichiers texte génériques). Voir Analyser du texte à l'aide d'un texte délimité. -
Si vous travaillez en mode de débogage, définissez les critères d'analyse comme suit :
- Cliquez sur Exécuter une opération pour afficher le résultat dans le volet Sortie.
- Dans le panneau Sortie, marquez le texte ou les symboles que vous souhaitez que la variable contienne.
-
Dans la zone de nom de la variable, saisissez le nom de la nouvelle variable, par exemple « process_name ».
-
Appuyez sur Entrée.
La nouvelle variable est ajoutée dans le panneau Variables.
-
Si vous ne travaillez pas en mode de débogage, effectuez les étapes suivantes pour définir les critères d'analyse comme suit.
- Dans le panneau Variables, cliquez sur Ajouter une variable, puis saisissez le nom de la nouvelle variable.
-
Cliquez sur l'icône Avancé.
- Cliquez sur Ajouter une étiquette de colonne.
- Entrez la requête d'analyse.
- Entrez une valeur pour le délimiteur.
- Entrez une valeur pour la position.
- Sélectionnez Terminer pour arrêter la détection si aucun résultat n'est trouvé.
- Si vous êtes en mode de débogage, testez l'étape en cliquant sur Test et en vérifiant que l'opération renvoie le résultat attendu.
Exemple
Vous pouvez utiliser l'opération HTTP Get Call pour extraire des données sur les types de CI à l'aide de la stratégie d'analyse de fichier XML :
Que faire ensuite
- Continuez à modifier le modèle en ajoutant une nouvelle étape et en définissant son fonctionnement.
- Finalisez le modèle.