Se encuentra viendo la documentación de la versión en desarrollo, puede estar incompleta.
Únase a nuestro proyecto de traducción y ayude a traducir la documentación de Zabbix a su lengua materna.

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 booleano Si se debe prolongar la sesión del usuario.

Valor predeterminado: "verdadero".
Establecer el valor en "falso" permite verificar la sesión del usuario sin prolongarla.
<br >Comportamiento de parámetros:
- compatible si se establece sessionid
sessionid cadena Token de autenticación del usuario.

Comportamiento de parámetros:
- obligatorio si token no está configurado
secret cadena Cadena aleatoria de 32 caracteres. Se genera al iniciar sesión el usuario.
token cadena Token de API del usuario.

Comportamiento de parámetros:
- obligatorio si sessionid no está configurado

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 una sesión de usuario utilizando el token de autenticación de usuario y devuelva información adicional sobre el usuario.

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "user.checkAuthentication",
           "params": {
               "sessionid": "673b8ba11562a35da902c66cf5c23fa2"
           },
           "id": 1
       }

Respuesta:

{
           "jsonrpc": "2.0",
           "result": {
               "userid": "1",
               "username": "Admin",
               "name": "Zabbix",
               "surname": "Administrator",
               "url": "",
               "autologin": "1",
               "autologout": "0",
               "lang": "ru_RU",
               "refresh": "0",
               "theme": "default",
               "attempt_failed": "0",
               "attempt_ip": "127.0.0.1",
               "attempt_clock": "1355919038",
               "rows_per_page": "50",
               "timezone": "Europe/Riga",
               "roleid": "3",
               "userdirectoryid": "0",
               "ts_provisioned": "0",
               "type": 3,
               "userip": "127.0.0.1",
               "debug_mode": 0,
               "gui_access": "0",
               "deprovisioned": false,
               "auth_type": 0,
               "sessionid": "673b8ba11562a35da902c66cf5c23fa2",
               "secret": "0e329b933e46984e49a5c1051ecd0751"
           },
           "id": 1
       }
Verificar la autenticación mediante el token API

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

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "user.checkAuthentication",
           "params": {
               "token": "00aff470e07c12d707e50d98cfe39edef9e6ec349c14728dbdfbc8ddc5ea3eae"
           },
           "id": 1
       }

Respuesta:

{
           "jsonrpc": "2.0",
           "result": {
               "userid": "1",
               "username": "Admin",
               "name": "Zabbix",
               "surname": "Administrator",
               "url": "",
               "autologin": "1",
               "autologout": "0",
               "lang": "ru_RU",
               "refresh": "0",
               "theme": "default",
               "attempt_failed": "0",
               "attempt_ip": "127.0.0.1",
               "attempt_clock": "1355919338",
               "rows_per_page": "50",
               "timezone": "Europe/Riga",
               "roleid": "3",
               "userdirectoryid": "0",
               "ts_provisioned": "0",
               "type": 3,
               "userip": "127.0.0.1",
               "debug_mode": 0,
               "gui_access": "1",
               "deprovisioned": false,
               "auth_type": 0
           },
           "id": 1
       }

Fuente

CUser::checkAuthentication() en ui/include/classes/api/services/CUser.php.