Это не самая новая версия документации. Для изменения используйте переключатель версий или перейдите на новейшую версию!

Приложения#

Окно Приложения (Applications) используется для управления приложениями и их токенами. Для этого необходимо перейти в соответствующий раздел с помощью панели навигации: Администрирование ‣ Приложения (Administration ‣ Applications).

../../../../_images/applicaions-index.png

Таблица приложений состоит из следующих колонок:

  • флаги для выбора нескольких записей;

  • Название (Name) – ссылка для перехода в окно просмотра сведений о приложении;

  • Организация (Organization) – ссылка для перехода в окно просмотра сведений об организации-владельце;

  • Последнее изменение (Last Modified) – дата и время последнего изменения записи;

  • Действия (Actions) – кнопка перехода в окно редактирования свойств приложения.

Просмотр сведений о приложении#

Для получения подробных сведений о приложении нажмите на ссылку с его названием в таблице приложений.

Окно сведений о приложении состоит из следующих вкладок:

  • Подробности (Details) – общие сведения о приложении.

  • Токены (Tokens) – таблица связанных с приложением токенов.

    Таблица токенов состоит из следующих колонок:

    • флаги для выбора нескольких записей;

    • Название (Name) – ссылка для перехода в окно просмотра сведений о пользователе-владельце токена;

    • Область (Scope) – режим доступа к данным контроллера, предоставляемый токеном;

    • Истекает (Expires) – дата и время истечения срока действия токена.

      Для изменения срока действия токенов измените значение настройки Истечение срока действия токена доступа (Access Token Expiration) в общих параметрах аутентификации.

Создание приложения#

Для создания приложения выполните следующие действия:

  1. В окне Приложения (Applications) нажмите кнопку Добавить (Add).

  2. Заполните форму Создать новое приложение (Create New Application):

    • Название (Name) – должно быть уникальным в рамках организации.

    • Описание (Description) – укажите описание приложения.

    • Организация (Organization) – выберите организацию-владельца.

    • Тип предоставляемых полномочий (Authorization grant type) – выберите тип доступа к контроллеру.

      Поддерживаются следующие значения:

      • Код авторизации (Authorization code);

      • Владелец ресурса с доступом по паролю (Resource owner password-based).

    • URI перенаправления (Redirect URIs) – укажите список разрешенных URI. В качестве разделителя используйте символ пробела.

      Примечание

      Это поле обязательно для заполнения, если в поле Тип предоставляемых полномочий (Authorization grant type) выбрано значение Код авторизации (Authorization code).

    • Тип клиента (Client type) – укажите уровень защищенности приложения, которому предоставляете доступ.

      Поддерживаются следующие значения:

      • Конфиденциальный (Confidential) – приложение имеет механизмы защиты доступа к своим данным;

      • Публичный (Public) – данные приложения публично доступны.

  3. Нажмите кнопку Сохранить (Save).

  4. В открывшемся окне Информация о приложении (Application information) выводятся следующие данные, необходимые для использования приложения:

    • Идентификатор клиента (Client ID);

    • Секретная фраза клиента (Client secret) (только если при создании приложения выбран тип клиента «Конфиденциальный»).

    Важно

    Сохраните показанные значения в надежном месте – после закрытия диалогового окна получить к ним доступ повторно невозможно.

  5. Создайте токены согласно инструкций, приведенных в секции Создание токена.

Удаление приложения#

Опасно

Вместе с приложением удаляются все связанные с ним токены. Для восстановления доступа приложений к контроллеру все токены нужно будет создать заново.

Чтобы удалить приложение, выполните следующие действия:

  1. В таблице приложений нажмите на ссылку с названием удаляемого приложения.

  2. Во вкладке Подробности (Details) нажмите кнопку Удалить (Delete).

  3. Подтвердите удаление.

Удаление токенов приложения#

Предупреждение

При удалении токена использующие его приложения теряют доступ к контроллеру.

Чтобы удалить токен приложения, выполните следующие действия:

  1. В таблице приложений нажмите на ссылку с названием нужного приложения.

  2. Во вкладке Токены (Tokens) включите флаги в строках с удаляемыми токенами.

  3. Нажмите кнопку Удалить (Delete).

  4. Подтвердите удаление.