Автоматический вход
Автоматический вход позволяет UserJot переносить сеанс пользователя, уже вошедшего в систему в вашем продукте, на общедоступную доску для отзывов, дорожную карту, журнал изменений, Центр справки и встроенные элементы — без повторного запроса на вход.
Виджет может самостоятельно идентифицировать пользователей; автоматический вход — это настройка рабочего пространства, которая позволяет использовать эту идентификацию для входа пользователей на общедоступные страницы, встроенные элементы и в Swift SDK.
Включение автоматического входа
Откройте Настройки → Вход.
В разделе Аутентификация включите параметр Автоматический вход.
Чтобы проверять сеансы на сервере, также включите параметр Требовать подписанные токены (он появится после включения автоматического входа).
Для автоматического входа необходим тариф Starter или Professional. На бесплатном тарифе переключатель отображается, но недоступен.
Как работает настройка «Требовать подписанные токены»
Обычный вызов uj.identify выполняется в браузере, и посетитель может его изменить. Если включена настройка Требовать подписанные токены, UserJot отклоняет неподписанные вызовы identify, требует включать членство в компаниях в подписанный токен (игнорируя неподписанные вызовы companies на стороне клиента и выводя предупреждение UNSIGNED_COMPANY_IGNORED), а также принимает только идентификаторы, подписанные на вашем сервере с помощью JWT с алгоритмом HS256 (или подписи HMAC-SHA256 в Swift SDK). Примеры для серверной стороны см. в разделе Подписанная идентификация.
Как это работает
Включите Автоматический вход в разделе Настройки → Вход.
Установите виджет в свой продукт.
Вызовите
uj.identify(...), когда загрузится пользовательская сессия (передав подписанныйtoken, если он требуется). Передачаemailсвязывает пользователя с существующей учетной записью UserJot, только если адрес электронной почты этой учетной записи подтвержден.Добавьте в приложение ссылку на общедоступный URL-адрес UserJot — адрес
userjot.comили пользовательский домен.
<a href="https://feedback.example.com/">Give feedback</a>
<a href="https://feedback.example.com/roadmap">Roadmap</a>
<a href="https://feedback.example.com/updates">Updates</a>SDK автоматически добавляет сеанс, когда пользователи переходят по ссылкам на домен вашего проекта; добавлять токены в URL-адреса вручную не нужно. После запуска uj.identify встроенные элементы автоматически используют тот же механизм обмена.
if (user) {
uj.identify({ token: user.userJotToken });
} else {
uj.logout();
}Ограничения
Не применяется к администраторам и владельцам рабочих пространств на общедоступных досках. Автоматический вход не выполняет вход администраторов и владельцев рабочих пространств на общедоступные доски (всегда проверяйте автоматический вход на доску с учетной записью обычного клиента; участники команды входят на общедоступные доски напрямую через свою учетную запись UserJot или посредством перенаправления SSO). В виджете приложения подписанный токен
uj.identifyработает и для администраторов и владельцев: синхронизируютсяtraitsиcompanies, а имя, аватар и адрес электронной почты, управляемые через панель управления, остаются без изменений.Не путайте с единым входом. Автоматический вход переносит сеансы виджета из вашего приложения на общедоступные страницы; единый вход заменяет кнопку Войти на доске перенаправлением на вашу страницу входа.
В строгом режиме доступ по умолчанию запрещен. Если включен параметр Требовать подписанные токены, вызов
uj.identifyс отсутствующим или недействительным токеном отклоняется сIDENTIFY_FAILED, а посетитель остается неавторизованным.
Устранение неполадок
Пользователь по-прежнему видит запрос на вход
Убедитесь, что Автоматический вход включен в разделе Настройки → Вход.
Убедитесь, что SDK виджета загружен на странице со ссылкой и что
uj.identifyбыл вызван до нажатия на нее.Убедитесь, что ссылка ведет на точный адрес вашего поддомена
userjot.comили пользовательского домена.Убедитесь, что вы не проверяете автоматический вход на общедоступную доску с адресом электронной почты администратора или владельца рабочего пространства.
Подписанные токены обязательны, но вход по-прежнему не работает
Убедитесь, что
uj.identifyполучаетtoken, подписанный с помощью HS256 и текущего значения Project secret.Убедитесь, что
issсоответствует вашему Project ID, значениеaudравноuserjot, а значенияiatиexpуказаны в секундах Unix сexp - iat <= 3600(максимальный срок действия — 1 час).Проверьте, какое значение возвращает промис вызова
uj.identifyдляIDENTIFY_FAILED.
Дальнейшие действия
Создавайте JWT на сервере — см. раздел Подписанная идентификация.
Сравните все способы аутентификации в разделе Идентификация пользователей.