HTTP
Fonction | Tester n'importe quelle URL RFC (HTTP, HTTPS, etc.) |
---|---|
Alarme | Code de réponse, temps de connexion, temps de transfert, correspondance du contenu, certificat valide |
Détails HTTP
Paramètres HTTP
Paramètre | Description |
---|---|
Url | URL RFC (HTTP, HTTPS, etc.) |
Nom d'utilisateur | Entrez un nom d'utilisateur au cas où l'URL nécessite une authentification. Pour tester si une page web accepte le nom d'utilisateur et le mot de passe tels que définis dans les champs spécifiques de SKOOR Engine, entrez l'URL de la manière suivante : |
Mot de passe | Saisissez un mot de passe au cas où l'URL nécessiterait une authentification. |
Méthode | Choisissez l'une des méthodes de requête suivantes : GET (par défaut) Si PUT ou POST est sélectionné, un champ de texte supplémentaire No Data est activé. |
No Data | Visible uniquement si la méthode PUT ou POST est sélectionnée. Permet de saisir le corps de la requête PUT/POST. |
Authentification | Choisissez l'un des types d'authentification suivants : Any (sélectionné par libcurl) (par défaut) |
Adresse du proxy | Il est possible de tester une URL via un proxy. Si ce champ est utilisé, la requête passe par le proxy. Contrairement aux requêtes HTTP normales, le temps d'établissement de la connexion au proxy est inclus dans cette mesure. Le temps total, y compris le téléchargement du site, est plus rapide s'il est mis en cache sur le proxy. |
Port du proxy | Numéro de port du proxy |
Nom d'utilisateur du proxy | Entrez le nom d'utilisateur du proxy |
Mot de passe du proxy | Entrer le mot de passe du proxy |
Authentification du proxy | Choisissez le type d'authentification pour le proxy. Voir le paramètre Authentification ci-dessus. |
Délai d'attente | Délai d'attente en secondes (120 s par défaut) avant de répondre par un Warning indiquant que la page web n'est pas disponible. |
Vérification du contenu | Vérifier le contenu textuel du document téléchargé. Les expressions régulières sont prises en charge. |
Suivre les redirections | Activez cette case à cocher si les redirections doivent être suivies (jusqu'à 50 redirections). |
Afficher l'expiration du certificat | Activez cette case à cocher pour vérifier l'expiration du certificat SSL. Cela permet de configurer des limites d'alarme à un certain nombre de jours avant l'expiration des certificats. |
Supprimer le temps de connexion | Si l'une de ces cases est cochée, l'heure de connexion et/ou l'heure de transfert de chaque contrôle n'est pas enregistrée dans la base de données et leurs valeurs ne sont plus visibles dans la section des valeurs. Leur valeur n'est également plus disponible pour être utilisée dans les spécifications des limites d'alarme. |
Version SSL/TLS | Choisissez l'une des implémentations suivantes : Par défaut Le paramètre par défaut dépend de la configuration du système d'exploitation. |
Vérifier l'homologue | Pour les connexions HTTPS, le certificat du serveur web peut être comparé à un fichier de certificat stocké sur le collecteur. Activez cette option pour vérifier si le certificat SSL du serveur web est authentique, c'est-à-dire que l'on peut croire que le serveur est bien celui que le certificat indique. Si ce champ est activé, le fichier de certificat correct du serveur doit être stocké sur SKOOR Engine (voir le paramètre suivant Fichier de certificat). Le certificat stocké est comparé au certificat émis par le serveur lors de l'exécution de la tâche HTTP. |
Fichier de certificat | Uniquement visible si le paramètre Vérifier l'homologue ci-dessus est défini sur Le certificat doit être authentique. Saisissez le nom du fichier de certificat (par exemple host.crt) auquel le certificat du serveur est comparé. Les fichiers de certificat doivent d'abord être copiés sur SKOOR Engine dans son répertoire /opt/eranger/collector/certificates. Le chemin peut être modifié en éditant la variable http_cert_path dans le fichier eranger-collector.cfg. |
Vérifier l'hôte | Cette option n'est visible que si le paramètre Vérifier l'homologue ci-dessus est défini sur Le certificat doit être authentique. Sélectionnez La vérification doit être réussie pour vérifier si le nom commun (CN) spécifié dans le certificat du serveur web correspond à l'URL du serveur. |
En-tête HTTP | Entrez tout en-tête HTTP que SKOOR Engine doit envoyer avec la requête. Ceci est surtout utile pour changer la langue demandée pour la page web ou pour changer l'agent utilisateur avec lequel SKOOR Engine s'identifie auprès du serveur web. L'agent utilisateur par défaut est : "SKOOR Engine Monitoring Agent" si cet en-tête n'est pas défini. Le lien Wikipedia situé juste à côté du champ de texte de l'en-tête mène à la page Wikipedia décrivant tous les en-têtes HTTP disponibles. |
Enregistrer le contenu dans un fichier | Définir un nom de fichier dans lequel la sortie de la requête sera écrite. Des balises peuvent être utilisées, par exemple $DEVICE_ADDRESS$. Selon le suffixe du nom de fichier (.txt ou .html), le navigateur rendra la page différemment lorsqu'il cliquera sur le lien du fichier. La spécification d'un nom de fichier bien défini est utile si la sortie sera analysée par un travail de parsefile suivant. Un fichier de sortie du nom <http_NNN_NNN.txt> sera créé si ce champ est laissé vide, où N sont des nombres entiers générés aléatoirement lors de la création initiale de la tâche. Indiquez uniquement le nom du fichier sans aucun chemin d'accès. Par défaut, il sera stocké sous /var/opt/run/eranger/collector/tmp. |
La liste déroulante Tags permet de saisir des variables prédéfinies dans les champs ci-dessus, par exemple $NAME$ pour le nom du travail.
Si la configuration d'un travail l'exige, les paramètres peuvent être encodés ou décodés à l'aide de l'aide URL Encode/Decode dans le pied de page des travaux :
Valeurs HTTP et limites d'alarme
Valeur / Limite d'alarme | Description de la valeur |
---|---|
Code de réponse | Utilisez le code de réponse du serveur web comme limite d'alarme. Les codes de retour normalement acceptés sont : 200 OK et 302 Found Mais toute autre valeur peut être vérifiée. Voici une liste des codes de réponse les plus souvent utilisés : 100 Continue Cela signifie que le serveur a reçu les en-têtes de la demande et que le client doit envoyer le corps de la demande (dans le cas d'une demande pour laquelle un corps doit être envoyé ; par exemple, une demande POST). Si le corps de la requête est volumineux, il est inefficace de l'envoyer à un serveur alors qu'une requête a déjà été rejetée sur la base d'en-têtes inappropriés. Pour qu'un serveur vérifie si la demande peut être acceptée sur la base des seuls en-têtes de la demande, un client doit envoyer Expect : 100-continue comme en-tête dans sa demande initiale et vérifier si un code d'état 100 Continue est reçu en réponse avant de continuer (ou recevoir 417 Expectation Failed et ne pas continuer). 200 OK Réponse standard aux requêtes HTTP réussies. 201 Créé La demande a été satisfaite et a entraîné la création d'une nouvelle ressource. 202 Accepté La demande a été acceptée pour traitement, mais le traitement n'est pas terminé. La demande peut être traitée ou non, car elle peut être rejetée lorsque le traitement a effectivement lieu. 301 Déplacé en permanence Cette demande et toutes les demandes futures doivent être dirigées vers l'URL indiquée. 302 Found Il s'agit du code de redirection le plus populaire, mais aussi d'un exemple de pratique industrielle contredisant la norme. La spécification HTTP/1.0 exigeait que le client effectue une redirection temporaire (la phrase descriptive originale était "Moved Temporarily"), mais les navigateurs les plus répandus l'implémentaient sous la forme d'un code 303 See Other. C'est pourquoi HTTP/1.1 a ajouté les codes d'état 303 et 307 pour distinguer les deux comportements. Cependant, la majorité des applications Web et des frameworks utilisent toujours le code d'état 302 comme s'il s'agissait du 303. 305 Utiliser un proxy (depuis HTTP/1.1) De nombreux clients HTTP (tels que Mozilla et IE) ne traitent pas correctement les réponses contenant ce code d'état, principalement pour des raisons de sécurité. 307 Redirection temporaire Dans ce cas, la demande doit être répétée avec un autre URI, mais les demandes ultérieures peuvent toujours utiliser l'URI d'origine. Contrairement à 303, la méthode de requête ne doit pas être modifiée lors de la réémission de la requête initiale. Par exemple, une requête POST doit être répétée en utilisant une autre requête POST. 400 Mauvaise requête La demande contient une mauvaise syntaxe ou ne peut être satisfaite. 401 Non autorisé Similaire à 403 Forbidden, mais spécifiquement utilisé lorsque l'authentification est possible mais a échoué ou n'a pas encore été fournie. 403 Interdit La demande était légale, mais le serveur refuse d'y répondre. Contrairement à la réponse 401 Unauthorized, l'authentification ne changera rien. 404 Non trouvé La ressource demandée n'a pu être trouvée. 405 Méthode non autorisée Une requête a été faite auprès d'une ressource en utilisant une méthode de requête non supportée par cette ressource ; par exemple, en utilisant GET sur un formulaire qui requiert que les données soient présentées via POST, ou en utilisant PUT sur une ressource en lecture seule. 406 Non acceptable 407 Authentification du proxy requise 408 Délai d'attente de la demande Le client n'a pas pu poursuivre la requête - sauf lors de la lecture de vidéos Adobe Flash, où cela signifie simplement que l'utilisateur a fermé la fenêtre de la vidéo ou est passé à une autre vidéo. 409 Conflit 410 Disparu Indique que la ressource demandée n'est plus disponible et ne le sera plus. Cette mention devrait être utilisée lorsqu'une ressource a été intentionnellement supprimée ; cependant, dans la pratique, une mention 404 Not Found est souvent émise à la place. 411 Longueur requise 412 Échec de la condition préalable 413 Request Entity Too Large (Entité de la demande trop grande) 414 Request-URI Too Long 415 Type de média non pris en charge 416 Plage demandée insatisfaisante Le client a demandé une partie du fichier, mais le serveur ne peut pas fournir cette partie (par exemple, si le client a demandé une partie du fichier qui se trouve au-delà de la fin du fichier). 417 Échec d'une attente 421 Il y a trop de connexions à partir de votre adresse internet 422 Entité non traitable La demande était bien formée mais n'a pas pu être suivie en raison d'erreurs sémantiques. 423 Verrouillé (WebDAV) La ressource à laquelle on accède est verrouillée. 424 Échec d'une dépendance (WebDAV) La demande a échoué en raison de l'échec d'une demande précédente (par exemple, un PROPPATCH). 425 Collection non ordonnée Définie dans les versions préliminaires de WebDav Advanced Collections, mais absente de "Web Distributed Authoring and Versioning (WebDAV) Ordered Collections Protocol". 426 Mise à niveau requise Le client doit passer à. 449 Réessayer avec Une extension de Microsoft : La demande doit être réessayée après avoir effectué l'action appropriée.... 500 Erreur interne du serveur 501 Non implémenté 502 Mauvaise passerelle 503 Service indisponible 504 Délai d'attente de la passerelle 505 Version HTTP non prise en charge 506 La variante négocie également 507 Stockage insuffisant 509 Limite de bande passante dépassée Ce code d'état, bien qu'utilisé par de nombreux serveurs, n'est pas un code d'état HTTP officiel. 510 Pas d'extension |
Temps de connexion | Temps nécessaire à l'établissement de la connexion TCP avec le serveur (en ms). Le handshake SSL n'est pas calculé. |
Temps de transfert | Temps nécessaire pour qu'une page web soit servie et que la connexion soit fermée (en ms). |
Correspondance des contenus | Fixer des limites en fonction du nombre de fois qu'une chaîne de caractères ou une expression régulière est trouvée dans le contenu de la page web testée. |
Certificat valide | Nombre de jours avant l'expiration du certificat SSL distant. |
Code d'erreur | Code d'erreur générique du travail (voir la section Codes d'erreur du travail) |
Exemples HTTP
Exemple 1 - Test d'une page web
Testez une page web sur le port par défaut (80) et utilisez la balise $DEVICE_ADDRESS$. De cette manière, la tâche ou le dispositif peut être copié sans modifier les paramètres de la tâche elle-même, seul le nom de la tâche diffère.
Url | http://$ADRESSE_DU_DISPOSITIF$. |
---|---|
Suivre les redirections | Activer |