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 токен и вратите додатне информације о кориснику.
{
"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.