[comment]: # translation:outdated

[comment]: # ({19701d17-19701d17})
# user.login

[comment]: # ({/19701d17-19701d17})

[comment]: # ({605bdb59-c647dda4})
### Опис

`string/object user.login(object parameters)`

Овај метод омогућава да се пријавите на API и генеришете аутентификацију
токен.

::: notewarning
Када користите овај метод, такође морате да урадите
[user.logout](/manual/api/reference/user/logout) да бисте спречили
генерисање великог броја записа отворених седница.
:::

::: noteimportant
Овај метод је доступан само корисницима без аутентификације који не припадају ниједној [корисничкој групи](/manual/api/reference/usergroup/object#user-group) са омогућеном вишефакторском аутентификацијом.
:::

[comment]: # ({/605bdb59-c647dda4})

[comment]: # ({40e0861c-68f0a066})
### Параметри

`(object)` Параметри који садрже корисничко име и лозинку.

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

|Parameter|[Type](/manual/api/reference_commentary#data_types)|Description|
|--|--|------|
|password|string|Корисничка лозинка.<br><br>[Понашање параметра](/manual/api/reference_commentary#parameter-behavior):<br>- *обавезно*|
|username|string|Корисничко име.<br><br>[Понашање параметра](/manual/api/reference_commentary#parameter-behavior):<br>- *обавезно*|
|userData|flag|Враћа информације о аутентификованом кориснику.|

[comment]: # ({/40e0861c-68f0a066})

[comment]: # ({e2a10147-bc924c62})
### Повратне вредности

`(string/object)` Ако се користи параметар `userData`, враћа објекат
који садржи информације о аутентификованом кориснику.

Поред [стандардних корисничких својстава](object#user),
враћају се следеће информације:

|Property|[Type](/manual/api/reference_commentary#data_types)|Description|
|--|--|------|
|auth\_type|integer|Подразумевана аутентикација за корисника.<br><br>Погледајте својство `authentication_type` [Authentication object](/manual/api/reference/authentication/object#authentication-object) за листу могућих вредности.|
|debug\_mode|integer|Да ли је режим за отклањање грешака омогућен или онемогућен за корисника.<br><br>Погледајте својство `debug_mode` [Објекат групе корисника](/manual/api/reference/usergroup/object#user_group) за листу могућих вредности.|
|deprovisioned|boolean|Да ли корисник припада [групи корисника deprovisioned](/manual/web_interface/frontend_sections/users/authentication#configuration).|
|gui\_access|string|Корисников метод аутентификације на корисничком интерфејсу.<br><br>Погледајте својство `gui_access` [Објекат групе корисника](/manual/api/reference/usergroup/object#user_group) за листу могућих вредности.|
|mfaid|integer|ID [MFA метода](/manual/api/reference/mfa/object) који се користи за корисника током пријављивања.<br><br>Враћа "0" ако је MFA онемогућен глобално или за све групе корисника којима корисник припада.|
|secret|string|Насумични низ од 32 карактера. Генерише се приликом пријављивања корисника.|
|sessionid|string|Токен за аутентификацију, који се мора користити у следећим API захтевима.|
|type|integer|Тип корисника.<br><br>Погледајте својство `type` објекта Role object](/manual/api/reference/role/object#role) за листу могућих вредности.|
|userip|string|IP адреса корисника.|

::: notetip
Ако је корисник успешно аутентификован након једног
или више неуспешних покушаја, метода ће вратити тренутне вредности за
својства `attempt_clock`, `attempt_failed` и `attempt_ip` и
затим их ресетујте.
:::

Ако се параметар `userData` не користи, метода враћа токен за потврду идентитета који је неопходан за [authentication](/manual/api#authentication).

[comment]: # ({/e2a10147-bc924c62})

[comment]: # ({b41637d2-b41637d2})
### Примери

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({ce05d68f-46abbe5a})
#### Аутентификација кприсника

Аутентификујте корисника.

[Захтев](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "user.login",
    "params": {
        "username": "Admin",
        "password": "zabbix"
    },
    "id": 1
}
```

Одговор:

```json
{
    "jsonrpc": "2.0",
    "result": "0424bd59b807674191e7d77572075f33",
    "id": 1
}
```

[comment]: # ({/ce05d68f-46abbe5a})

[comment]: # ({d81c0c1a-8448c8ab})
#### Захтевање података о аутентификованом кориснику

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

[Захтев](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "user.login",
    "params": {
        "username": "Admin",
        "password": "zabbix",
        "userData": true
    },
    "id": 1
}
```

Одговор:

```json
{
    "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",
        "type": 3,
        "userip": "127.0.0.1",
        "debug_mode": 0,
        "gui_access": "0",
        "mfaid": "1",
        "deprovisioned": false,
        "auth_type": 0,
        "sessionid": "5b56eee8be445e98f0bd42b435736e42",
        "secret": "cd0ba923319741c6586f3d866423a8f4"
    },
    "id": 1
}
```

[comment]: # ({/d81c0c1a-8448c8ab})

[comment]: # ({22a14fca-22a14fca})
### Погледајте такође

-  [user.logout](logout)

[comment]: # ({/22a14fca-22a14fca})

[comment]: # ({7fd9f53c-7fd9f53c})
### Извор

CUser::login() у *ui/include/classes/api/services/CUser.php*.

[comment]: # ({/7fd9f53c-7fd9f53c})