Автоматичний вхід

Shayan TaslimОновлено

Автоматичний вхід дає змогу UserJot переносити сеанс користувача, який увійшов у систему, з вашого продукту на публічну дошку відгуків, дорожню карту, журнал змін, Довідковий центр і вбудовані елементи без повторного запиту на вхід.

Віджет може самостійно ідентифікувати користувачів; Автоматичний вхід — це налаштування робочого простору, яке дає змогу входити з цими обліковими даними на ваші публічні сторінки, вбудовані елементи і в Swift SDK.

Увімкнення автоматичного входу

  1. Перейдіть у розділ Налаштування → Вхід.

  2. У розділі Authentication увімкніть параметр Automatic login.

  3. Щоб сеанси перевірялися на сервері, також увімкніть параметр Вимагати підписані токени (він з’явиться після ввімкнення Автоматичного входу).

Для Автоматичного входу потрібен тариф Starter або Professional. На тарифі Free перемикач відображається, але його заблоковано.

Що робить параметр «Вимагати підписані токени»

Звичайний виклик uj.identify виконується у браузері, і відвідувач може його змінити. Якщо ввімкнено параметр Require signed tokens, UserJot відхиляє непідписані виклики identify, вимагає включати членство в компаніях у підписаний токен (ігноруючи непідписаний клієнтський companies та виводячи попередження UNSIGNED_COMPANY_IGNORED), а також приймає лише ідентифікатори, підписані на вашому сервері за допомогою JWT HS256 (або підпису HMAC-SHA256 у Swift SDK). Приклади для сервера див. у розділі Підписаний ідентифікатор.

Як це працює

  1. Увімкніть Автоматичний вхід у розділі Налаштування → Вхід.

  2. Установіть віджет у свій продукт.

  3. Викличте uj.identify(...), щойно завантажиться сеанс користувача (передавши підписаний token, якщо потрібно). Передавання email пов’язує користувача з наявним обліковим записом UserJot, лише якщо адресу електронної пошти цього облікового запису підтверджено.

  4. Додайте у своєму застосунку посилання на публічну URL-адресу UserJot (адресу userjot.com або ваш власний домен).

HTML
<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 для вбудованих елементів автоматично використовується той самий механізм обміну.

JavaScript
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.

Наступні кроки

Чи відповіла ця стаття на ваше запитання?