4.8.1.2.1. Логин

Логин можно выполнить либо GET, либо POST запросом.

GET запрос

В случае GET запроса сформируйте URL {host:port}/app-portal/api/login с параметрами:

  • u − логин пользователя

  • p − пароль пользователя

  • l − локаль пользователя (опционально)

Например:

http://localhost:8080/app-portal/api/login?u=admin&p=admin&l=ru
POST запрос

Для выполнения логина через POST необходимо выполнить запрос по адресу {host:port}/app-portal/api/login, при этом в теле запроса передается JSON (заголовок Content-Type имеет значение application/json) или форма (заголовок Content-Type имеет значение application/x-www-form-urlencoded)

Пример формата JSON:

{
  "username" : "admin",
  "password" : "admin",
  "locale" : "en"
}

Пример формы:

username: admin
password: admin
locale: en

В ответ сервис вернет userSessionId в теле ответа и статус 200, либо статус 401, если аутентификация не удалась.

Чтобы иметь возможность входить через REST API, пользователь должен иметь специфическое разрешение cuba.restApi.enabled. Заметьте, что пользователь будет иметь разрешение если ни одна роль явно не отбирает его.