objeto user.checkAuthentication
Este método verifica e prolonga a sessão do usuário.
::: não importante
Chamar o método user.checkAuthentication prolonga a sessão do usuário por padrão. :::
O método aceita os seguintes parâmetros.
Parâmetro | Type | Descrição |
---|---|---|
extend | boolean | Valor padrão: "true". Definir seu valor como "false" permite verificar a sessão sem estender sua vida útil. Suportado desde o Zabbix 4.0. |
sessionid | string | ID da sessão do usuário. |
(object)
Retorna um objeto contendo informações sobre o usuário.
Request:
{ "jsonrpc": "2.0", "method": "user.checkAuthentication", "params": { "sessionid": "673b8ba11562a35da902c66cf5c23fa2" }, "id": 1 }
Response:
{ "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", "type": 3, "sessionid": "673b8ba11562a35da902c66cf5c23fa2" "debug_mode": 0, "userip": "127.0.0.1", "gui_access": 0 }, "id": 1 }
Response is similar to User.login call response with "userData" parameter set to true (the difference is that user data is retrieved by session id and not by username / password).
Check and prolong a user session using the user authentication token, and return additional information about the user.
{ "jsonrpc": "2.0", "method": "user.checkAuthentication", "params": { "sessionid": "673b8ba11562a35da902c66cf5c23fa2" }, "id": 1 }
Response:
{ "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 }
Check a user session using the user API token, and return additional information about the user.
{ "jsonrpc": "2.0", "method": "user.checkAuthentication", "params": { "token": "00aff470e07c12d707e50d98cfe39edef9e6ec349c14728dbdfbc8ddc5ea3eae" }, "id": 1 }
Response:
{ "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 }
CUser::checkAuthentication() in ui/include/classes/api/services/CUser.php.