Documentation

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

Code de réponse, temps de connexion, temps de transfert, correspondances de contenu, certificat valide

URL

URL RFC (HTTP, HTTPS, etc.)

Nom d'utilisateur

Saisissez 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, saisissez l'URL de la manière suivante :

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

Mot de passe

Saisissez 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 vous sélectionnez PUT ou POST, un champ de texte supplémentaire intitulé « Données » s'affiche.

Données

Visible uniquement si la méthode PUT ou POST est choisie. Permet de saisir le corps de la requête PUT/POST.

Authentification

Choisissez l’un des types d’authentification suivants :

N'importe quelle méthode (sélectionnée par libcurl) (par défaut)
N'importe quelle méthode sauf Basic
Basic
Digest
Digest avec variante
IE Négociation (SPNEGO)
NTLM

Adresse du proxy

Il est possible de tester une URL via un proxy. Si ce champ est renseigné, la requête transite 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, téléchargement du site compris, est plus court si celui-ci est mis en cache sur le proxy.

Port du proxy

Numéro de port du proxy

Nom d'utilisateur du proxy

Saisir le nom d'utilisateur du proxy

Mot de passe du proxy

Entrez le mot de passe du proxy

Authentification du proxy

Choisissez le type d'authentification auprès du proxy. Voir le paramètre d'authentification ci-dessus.

Délai d'expiration

Délai d'expiration en secondes (valeur par défaut : 120 s) avant l'affichage d'un message Warning indiquant que la page Web n'est pas disponible

Vérification du contenu

Vérification du 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 la date d'expiration du certificat

Cochez cette case pour vérifier la date d'expiration du certificat SSL. Cela permet de configurer des seuils d'alerte un certain nombre de jours avant l'expiration des certificats.

Masquer la durée
de connexion Masquer la durée de transfert

Si l’une de ces cases est cochée, la durée de connexion et/ou la durée de transfert de chaque vérification ne sont pas enregistrées 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 seuils d’alerte.

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 que le certificat indique. Si ce champ est activé, le fichier de certificat valide 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

Ce champ n’est visible que si le paramètre « Vérifier le pair » 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 sera comparé. Les fichiers de certificat doivent d’abord être copiés sur 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-collecteur.cfg.

Vérifier l’hôte

Cette option n’est visible que 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 réussir » 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

Saisissez tout en-tête HTTP que SKOOR Engine doit envoyer avec la requête. Cela est principalement 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 saisie de l’en-tête renvoie vers 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 le résultat de la requête sera enregistré.

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 vers le fichier. Il est pratique de spécifier un nom de fichier bien défini si le résultat doit être analysé par une tâche parsefile ultérieure. Un fichier de sortie nommé <http_NNN_NNN.txt> sera créé si ce champ est laissé vide, où N sont des entiers générés aléatoirement lors de la création initiale de la tâche. Indiquez uniquement le nom de fichier, sans aucun élément de chemin d’accès. Par défaut, il sera stocké dans le répertoire /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 Trouvé

Mais toute autre valeur peut être vérifiée.

Voici une liste des codes de réponse les plus couramment utilisés :

100 Continue

Cela signifie que le server a bien reçu les en-têtes de la requête et que le client doit poursuivre en envoyant le corps de la requête (dans le cas d'une requête nécessitant l'envoi d'un corps, par exemple une requête POST). Si le corps de la requête est volumineux, l'envoyer à un server alors que la requête a déjà été rejetée en raison d'en-têtes inappropriés est inefficace. Pour qu’un server vérifie si la requête peut être acceptée sur la seule base de ses en-têtes, un client doit envoyer « Expect: 100-continue » comme en-tête dans sa requête initiale et vérifier s’il reçoit un code d’état 100 Continue en réponse avant de continuer (ou s’il reçoit 417 Expectation Failed et ne doit pas continuer).

200 OK

Réponse standard aux requêtes HTTP abouties.

201 Créé

La requête a été traitée et a abouti à la création d’une nouvelle ressource.

202 Accepté

La requête a été acceptée pour traitement, mais celui-ci n'est pas encore terminé. La requête pourra ou non être traitée, car elle pourrait être refusée au moment du traitement effectif.

301 Déplacé de manière permanente

Cette requête, ainsi que toutes les requêtes futures, doivent être redirigées vers l'URL indiquée

302 Trouvé

Il s’agit du code de redirection le plus répandu, 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 d’origine était « Déplacé temporairement »), mais les navigateurs courants l’ont implémentée sous la forme d’un code 303 « Voir autre ». C’est pourquoi HTTP/1.1 a ajouté les codes d’état 303 et 307 afin de distinguer clairement ces 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 gèrent pas correctement les réponses comportant ce code d'état, principalement pour des raisons de sécurité.

307 Redirection temporaire

Dans ce cas, la requête doit être réitéré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éitérée à l’aide d’une autre requête POST.

400 Demande incorrecte

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

401 Non autorisé

Similaire au code 403 « Accès interdit », mais utilisé spécifiquement lorsque l'authentification est possible mais a échoué ou n'a pas encore été fournie. 

403 Accès interdit

La requête était valide, mais le server refuse d'y répondre. Contrairement à une réponse 401 Non autorisé, l'authentification n'y 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 non prise en charge par celle-ci ; par exemple, l'utilisation de la méthode GET sur un formulaire nécessitant l'envoi de données via POST, ou l'utilisation de la méthode PUT sur une ressource en lecture seule.

406 Non acceptable

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

411 Longueur requise

412 Échec de la condition préalable

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 située au-delà de la fin du fichier).

417 Échec de l'attente

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

422 Entité non traitable

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

423 Verrouillé (WebDAV)

La ressource à laquelle on tente 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 projets de spécifications « WebDAV Advanced Collections », mais absent du « Protocole des collections ordonnées WebDAV (Web Distributed Authoring and Versioning) ».

426 Mise à niveau requise

Le client doit passer à...

449 Réessayer avec

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

500 Erreur interne du server

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 fait également l'objet d'une négociation

507 Espace de 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 qu’une page web soit servie et que la connexion soit fermée (en ms)

Correspondances de contenu

Définissez des limites en fonction du nombre d’occurrences d’une chaîne de caractères ou d’une expression régulière dans
le contenu de la page Web testée

Validité du certificat

Nombre de jours restant 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