Пользовательский токен для расчетов
Токен - временный ключ, выдаваемый на время пользователю для работы с системой.
Использование токенов доступа при работе с API
При авторизации пользователя с использованием пароля в ответе возвращается временный токен доступа, используемый в дальнейшем для доступа к API. Выданный токен привязан к пользователю. Проверяя выданный ранее токен, приложение определяет пользователя, выполнившего запрос к API, и его полномочия. При этом не требуется постоянно вводить и передавать логин и пароль. Время жизни токена доступа ограничено коротким интервалом времени, по окончании которого токен более не может быть использован и потребуется повторная процедура авторизации. При активной работе пользователя токен автоматически продляется, что позволяет избежать лишних запросов на ввод пароля. При выходе пользователя из системы токен удаляется и не может быть использован для доступа к API.
При обращении к API токен доступа должен быть передан в заголовке запроса.
Время жизни токена определяется следующими параметрами конфигурации:
token_lifetime- время жизни токена в сек.token_update_time- интервал продления токена
Получение токена
Токен можно получить любому пользователю, если у него есть соответствующее разрешение в роли (разрешение "Редактирование себя"). При этом запуск на расчет самой задачи будет доступен только если у пользователя есть на это разрешения (доступ к расчету и доступ к самой задаче). Подробнее см. Запуск расчета через API.
- Пользователю доступен только один токен единовременно.
- Токен можно просмотреть и скопировать только в момент получения. После этого его можно только удалить.
Если ключ еще не создавался, будет доступно создание нового. Если ключ уже был создан, будет доступно его удаление.
Создание токена
Для создания токена необходимо в профиле пользователя на вкладке "Токен" нажать на кнопку "Создать". При нажатии будет создан токен для запуска задачи на расчет через API.
Важно!
Полученный токен необходимо скопировать и сохранить. Получить тот же токен еще раз нельзя.
Удаление токена
Для удаления токена необходимо нажать на кнопку "Удалить".
Удаление доступно только если токен был ранее создан.
После этого подтвердить действие. Токен будет удален и появится возможность создать новый.