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 de usuario.

Valor por defecto: "true".
Establecer el valor a "false" permite comprobar la sesión de 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

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

Además de las propiedades estándar del usuario, se devuelve la siguiente información.

Propiedad Tipo Descripción
auth_type integer Autenticación predeterminada para el usuario.

Consulte la propiedad authentication_type del objeto Authentication para ver una lista de valores posibles.
debug_mode integer Indica si el modo de depuración está habilitado o deshabilitado para el usuario.

Consulte la propiedad debug_mode del objeto User group para ver una lista de valores posibles.
deprovisioned boolean Indica si el usuario pertenece a un grupo de usuarios desprovisionados.
gui_access string Método de autenticación del usuario en el frontend.

Consulte la propiedad gui_access del objeto User group para ver una lista de valores posibles.
secret string 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 comprueba utilizando un token de API.
sessionid string Token de autenticación, que debe utilizarse en las siguientes solicitudes de API.

La propiedad sessionid no se devuelve si la sesión del usuario se comprueba utilizando un token de API.
type integer Tipo de usuario.

Consulte la propiedad type del objeto Role para ver una lista de valores posibles.
userip string 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.

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",
        "debug_mode": 0,
        "deprovisioned": false,
        "gui_access": "1",
        "mfaid": 0,
        "auth_type": 0,
        "type": 3,
        "userip": "127.0.0.1"
    },
    "id": 1
}

Fuente

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