Токены доступа и пароли приложений

Вашей роли нужно право Персональные токены доступа. Действие «Просмотр» показывает вкладку, «Создание» добавляет кнопку Создать токен, а «Удаление» добавляет кнопку Отозвать. Администратор выдаёт эти права в редакторе ролей, см. Роли и права.

Токен начинается с csd_pat_. Список показывает его первые символы под названием, чтобы вы могли различать свои токены.

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

В поле Срок действия можно выбрать 30 дней (выбрано заранее), 90 дней, 1 год, Без срока действия и Своя дата. Администратор может задать Максимальный срок действия токена доступа от 1 до 3650 дней в разделе Настройки > Общие. Если максимум задан, в поле можно выбрать только варианты, которые в него укладываются; сам максимум добавляется как вариант (например, 45 дней), если ни один другой вариант ему не равен, а Без срока действия убирается.

Вариант Своя дата остаётся доступным и принимает даты не позже максимума. Тогда поле показывает подсказку вроде «Максимум: 45 дн.» Если максимума нет, токен можно создать без срока действия.

CityScreen Deals проверяет максимум только при создании токена. Если снизить его позже, существующие токены остаются как есть.

Для каждого токена список показывает такие колонки.

Токен действует с вашими собственными правами, и CityScreen Deals проверяет их заново при каждом вызове. Поэтому изменение ваших ролей или групп сразу применяется к вашим токенам, и у токена никогда не бывает больше прав, чем у вас. У токенов нет собственных областей доступа.

Токен работает, пока ваша учётная запись активна, ваша организация активна, срок действия токена не истёк и лицензия включает функцию. Смена, сброс или истечение пароля вашей учётной записи не мешает работе токенов.

Отправляйте токен с каждым запросом к REST API по вашему адресу CityScreen Deals в заголовке Authorization: Bearer csd_pat_<your token>.

На отклонённый вызов приходит ответ 401 без указания причины. Откройте вкладку Токены доступа, чтобы увидеть статус токена.

Нажмите Отозвать в строке токена и подтвердите диалог. В нём написано «Отозвать токен „<name>“? Приложения, которые его используют, немедленно потеряют доступ. Это действие нельзя отменить.» Уведомление «Токен отозван» подтверждает отзыв. Истёкший токен остаётся в списке, пока вы его не отзовёте.

Пароль приложения принимается только при входе по LDAP. Веб-приложение, REST API и остальные точки входа его отклоняют.

У пароля приложения нет даты окончания. Он работает, пока вы его не отзовёте или ваша учётная запись не будет отключена.

Сотрудник, у которого включена двухэтапная проверка, может входить по LDAP только с паролем приложения, потому что в LDAP нет шага для кода подтверждения.

То же верно, когда организация требует от вас двухэтапную проверку, а вы ещё её не настроили, и когда пароль вашей учётной записи истёк. Во всех трёх случаях пароль учётной записи при входе по LDAP отклоняется, а пароль приложения продолжает работать. Настройку см. в разделе Двухэтапная проверка.

Смена или сброс пароля вашей учётной записи не мешает работе паролей приложений. Сам вход по LDAP входит в лицензию, и без неё никакая программа не может войти по LDAP, какие бы учётные данные ни использовала.

Вашей роли нужно право Пароли приложений. Действие «Просмотр» показывает вкладку, «Создание» добавляет кнопку Создать пароль приложения, а «Удаление» добавляет кнопку Отозвать.

Пароль приложения создаётся при входе через веб, как и токен.

Список показывает Название с первыми символами пароля под ним, дату Создан и Последнее использование с датой и адресом программы или Не использовался.

Над списком панель Использование в почтовом клиенте подсказывает, что вводить.

Панель показывает Bind DN (имя пользователя) и Базовый DN только сотруднику, чья роль позволяет просматривать потребителей LDAP. Остальные видят текст «Чтобы настроить почтовый клиент, узнайте у администратора адрес LDAP-сервера и bind DN, а в качестве пароля укажите пароль приложения.»

CityScreen может подтвердить адрес сервера для вашей организации. О том, как устроен справочник, см. LDAP-справочник.

Нажмите Отозвать в строке и подтвердите диалог. В нём написано «Отозвать пароль приложения „<name>“? Программа, которая его использует, больше не сможет войти. Это действие нельзя отменить.» Программа сразу перестаёт входить.