Objeto de escenario web

Los siguientes objetos están directamente relacionados con la API webcheck.

Escenario web

El objeto de escenario web tiene las siguientes propiedades.

Property Type Description
httptestid ID ID del escenario web.

Comportamiento de la propiedad:
- solo lectura
- obligatoria para las operaciones de actualización
hostid ID ID del host al que pertenece el escenario web.

Comportamiento de la propiedad:
- constante
- obligatoria para las operaciones de creación
name string Nombre del escenario web.

Comportamiento de la propiedad:
- obligatoria para las operaciones de creación
agent string Cadena del user agent que utilizará el escenario web.

Valor predeterminado: Zabbix
authentication integer Método de autenticación que utilizará el escenario web.

Valores posibles:
0 - (predeterminado) ninguno;
1 - autenticación HTTP básica;
2 - autenticación NTLM;
3 - autenticación Kerberos;
4 - autenticación Digest.
delay string Intervalo de ejecución del escenario web.

Acepta un número de segundos (por ejemplo, 1, 60, 300), un valor con un sufijo de tiempo (por ejemplo, 30s, 1m, 2h, 1d) o una macro de usuario.

Valor predeterminado: 1m.
headers array Encabezados HTTP que se enviarán al realizar una solicitud.
http_password string Contraseña utilizada para la autenticación HTTP básica, NTLM, Kerberos o Digest.
http_proxy string Proxy que utilizará el escenario web, con el formato http://\[username\[:password\]@\]proxy.example.com\[:port].
http_user string Nombre de usuario utilizado para la autenticación HTTP básica, NTLM, Kerberos o Digest.
retries integer Número de veces que un escenario web intentará ejecutar cada paso antes de producir un error.

Valor predeterminado: 1.
ssl_cert_file string Nombre del archivo de certificado SSL utilizado para la autenticación del cliente (debe estar en formato PEM).
ssl_key_file string Nombre del archivo de clave privada SSL utilizado para la autenticación del cliente (debe estar en formato PEM).
ssl_key_password string Contraseña de la clave privada SSL.
status integer Indica si el escenario web está habilitado.

Valores posibles:
0 - (predeterminado) habilitado;
1 - deshabilitado.
templateid ID ID del escenario web del template principal.

Comportamiento de la propiedad:
- solo lectura
variables array Variables del escenario web.
verify_host integer Indica si se debe validar que el nombre del host de la conexión coincida con el del certificado del host.

Valores posibles:
0 - (predeterminado) omitir la verificación del host;
1 - verificar el host.
verify_peer integer Indica si se debe validar que el certificado del host sea auténtico.

Valores posibles:
0 - (predeterminado) omitir la verificación del peer;
1 - verificar el peer.
uuid string Identificador único global, utilizado para vincular escenarios web importados con otros ya existentes. Se genera automáticamente si no se proporciona.

Comportamiento de la propiedad:
- compatible si el escenario web pertenece a un template

Paso del escenario

El objeto de paso del escenario define una comprobación específica del escenario web. Tiene las siguientes propiedades.

Property Type Description
name string Nombre del paso del escenario.

Comportamiento de la propiedad:
- required
no integer Número de secuencia del paso en un escenario web.

Comportamiento de la propiedad:
- required
url string URL que se comprobará.

Comportamiento de la propiedad:
- required
follow_redirects integer Indica si se deben seguir las redirecciones HTTP.

Valores posibles:
0 - no seguir las redirecciones;
1 - (default) seguir las redirecciones.
headers array Encabezados HTTP que se enviarán al realizar una solicitud. Los encabezados del paso del escenario sobrescribirán los encabezados especificados para el escenario web.
posts string/array Variables HTTP POST como una cadena (datos POST sin procesar) o como un array de campos HTTP (datos de campos del formulario).
required string Texto que debe estar presente en la respuesta.
retrieve_mode integer Parte de la respuesta HTTP que debe recuperar el paso del escenario.

Valores posibles:
0 - (default) solo el cuerpo;
1 - solo los encabezados;
2 - encabezados y cuerpo.
status_codes string Rangos de códigos de estado HTTP requeridos, separados por comas.
timeout string Tiempo de espera de la solicitud en segundos. Acepta un número de segundos (por ejemplo, 1, 60, 300), un valor con un sufijo de tiempo (por ejemplo, 30s, 1m, 1h) o una macro de usuario.

Predeterminado: 15s. Máximo: 1h. Mínimo: 1s.
variables array Variables del paso del escenario.
query_fields array Campos de consulta: array de campos HTTP que se añadirán a la URL al realizar una solicitud.

Campo HTTP

El objeto de campo HTTP define el nombre y el valor que se utilizan para especificar las variables del escenario web, las cabeceras HTTP y los campos POST o los campos de consulta. Tiene las siguientes propiedades.

Propiedad Tipo Descripción
name string Nombre de la cabecera/variable/campo POST o GET.

Comportamiento de la propiedad:
- obligatorio
value string Valor de la cabecera/variable/campo POST o GET.

Comportamiento de la propiedad:
- obligatorio

Etiqueta de escenario web

El objeto de etiqueta de escenario web tiene las siguientes propiedades.

Property Type Description
tag string Nombre de la etiqueta del escenario web.

Property behavior:
- required
value string Valor de la etiqueta del escenario web.