user.checkAuthentication

Descripción

object user.checkAuthentication

Este método comprueba y prolonga la sesión del usuario.

Llamar al método user.checkAuthentication usando el parámetro sessionid prolonga la sesión del usuario de forma predeterminada.

Parámetros

El método acepta los siguientes parámetros.

Parámetro	Tipo	Descripción
extend	boolean	Si se debe prolongar la sesión del usuario. Valor por defecto: "true". Establecer el valor en "false" permite comprobar la sesión del usuario sin prolongarla. Comportamiento del parámetro: - soportado si se establece `sessionid`
sessionid	string	Token de autenticación del usuario. Comportamiento del parámetro: - obligatorio si no se establece `token`
token	string	Token de API del usuario. Comportamiento del parámetro: - obligatorio si no se establece `sessionid`

Valores de retorno

(objeto) Devuelve un objeto que contiene información sobre el usuario.

Además de las propiedades estándar de [usuario] (object#user), se devuelve la siguiente información.

Propiedad	Tipo	Descripción
auth_type	entero	Autenticación predeterminada para el usuario. Consulte la propiedad `authentication_type` del objeto de autenticación para obtener una lista de valores posibles.
debug_mode	entero	Si el modo de depuración está habilitado o deshabilitado para el usuario. Consulte la propiedad `debug_mode` del objeto de grupo de usuarios para obtener una lista de valores posibles.
deprovisioned	booleano	Si el usuario pertenece a un grupo de usuarios desaprovisionados.
gui_access	stringcadenaMétodo de autenticación del usuario en la interfaz de usuario. Consulte la propiedad `gui_access` del objeto de grupo de usuarios para obtener un lista de valores posibles.
secret	cadena	Cadena aleatoria de 32 caracteres. Se genera al iniciar sesión el usuario. La propiedad `secret` no se devuelve si la sesión del usuario se verifica mediante un token API.
sessionid	cadena	Token de autenticación, que debe usarse en las siguientes solicitudes API. La propiedad `sessionid` no se devuelve si la sesión del usuario se verifica usando un token API.
type	enterio	Tipo de usuario. Consulte la propiedad `type` del objeto de rol para obtener una lista de valores posibles.
userip	cadena	Dirección IP del usuario.

Ejemplos

Verificar la autenticación mediante el token de autenticación

Verifique y prolongue la sesión de un usuario utilizando el token de autenticación de usuario y devuelva información adicional sobre el usuario.

Solicitud:

{
           "jsonrpc": "2.0",
           "método": "user.checkAuthentication",
           "parámetros": {
               "sessionid": "673b8ba11562a35da902c66cf5c23fa2"
           },
           "identificación": 1
       }

Respuesta:

{
           "jsonrpc": "2.0",
           "resultado": {
               "ID de usuario": "1",
               "nombre de usuario": "Administrador",
               "nombre": "Zabbix",
               "apellido": "Administrador",
               "URL": "",
               "autologin": "1",
               "cierre de sesión automático": "0",
               "lang": "ru_RU",
               "actualizar": "0",
               "tema": "predeterminado",
               "intento_fallido": "0",
               "intento_ip": "127.0.0.1",
               "intento_reloj": "1355919038",
               "rows_per_page": "50",
               "timezone": "Europa/Riga",
               "roleid": "3",
               "userdirectoryid": "0",
               "ts_provisioned": "0",
               "tipo": 3,
               "userip": "127.0.0.1",
               "modo_depuración": 0,
               "gui_access": "0",
               "desaprovisionado": falso,
               "tipo_autenticación": 0,
               "sessionid": "673b8ba11562a35da902c66cf5c23fa2",
               "secreto": "0e329b933e46984e49a5c1051ecd0751"
           },
           "identificación": 1
       }

Comprobar la autenticación utilizando el token de la API

Compruebe una sesión de usuario utilizando el token de la API de usuario y devuelva información adicional sobre el usuario.