Автоматичний вхід
Автоматичний вхід дає змогу UserJot переносити сеанс користувача, який увійшов у систему, з вашого продукту на публічну дошку відгуків, дорожню карту, журнал змін, Довідковий центр і вбудовані елементи без повторного запиту на вхід.
Віджет може самостійно ідентифікувати користувачів; Автоматичний вхід — це налаштування робочого простору, яке дає змогу входити з цими обліковими даними на ваші публічні сторінки, вбудовані елементи і в Swift SDK.
Увімкнення автоматичного входу
Перейдіть у розділ Налаштування → Вхід.
У розділі Authentication увімкніть параметр Automatic login.
Щоб сеанси перевірялися на сервері, також увімкніть параметр Вимагати підписані токени (він з’явиться після ввімкнення Автоматичного входу).
Для Автоматичного входу потрібен тариф Starter або Professional. На тарифі Free перемикач відображається, але його заблоковано.
Що робить параметр «Вимагати підписані токени»
Звичайний виклик uj.identify виконується у браузері, і відвідувач може його змінити. Якщо ввімкнено параметр Require signed tokens, 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 і вашого актуального секрету проєкту.Переконайтеся, що
issвідповідає вашому ідентифікатору проєкту,audмає значенняuserjot, а значенняiatіexpзадані в секундах Unix ізexp - iat <= 3600(максимальний строк дії — 1 година).Перевірте проміс, який повертає
uj.identify, на наявністьIDENTIFY_FAILED.
Наступні кроки
Створюйте JWT на сервері — див. розділ Підписана ідентичність.
Порівняйте всі способи автентифікації в розділі Ідентифікація користувачів.