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.
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 |
(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. |
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.
{
"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
}
Verifique una sesión de usuario utilizando el token API de usuario y devuelva información adicional sobre el usuario.
{
"jsonrpc": "2.0",
"método": "user.checkAuthentication",
"parámetros": {
"token": "00aff470e07c12d707e50d98cfe39edef9e6ec349c14728dbdfbc8ddc5ea3eae"
},
"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": "1355919338",
"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": "1",
"desaprovisionado": falso,
"tipo_autenticación": 0
},
"identificación": 1
}
CUser::checkAuthentication() en ui/include/classes/api/services/CUser.php.