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 :

http://<nom d'utilisateur>:<mot de passe>@URL

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)
PUT (mise à jour)
POST
DELETE

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)
Tout sauf Basic
De base
Digeste
Digest avec saveur IE
Négocier (SPNEGO)
NTLM

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
Supprimer le temps de transfert

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
TLSv1
SSLV2
SSLV3

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

Visible uniquement 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 au 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.
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

Sortie 1