Oggetto scenario web

I seguenti oggetti sono direttamente correlati all'API webcheck.

Scenario web

L'oggetto scenario web ha le seguenti proprietà.

Proprietà Tipo Descrizione
httptestid ID ID dello scenario web.

Comportamento della proprietà:
- sola lettura
- obbligatoria per le operazioni di aggiornamento
hostid ID ID dell'host a cui appartiene lo scenario web.

Comportamento della proprietà:
- costante
- obbligatoria per le operazioni di creazione
name string Nome dello scenario web.

Comportamento della proprietà:
- obbligatoria per le operazioni di creazione
agent string Stringa user agent che verrà utilizzata dallo scenario web.

Predefinito: Zabbix
authentication integer Metodo di autenticazione che verrà utilizzato dallo scenario web.

Valori possibili:
0 - (predefinito) nessuna;
1 - autenticazione HTTP di base;
2 - autenticazione NTLM;
3 - autenticazione Kerberos;
4 - autenticazione Digest.
delay string Intervallo di esecuzione dello scenario web.

Accetta secondi o un'unità di tempo con suffisso (ad es. 30s, 1m, 2h, 1d), oppure una macro utente.

Predefinito: 1m.
headers array Header HTTP che verranno inviati durante l'esecuzione di una richiesta.
http_password string Password utilizzata per l'autenticazione HTTP di base, NTLM, Kerberos o Digest.
http_proxy string proxy che verrà utilizzato dallo scenario web, specificato come http://\[username\[:password\]@\]proxy.example.com\[:port].
http_user string Nome utente utilizzato per l'autenticazione HTTP di base, NTLM, Kerberos o Digest.
retries integer Numero di volte in cui uno scenario web tenterà di eseguire ogni passaggio prima di fallire.

Predefinito: 1.
ssl_cert_file string Nome del file del certificato SSL utilizzato per l'autenticazione del client (deve essere in formato PEM).
ssl_key_file string Nome del file della chiave privata SSL utilizzata per l'autenticazione del client (deve essere in formato PEM).
ssl_key_password string Password della chiave privata SSL.
status integer Indica se lo scenario web è abilitato.

Valori possibili:
0 - (predefinito) abilitato;
1 - disabilitato.
templateid ID ID dello scenario web del template padre.

Comportamento della proprietà:
- sola lettura
variables array Variabili dello scenario web.
verify_host integer Indica se verificare che il nome host della connessione corrisponda a quello presente nel certificato dell'host.

Valori possibili:
0 - (predefinito) salta la verifica dell'host;
1 - verifica host.
verify_peer integer Indica se verificare che il certificato dell'host sia autentico.

Valori possibili:
0 - (predefinito) salta la verifica del peer;
1 - verifica peer.
uuid string Identificatore univoco globale, utilizzato per collegare gli scenari web importati a quelli già esistenti. Generato automaticamente, se non specificato.

Comportamento della proprietà:
- supportata se lo scenario web appartiene a un template

Passo dello scenario

L'oggetto del passo dello scenario definisce un controllo specifico di uno scenario web. Ha le seguenti proprietà.

Property Type Description
name string Nome del passo dello scenario.

Property behavior:
- required
no integer Numero sequenziale del passo in uno scenario web.

Property behavior:
- required
url string URL da controllare.

Property behavior:
- required
follow_redirects integer Indica se seguire i reindirizzamenti HTTP.

Valori possibili:
0 - non seguire i reindirizzamenti;
1 - (default) seguire i reindirizzamenti.
headers array Intestazioni HTTP che verranno inviate durante l'esecuzione di una richiesta. Le intestazioni del passo dello scenario sovrascriveranno le intestazioni specificate per lo scenario web.
posts string/array Variabili HTTP POST come stringa (dati post grezzi) o come array di campi HTTP (dati dei campi del modulo).
required string Testo che deve essere presente nella risposta.
retrieve_mode integer Parte della risposta HTTP che il passo dello scenario deve recuperare.

Valori possibili:
0 - (default) solo il corpo;
1 - solo le intestazioni;
2 - intestazioni e corpo.
status_codes string Intervalli di codici di stato HTTP richiesti, separati da virgole.
timeout string Timeout della richiesta in secondi. Accetta secondi, unità di tempo con suffisso o una macro utente.

Predefinito: 15s. Massimo: 1h. Minimo: 1s.
variables array Variabili del passo dello scenario.
query_fields array Campi di query - array di campi HTTP che verranno aggiunti all'URL durante l'esecuzione di una richiesta.

Campo HTTP

L'oggetto campo HTTP definisce il nome e il valore utilizzati per specificare le variabili dello scenario web, le intestazioni HTTP e i campi POST o i campi di query. Ha le seguenti proprietà.

Property Type Description
name string Nome dell'intestazione/variabile/campo POST o GET.

Property behavior:
- obbligatorio
value string Valore dell'intestazione/variabile/campo POST o GET.

Property behavior:
- obbligatorio

Tag dello scenario web

L'oggetto tag dello scenario web ha le seguenti proprietà.

Property Type Description
tag string Nome del tag dello scenario web.

Property behavior:
- required
value string Valore del tag dello scenario web.