Documentation

Testez n'importe quelle URL RFC (HTTP, HTTPS, etc.)

Code de réponse, temps de connexion, temps de transfert, correspondance du contenu, validité du certificat

URL

URL RFC (HTTP, HTTPS, etc.)

Nom d'utilisateur

Entrez un nom d'utilisateur si l'URL nécessite une authentification. Pour vérifier si une page Web accepte le nom d'utilisateur et le mot de passe définis dans les champs spécifiques du SKOOR Engine, entrez l'URL de la manière suivante :

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

Mot de passe

Entrez un mot de passe si l'URL nécessite 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 Données supplémentaire est activé.

Données

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 :

Tout (sélectionné par libcurl) (par défaut)
Tout sauf Basic
Basic
Digest
Digest avec IE Negotiate
(SPNEGO)
NTLM

Adresse 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 de 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 proxy

Numéro de port du proxy

Nom d'utilisateur du proxy

Entrer le nom d'utilisateur du proxy

Mot de passe du proxy

Entrez le mot de passe du proxy

Authentification proxy

Choisissez le type d'authentification pour le proxy. Voir le paramètre Authentification ci-dessus.

Délai d'expiration

Délai d'attente en secondes (la valeur par défaut est 120 s) avant de répondre avec un Warning indiquant que la page Web n'est pas disponible

Vérification du contenu

Vérifiez le contenu textuel du document téléchargé. Les expressions régulières sont prises en charge.

Suivre les redirections

Cochez cette case si les redirections doivent être suivies (jusqu'à 50 redirections).

Afficher l'expiration du certificat

Cochez cette case 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, le temps de connexion et/ou le temps de transfert de chaque vérification n'est pas enregistré 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 le pair

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 si l'on peut être sûr que le serveur est bien celui indiqué par le certificat. 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 server lorsque la tâche HTTP est exécutée.

Fichier de certificat

Visible uniquement si le paramètre Vérifier le pair ci-dessus est défini sur Le certificat doit être authentique. Entrez 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 dans SKOOR Engine, dans le répertoire /opt/eranger/collector/certificates. Le chemin d'accès peut être modifié en éditant la variable http_cert_path dans le fichier eranger-collector.cfg.

Vérifier l'hôte

Visible uniquement si le paramètre Vérifier le pair ci-dessus est défini sur Le certificat doit être authentique. Sélectionnez La vérification doit aboutir pour vérifier si le nom commun (CN) spécifié dans le certificat du server Web correspond à l'URL du server.

En-tête HTTP

Saisissez les en-têtes HTTP que SKOOR Engine doit envoyer avec la requête. Cela est particulièrement utile pour modifier la langue demandée de 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 Wikipédia situé juste à côté du champ de texte de l'en-tête mène à la page Wikipédia décrivant tous les en-têtes HTTP disponibles.

Enregistrer le contenu dans un fichier

Définissez un nom de fichier dans lequel la sortie de la requête sera écrite.

Des balises peuvent être utilisées, par exemple $DEVICE_ADDRESS$. En fonction de l'extension du nom de fichier (.txt ou .html), le navigateur affichera la page différemment lorsque vous cliquerez sur le lien du fichier. Il est utile de spécifier un nom de fichier bien défini si la sortie doit être analysée par une tâche parsefile suivante. Un fichier de sortie nommé <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. Spécifiez uniquement le nom du fichier sans aucun composant de chemin d'accès. Par défaut, il sera stocké sous /var/opt/run/eranger/collecteur/tmp.

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 fréquemment utilisés :

100 Continue

Cela signifie que le server a reçu les en-têtes de la requête et que le client doit procéder à l'envoi du corps de la requête (dans le cas d'une requête pour laquelle un corps doit être envoyé, par exemple une requête POST). Si le corps de la requête est volumineux, il est inefficace de l'envoyer à un server alors que la requête a déjà été rejetée en raison d'en-têtes inappropriés. Pour qu'un server vérifie si la requête peut être acceptée sur la base des en-têtes de la requête uniquement, un client doit envoyer Expect: 100-continue comme en-tête dans sa requête 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 Created

La requête a été satisfaite et a abouti à la création d'une nouvelle ressource.

202 Accepted

La requête a été acceptée pour traitement, mais celui-ci n'est pas encore terminé. La requête peut ou non être traitée, car elle peut être refusée lors du traitement proprement dit.

301 Déplacé de manière permanente

Cette requête et toutes les requêtes futures doivent être dirigées vers l'URL indiquée.

302 Trouvé

Il s'agit du code de redirection le plus populaire, mais aussi d'un exemple de pratique industrielle contraire à la norme. La spécification HTTP/1.0 exigeait que le client effectue une redirection temporaire (la phrase originale était « Déplacé temporairement »), mais les navigateurs populaires l'ont implémentée sous la forme d'un 303 Voir autre. Par conséquent, HTTP/1.1 a ajouté les codes d'état 303 et 307 afin de lever toute ambiguïté entre les deux comportements. Cependant, la majorité des applications et des frameworks Web utilisent toujours le code d'état 302 comme s'il s'agissait du code 303.

305 Use Proxy (depuis HTTP/1.1)

De nombreux clients HTTP (tels que Mozilla et IE) ne gèrent pas correctement les réponses avec ce code d'état, principalement pour des raisons de sécurité.

307 Redirection temporaire

Dans ce cas, la requête doit être répétée avec une autre URI, mais les requêtes futures peuvent toujours utiliser l'URI d'origine. Contrairement au code 303, la méthode de requête ne doit pas être modifiée lors de la réémission de la requête d'origine. Par exemple, une requête POST doit être répétée à l'aide d'une autre requête POST.

400 Mauvaise requête

La requête contient une syntaxe incorrecte ou ne peut être traitée.

401 Non autorisé

Similaire au code 403 Interdit, mais spécifiquement utilisé lorsque l'authentification est possible mais a échoué ou n'a pas encore été fournie. 

403 Interdit

La requête était légale, mais le server refuse d'y répondre. Contrairement à une réponse 401 Non autorisé, l'authentification ne changera rien.

404 Introuvable  

La ressource demandée est introuvable.

405 Méthode non autorisée

Une requête a été effectuée sur une ressource à l'aide d'une méthode de requête non prise en charge par cette ressource ; par exemple, l'utilisation de GET sur un formulaire qui nécessite que les données soient présentées via POST, ou l'utilisation de PUT sur une ressource en lecture seule.

406 Non acceptable

407 Authentification proxy requise

408 Délai d'attente de la requête

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 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. Ce code doit être utilisé lorsqu'une ressource a été supprimée intentionnellement ; cependant, dans la pratique, un code 404 Not Found est souvent émis à la place.

411 Longueur requise

412 Condition préalable non remplie

413 Entité de requête trop volumineuse

414 URI de requête trop long

415 Type de média non pris en charge

416 Plage demandée non satisfaisable

Le client a demandé une partie du fichier, mais le server 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 Attente non satisfaite

421 Il y a trop de connexions provenant de votre adresse Internet

422 Entité non traitable

La requête était bien formée, mais n'a pas pu être traitée en raison d'erreurs sémantiques.

423 Verrouillé (WebDAV)

La ressource à laquelle vous essayez d'accéder est verrouillée

424 Dépendance échouée (WebDAV)

La requête a échoué en raison de l'échec d'une requête précédente (par exemple, une requête PROPPATCH).

425 Collection non ordonnée

Défini dans les ébauches de WebDav Advanced Collections, mais absent du protocole « Web Distributed Authoring and Versioning (WebDAV) Ordered Collections Protocol ».

426 Mise à niveau requise

Le client doit passer à.

449 Réessayer avec

Une extension Microsoft : la requête doit être réessayée après avoir effectué l'action appropriée.

506 Erreur de serveur

501 Non implémenté

502 Passerelle incorrecte

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 servers, n'est pas un code d'état HTTP officiel.

510 Non étendu

Temps de connexion

Temps nécessaire à l'établissement de la connexion TCP avec le server (en ms). La négociation SSL n'est pas prise en compte.

Temps de transfert

Temps nécessaire pour servir une page Web et fermer la connexion (en ms)

Correspondances de contenu

Définissez des limites en fonction du nombre de fois qu'une chaîne 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 de la tâche (voir la section Codes d'erreur des tâches)

http://$DEVICE_ADDRESS$

Activer