Documentazione

Verifica qualsiasi URL RFC (HTTP, HTTPS ecc.)

Codice di risposta, Tempo di connessione, Tempo di trasferimento, Corrispondenze dei contenuti, Certificato valido

URL

URL RFC (HTTP, HTTPS ecc.)

Nome utente

Inserisci un nome utente nel caso in cui l'URL richieda l'autenticazione. Per verificare se una pagina web accetta nome utente e password come impostati nei campi specifici di SKOOR Engine, inserisci l'URL nel modo seguente:

http://<nome utente>:<password>@URL

Password

Inserisci una password nel caso in cui l'URL richieda l'autenticazione.

Metodo

Scegliere uno dei seguenti metodi di richiesta:

GET (impostazione predefinita)
PUT (Aggiorna)
POST
DELETE

Se si seleziona PUT o POST, viene abilitato un campo di testo aggiuntivo denominato "Dati".

Dati

Visibile solo se si sceglie il metodo PUT o POST. Consente di inserire il corpo della richiesta PUT/POST.

Autenticazione

Scegliere uno dei seguenti tipi di autenticazione:

Qualsiasi (selezionato da libcurl) (impostazione predefinita)
Qualsiasi tranne Basic
Basic
Digest
Digest con variante
IE Negotiate (SPNEGO)
NTLM

Indirizzo proxy

È possibile testare un URL tramite un proxy. Se si utilizza questo campo, la richiesta passa attraverso il proxy. A differenza delle normali richieste HTTP, in questa misurazione è incluso il tempo necessario per stabilire la connessione al proxy. Il tempo totale, compreso il download del sito, risulta più breve se il sito è memorizzato nella cache del proxy.

Porta del proxy

Numero di porta del proxy

Nome utente del proxy

Inserisci il nome utente del proxy

Password del proxy

Inserisci la password del proxy

Autenticazione proxy

Scegliere il tipo di autenticazione per il proxy. Vedere il parametro "Autenticazione" sopra.

Timeout

Timeout in secondi (il valore predefinito è 120 s) prima di rispondere con un messaggio di Warning che indica che la pagina web non è disponibile

Verifica del contenuto

Controlla il contenuto testuale all'interno del documento scaricato. Sono supportate le espressioni regolari.

Segui i reindirizzamenti

Selezionare questa casella di controllo se si desidera seguire i reindirizzamenti (fino a 50 reindirizzamenti)

Mostra la scadenza del certificato

Selezionare questa casella di controllo per verificare la scadenza del certificato SSL. Ciò consente di configurare i limiti di allarme un certo numero di giorni prima della scadenza dei certificati.

Nascondi il tempo
di connessione Nascondi il tempo di trasferimento

Se una di queste caselle di controllo è selezionata, il tempo di connessione e/o il tempo di trasferimento di ogni controllo non vengono salvati nel database e i relativi valori non sono più visibili nella sezione dei valori. Inoltre, il loro valore non è più disponibile per l’uso nelle specifiche dei limiti di allarme.

Versione SSL/TLS

Scegliere una delle seguenti implementazioni:

Predefinita
TLSv1
SSLV2
SSLV3

L'impostazione predefinita dipende dalla configurazione del sistema operativo.

Verifica peer

Per le connessioni HTTPS, il certificato del server web può essere confrontato con un file di certificato memorizzato sul collettore. Abilitare questa opzione per verificare se il certificato SSL del server web è autentico, ovvero se è possibile fidarsi che il server sia effettivamente chi dichiara di essere nel certificato. Se questo campo è abilitato, il file del certificato corretto del server deve essere memorizzato su SKOOR Engine (vedere il parametro successivo "File del certificato"). Il certificato memorizzato viene confrontato con quello emesso dal server quando viene eseguito il processo HTTP.

File del certificato

Visibile solo se il parametro Verifica peer sopra indicato è impostato su Il certificato deve essere autentico. Inserire il nome del file di certificato (ad es. host.crt) con cui viene confrontato il certificato del server. I file di certificato devono essere prima copiati su SKOOR Engine nella directory /opt/eranger/collector/certificates. Il percorso può essere modificato modificando la variabile http_cert_path nel file eranger-collector.cfg.

Verifica host

Visibile solo se il parametro "Verifica peer" sopra indicato è impostato su "Il certificato deve essere autentico". Selezionare "La verifica deve avere esito positivo" per verificare se il nome comune (CN) specificato nel certificato del server web corrisponde all’URL del server.

Intestazione HTTP

Inserire eventuali intestazioni HTTP che SKOOR Engine deve inviare con la richiesta. Ciò è utile soprattutto per modificare la lingua richiesta della pagina web o per cambiare l’user agent con cui SKOOR Engine si identifica presso il server web. L’user agent predefinito è: “SKOOR Engine Monitoring Agent” se tale intestazione non è definita. Il link a Wikipedia proprio accanto al campo di testo dell’intestazione rimanda alla pagina di Wikipedia che descrive tutte le intestazioni HTTP disponibili.

Salva il contenuto su file

Definire un nome file in cui verrà scritto l’output della richiesta.

È possibile utilizzare i tag, ad esempio $DEVICE_ADDRESS$. A seconda del suffisso del nome del file (.txt o .html), il browser visualizzerà la pagina in modo diverso quando si fa clic sul link del file. Specificare un nome file ben definito è utile se l’output verrà analizzato da un successivo processo di analisi del file. Se questo campo viene lasciato vuoto, verrà creato un file di output denominato <http_NNN_NNN.txt>, dove N sono numeri interi generati casualmente al momento della creazione iniziale del processo. Specificare solo il nome del file senza alcuna componente del percorso. Per impostazione predefinita, il file verrà salvato nella directory /var/opt/run/eranger/collector/tmp.

Codice di risposta

Utilizzare il codice di risposta del server web come limite di allarme. I codici di ritorno normalmente accettati sono:

200 OK e 302 Found

Ma è possibile verificare qualsiasi altro valore.

Ecco un elenco dei codici di risposta più comunemente utilizzati:

100 Continue

Ciò significa che il server ha ricevuto le intestazioni della richiesta e che il client deve procedere all'invio del corpo della richiesta (nel caso di una richiesta per la quale è necessario inviare un corpo; ad esempio, una richiesta POST). Se il corpo della richiesta è di grandi dimensioni, inviarlo a un server quando la richiesta è già stata rifiutata a causa di intestazioni inappropriate è inefficiente. Affinché un server verifichi se la richiesta possa essere accettata sulla base delle sole intestazioni della richiesta, un client deve inviare Expect: 100-continue come intestazione nella sua richiesta iniziale e verificare se viene ricevuto un codice di stato 100 Continue in risposta prima di continuare (oppure ricevere 417 Expectation Failed e non continuare).

200 OK

Risposta standard alle richieste HTTP andate a buon fine.

201 Created

La richiesta è stata soddisfatta e ha portato alla creazione di una nuova risorsa.

202 Accettata

La richiesta è stata accettata per l’elaborazione, ma l’elaborazione non è stata completata. La richiesta potrebbe o meno essere eventualmente evasa, poiché potrebbe essere rifiutata quando l’elaborazione avrà effettivamente luogo.

301 Spostato in modo permanente

Questa e tutte le richieste future devono essere indirizzate all’URL specificato

302 Trovato

Questo è il codice di reindirizzamento più diffuso, ma anche un esempio di pratica industriale in contrasto con lo standard. La specifica HTTP/1.0 richiedeva che il client eseguisse un reindirizzamento temporaneo (la frase descrittiva originale era "Spostato temporaneamente"), ma i browser più diffusi lo hanno implementato come 303 Vedi altro. Pertanto, HTTP/1.1 ha aggiunto i codici di stato 303 e 307 per distinguere chiaramente i due comportamenti. Tuttavia, la maggior parte delle applicazioni Web e dei framework utilizza ancora il codice di stato 302 come se fosse il 303.

305 Use Proxy (a partire da HTTP/1.1)

Molti client HTTP (come Mozilla e IE) non gestiscono correttamente le risposte con questo codice di stato, principalmente per motivi di sicurezza.

307 Reindirizzamento temporaneo

In questo caso, la richiesta deve essere ripetuta con un altro URI, ma le richieste future possono comunque utilizzare l’URI originale. A differenza del 303, il metodo di richiesta non deve essere modificato quando si invia nuovamente la richiesta originale. Ad esempio, una richiesta POST deve essere ripetuta utilizzando un’altra richiesta POST.

400 Richiesta non valida

La richiesta presenta una sintassi errata o non può essere soddisfatta.

401 Non autorizzato

Simile al codice 403 "Accesso negato", ma da utilizzare specificatamente quando l’autenticazione è possibile ma non è andata a buon fine o non è stata ancora fornita. 

403 Forbidden

La richiesta era valida, ma il server si rifiuta di rispondere. A differenza di una risposta 401 Non autorizzato, l'autenticazione non farà alcuna differenza.

404 Non trovato  

La risorsa richiesta non è stata trovata.

405 Metodo non consentito

È stata effettuata una richiesta per una risorsa utilizzando un metodo di richiesta non supportato da tale risorsa; ad esempio, utilizzando GET su un modulo che richiede che i dati vengano inviati tramite POST, oppure utilizzando PUT su una risorsa di sola lettura.

406 Non accettabile

407 Autenticazione proxy richiesta

408 Timeout della richiesta

Il client non è riuscito a proseguire la richiesta — tranne durante la riproduzione di video Adobe Flash, dove ciò significa semplicemente che l’utente ha chiuso la finestra del video o è passato a un altro video.

409 Conflitto

410 Non più presente

Indica che la risorsa richiesta non è più disponibile e non lo sarà più. Questo codice dovrebbe essere utilizzato quando una risorsa è stata rimossa intenzionalmente; tuttavia, nella pratica, spesso viene emesso invece un 404 Not Found.

411 Lunghezza richiesta

412 Precondizione non soddisfatta

413 Entità della richiesta troppo grande

414 URI della richiesta troppo lungo

415 Tipo di media non supportato

416 Intervallo richiesto non soddisfacibile

Il client ha richiesto una porzione del file, ma il server non è in grado di fornirla (ad esempio, se il client ha richiesto una parte del file che si trova oltre la fine del file stesso).

417 Errore di aspettativa

421 Ci sono troppe connessioni provenienti dal tuo indirizzo Internet

422 Entità non elaborabile

La richiesta era ben formata ma non è stato possibile eseguirla a causa di errori semantici.

423 Bloccato (WebDAV)

La risorsa a cui si sta tentando di accedere è bloccata

424 Dipendenza non riuscita (WebDAV)

La richiesta non è andata a buon fine a causa del fallimento di una richiesta precedente (ad es. un PROPPATCH).

425 Raccolta non ordinata

Definita nelle bozze delle "WebDAV Advanced Collections", ma non presente nel "Web Distributed Authoring and Versioning (WebDAV) Ordered Collections Protocol".

426 Aggiornamento richiesto

Il client dovrebbe passare a...

449 Riprova con

Un'estensione Microsoft: la richiesta dovrebbe essere ripetuta dopo aver eseguito l'azione appropriata.

500 Errore interno del server

501 Non implementato

502 Gateway non valido

503 Servizio non disponibile

504 Timeout del gateway

505 Versione HTTP non supportata

506 Anche la variante è oggetto di negoziazione

507 Spazio di archiviazione insufficiente

509 Limite di larghezza di banda superato

Questo codice di stato, sebbene utilizzato da molti server, non è un codice di stato HTTP ufficiale.

510 Non esteso

Tempo di connessione

Tempo necessario per stabilire la connessione TCP al server (in ms). L'handshake SSL non viene calcolato.

Tempo di trasferimento

Tempo necessario affinché una pagina web venga servita e la connessione venga chiusa (in ms)

Corrispondenze nel contenuto

Imposta i limiti in base al numero di volte in cui una stringa o un'espressione regolare viene rilevata nel
contenuto della pagina web sottoposta a test

Validità del certificato

Il numero di giorni che mancano alla scadenza del certificato SSL remoto.

Codice di errore

Codice di errore generico del processo (vedere la sezione Codici di errore dei processi)

http://$DEVICE_ADDRESS$

Abilita