Documentazione

Testare qualsiasi URL RFC (HTTP, HTTPS ecc.)

Codice di risposta, tempo di connessione, tempo di trasferimento, corrispondenza dei contenuti, validità del certificato

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 il nome utente e la password 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

Scegli uno dei seguenti metodi di richiesta:

GET (predefinito)
PUT (Aggiorna)
POST
DELETE

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

Dati

Visibile solo se è stato selezionato 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) (predefinito)
Qualsiasi eccetto Basic
Basic
Digest
Digest con 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, il tempo di configurazione della connessione al proxy è incluso in questa misurazione. Il tempo totale, compreso il download del sito, è più veloce se viene memorizzato nella cache del proxy.

Porta proxy

Numero porta proxy

Nome utente proxy

Inserisci nome utente 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 avviso che indica che la pagina web non è disponibile

Controllo 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 scadenza del certificato

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

Sopprimere il tempo di connessione
Sopprimere 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 loro valori non sono più visibili nella sezione dei valori. Il loro valore non è più disponibile per l'uso nelle specifiche dei limiti di allarme.

Versione SSL/TLS

Scegliere una delle seguenti implementazioni:

Predefinito
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 si può fidarsi che il server sia quello indicato dal certificato. Se questo campo è abilitato, il file di certificato corretto del server deve essere memorizzato su SKOOR Engine (vedere il parametro successivo File di certificato). Il certificato memorizzato viene confrontato con il certificato emesso dal server quando viene eseguito il processo HTTP.

File certificato

Visibile solo se il parametro Verifica peer sopra è impostato su Il certificato deve essere autentico. Immettere il nome del file del certificato (ad esempio host.crt) con cui viene confrontato il certificato del server. I file dei certificati 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 controllare se il nome comune (CN) specificato nel certificato del server web corrisponde all'URL del server.

Intestazione HTTP

Inserisci qualsiasi intestazione 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 al server web. L'user agent predefinito è: "SKOOR Engine Monitoring Agent" se tale intestazione non è definita. Il link Wikipedia proprio accanto al campo di testo dell'intestazione porta alla pagina Wikipedia che descrive tutte le intestazioni HTTP disponibili.

Salva contenuto su file

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

È possibile utilizzare tag, ad esempio $DEVICE_ADDRESS$. A seconda del suffisso del nome del file (.txt o .html), il browser renderà la pagina in modo diverso quando si fa clic sul collegamento al file. Specificare un nome di 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 con il nome <http_NNN_NNN.txt>, dove N sono numeri interi generati casualmente al momento della creazione iniziale del lavoro. Specificare solo il nome del file senza alcun componente del percorso del file. Per impostazione predefinita, verrà memorizzato in /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 Trovato

Ma è possibile controllare qualsiasi altro valore.

Ecco un elenco dei codici di risposta più utilizzati:

100 Continua

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 una richiesta è già stata rifiutata a causa di intestazioni inappropriate è inefficiente. Affinché un server verifichi se la richiesta può essere accettata solo sulla base delle intestazioni della richiesta, un client deve inviare Expect: 100-continue come intestazione nella sua richiesta iniziale e verificare se riceve un codice di stato 100 Continue in risposta prima di continuare (o ricevere 417 Expectation Failed e non continuare).

200 OK

Risposta standard alle richieste HTTP riuscite.

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 essere o meno eseguita, in quanto potrebbe essere rifiutata al momento dell'elaborazione effettiva.

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 contraddizione con lo standard. La specifica HTTP/1.0 richiedeva al client di eseguire un reindirizzamento temporaneo (la frase descrittiva originale era "Spostato temporaneamente"), ma i browser più diffusi lo implementavano come 303 Vedi altro. Pertanto, HTTP/1.1 ha aggiunto i codici di stato 303 e 307 per distinguere i due comportamenti. Tuttavia, la maggior parte delle applicazioni e dei framework Web utilizza ancora il codice di stato 302 come se fosse il 303.

305 Use Proxy (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 riemette la richiesta originale. Ad esempio, una richiesta POST deve essere ripetuta utilizzando un'altra richiesta POST.

400 Richiesta non valida

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

401 Non autorizzato

Simile al codice 403 Forbidden, ma specifico per i casi in cui l'autenticazione è possibile ma non è stata eseguita o non è stata ancora fornita. 

403 Forbidden

La richiesta era legale, ma il server rifiuta di rispondere. A differenza della risposta 401 Non autorizzato, l'autenticazione non fa alcuna differenza.

404 Non trovato  

La risorsa richiesta non è stata trovata.

405 Metodo non consentito

È stata effettuata una richiesta di una risorsa utilizzando un metodo di richiesta non supportato da tale risorsa; ad esempio, utilizzando GET su un modulo che richiede la presentazione dei dati tramite POST o utilizzando PUT su una risorsa di sola lettura.

406 Non accettabile

407 Autenticazione proxy richiesta

408 Timeout della richiesta

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

409 Conflitto

410 Non più disponibile

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 invece emesso un codice 404 Not Found.

411 Lunghezza richiesta

412 Precondizione non soddisfatta

413 Entità richiesta troppo grande

414 URI della richiesta troppo lungo

415 Tipo di media non supportato

416 Intervallo richiesto non soddisfacente

Il client ha richiesto una parte 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).

417 Aspettativa non soddisfatta

421 Ci sono troppe connessioni 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 esempio una PROPPATCH).

425 Raccolta non ordinata

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

426 Aggiornamento richiesto

Il client deve passare a.

449 Riprova con

Un'estensione Microsoft: la richiesta deve essere riprovata dopo aver eseguito l'azione appropriata.

500 Errore interno del server

501 Non implementato

502 Gateway non valido

503 Servizio non disponibile

504 Timeout gateway

505 Versione HTTP non supportata

506 Anche la variante negozia

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 per servire una pagina web e chiudere la connessione (in ms)

Corrispondenze dei contenuti

Imposta i limiti in base al numero di volte in cui una stringa o un'espressione regolare viene trovata nel
contenuto della pagina web testata

Certificato valido

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 del processo)

http://$DEVICE_ADDRESS$

Abilita