Objeto de escenario web

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

Escenario web

El objeto escenario web tiene las siguientes propiedades.

Propiedad Tipo Descripción
httptestid ID ID del escenario web.

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

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

Comportamiento de la propiedad:
- requerido para operaciones de creación
agent string Cadena de agente de usuario que será utilizada por el escenario web.

Por defecto: Zabbix
authentication integer Método de autenticación que será utilizado por el escenario web.

Valores posibles:
0 - (por defecto) 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 segundos o unidad de tiempo con sufijo (por ejemplo, 30s, 1m, 2h, 1d), o una macro de usuario.

Por defecto: 1m.
headers array Cabeceras HTTP que se enviarán al realizar una solicitud.
http_password string Contraseña utilizada para autenticación HTTP básica, NTLM, Kerberos o Digest.
http_proxy string Proxy que será utilizado por el escenario web dado como http://\[usuario\[:contraseña\]@\]proxy.ejemplo.com\[:puerto].
http_user string Nombre de usuario utilizado para 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 fallar.

Por defecto: 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 - (por defecto) habilitado;
1 - deshabilitado.
templateid ID ID del escenario web de la template padre.

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 para la conexión coincida con el del certificado del host.

Valores posibles:
0 - (por defecto) 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 - (por defecto) omitir la verificación del par;
1 - verificar el par.
uuid string Identificador global único, utilizado para vincular escenarios web importados con los ya existentes. Se genera automáticamente si no se proporciona.

Comportamiento de la propiedad:
- soportado si el escenario web pertenece a una template

Paso del escenario

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

Propiedad Tipo Descripción
name cadena Nombre del paso del escenario.

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

Comportamiento de la propiedad:
- requerido
url cadena URL a verificar.

Comportamiento de la propiedad:
- obligatorio
follow_redirects entero Si se deben seguir los redireccionamientos HTTP.

Valores posibles:
0: no seguir los redireccionamientos;
1: (predeterminado) seguir los redireccionamientos.
headers matriz encabezados HTTP que se enviarán al realizar una solicitud. Los encabezados de los pasos del escenario sobrescribirán los encabezados especificados para el escenario web.
posts cadena/matriz Variables HTTP POST como una cadena (datos de publicación sin procesar) o como una matriz de campos HTTP (datos del campo de formulario).
required cadena Texto que debe estar presente en la respuesta.
retrieve_mode entero Parte de la respuesta HTTP que el paso del escenario debe recuperar.

Valores posibles:
0 - (predeterminado) solo cuerpo;
1 - solo encabezados;< br>2 - encabezados y cuerpo.
status_codes cadena Rangos de códigos de estado HTTP requeridos, separados por comas.
timeout string Tiempo de espera de solicitud en segundos. Acepta segundos, unidad de tiempo con sufijo o una macro de usuario.

Predeterminado: 15 s. Máximo: 1h. Mínimo: 1s.
variables matriz Paso del escenario variables.
query_fields matriz Campos de consulta: conjunto de campos HTTP que se agregarán a la URL al realizar una solicitud.

Campo HTTP

El objeto 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 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 del escenario web tiene las siguientes propiedades.

Propiedad Tipo Descripción
tag cadena Nombre de etiqueta del escenario web.

Comportamiento de la propiedad:
- obligatorio
value cadena Valor de etiqueta de escenario web.