user.checkAuthentication

Опис

object user.checkAuthentication

Овај метод проверава и продужава корисничку сесију.

Позивање методе user.checkAuthentication помоћу параметра sessionid подразумевано продужава корисничку сесију.

Параметри

Метод прихвата следеће параметре.

Parameter Type Description
extend boolean Да ли да се продужи корисничка сесија.

Подразумевана вредност: "true".
Постављање вредности на "false" омогућава да се провери корисничка сесија без њеног продужења.

Понашање параметра:
- подржано ако је подешен sessionid
sessionid string Корисник токен за аутентификацију.

Понашање параметра:
- обавезно ако token није подешен
secret string Насумични низ од 32 карактера. Генерише се приликом пријављивања корисника.
token string Корисник API токен.

Понашање параметра:
- обавезно ако sessionid није подешен

Повратне вредности

(object) Враћа објекат који садржи информације о кориснику.

Поред стандардних корисничких својстава, враћају се следеће информације.

Property Type Description
auth_type integer Подразумевана аутентификација за корисника.

Погледајте својство authentication_type објекта Аутентификациони објекат за слисту могућих вредности.
debug_mode integer Да ли је режим за отклањање грешака омогућен или онемогућен за корисника.

Погледајте својство debug_mode Објекат групе корисника за листу могућих вредности.
deprovisioned boolean Да ли корисник припада депровизионој групи корисника.
gui_access string Корисников метод аутентификације на корисничком интерфејсу.

Погледајте својство gui_access Објекат групе корисника за листу могућих вредности.
secret string Насумични низ од 32 карактера. Генерише се приликом пријављивања корисника.

Својство secret се не враћа ако се корисничка сесија проверава помоћу API токена.
sessionid string Токен за аутентификацију, који се мора користити у следећим API захтевима.

Својство sessionid се не враћа ако се корисничка сесија проверава помоћу API токена.
type integer Тип корисника.

Погледајте својство type објекта Улога објекта за листу могућих вредности.
userip string IP адреса корисника.

Примери

Проверите аутентификацију помоћу токена за аутентификацију

Проверите и продужите корисничку сесију помоћу токена за аутентификацију корисника и вратите додатне информације о кориснику.

Захтев:

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

Одговор:

{
           "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
       }
Проверите аутентификацију користећи API токен

Проверите корисничку сесију користећи API токен и вратите додатне информације о кориснику.

Захтев:

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

Одговор:

{
           "jsonrpc": "2.0",
           "result": {
               "userid": "1",
               "username": "Admin",
               "name": "Zabbix",
               "surname": "Administrador",
               "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": "Europa/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() у ui/include/classes/api/services/CUser.php.