Inicio de sesión automático

Shayan TaslimActualizado

El inicio de sesión automático permite que UserJot mantenga la sesión iniciada de un usuario desde tu producto hasta tu tablero público de comentarios, hoja de ruta, registro de cambios, Centro de ayuda e inserciones integradas, sin pedirle que vuelva a iniciar sesión.

El widget puede identificar a los usuarios por sí solo; el inicio de sesión automático es la opción del espacio de trabajo que permite usar esa identidad para iniciar sesión en tus páginas públicas, inserciones integradas y el SDK de Swift.

Activar el inicio de sesión automático

  1. Abre Configuración → Inicio de sesión.

  2. En Autenticación, activa Inicio de sesión automático.

  3. Para sesiones verificadas por el servidor, activa también Exigir tokens firmados (aparece cuando se activa el inicio de sesión automático).

El inicio de sesión automático requiere el plan Starter o Professional. En el plan Free, el interruptor aparece, pero está bloqueado.

Qué hace la opción «Exigir tokens firmados»

Una llamada uj.identify sin firmar se ejecuta en el navegador y un visitante puede modificarla. Con la opción Exigir tokens firmados activada, UserJot rechaza las llamadas identify sin firmar, exige que las membresías de empresa se incluyan en el token firmado (e ignora las llamadas companies del cliente que no estén firmadas, con una advertencia UNSIGNED_COMPANY_IGNORED), y solo acepta identidades firmadas en tu servidor con un JWT HS256 (o una firma HMAC-SHA256 en el SDK de Swift). Consulta Identidad firmada para ver ejemplos del lado del servidor.

Cómo funciona

  1. Activa el inicio de sesión automático en Configuración → Inicio de sesión.

  2. Instala el widget en tu producto.

  3. Llama a uj.identify(...) cuando se cargue la sesión de usuario (y pasa un token firmado, si es necesario). Pasar un email vincula la sesión a una cuenta existente de UserJot solo si se ha confirmado la dirección de correo electrónico de esa cuenta.

  4. Enlaza desde tu aplicación a tu URL pública de UserJot (ya sea tu dirección userjot.com o tu dominio personalizado).

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>

El SDK adjunta la sesión automáticamente cuando los usuarios siguen enlaces al dominio de tu proyecto; no tienes que añadir tokens a las URL. Las inserciones integradas usan el mismo intercambio automáticamente una vez que se ejecuta uj.identify.

JavaScript
if (user) {
  uj.identify({ token: user.userJotToken });
} else {
  uj.logout();
}

Limitaciones

  • No se aplica a los administradores ni a los propietarios del espacio de trabajo en los tableros públicos. El inicio de sesión automático no autentica a los administradores ni a los propietarios del espacio de trabajo en los tableros públicos (prueba siempre el inicio de sesión automático del tablero con una cuenta de cliente habitual; los miembros del equipo inician sesión en los tableros públicos directamente con su cuenta de UserJot o mediante una redirección de SSO). Dentro del widget integrado en la aplicación, un token uj.identify firmado sí funciona para los administradores y los propietarios; sincroniza traits y companies sin modificar el nombre, el avatar ni el correo electrónico que gestionan en el panel.

  • Es independiente del inicio de sesión único. El inicio de sesión automático lleva las sesiones del widget a las páginas públicas desde tu aplicación; el inicio de sesión único reemplaza el botón Iniciar sesión del tablero por una redirección a tu propia página de inicio de sesión.

  • El modo estricto falla de forma segura. Cuando Exigir tokens firmados está activado, si falta un token o no es válido, se rechaza uj.identify con IDENTIFY_FAILED y el visitante queda sin iniciar sesión.

Solución de problemas

El usuario sigue viendo un mensaje para iniciar sesión

  • Confirma que el inicio de sesión automático esté activado en Configuración → Inicio de sesión.

  • Confirma que el SDK del widget esté cargado en la página que contiene el enlace y que uj.identify se haya ejecutado antes de hacer clic en el enlace.

  • Confirma que el enlace apunte exactamente a tu subdominio userjot.com o a tu dominio personalizado.

  • Confirma que no estés probando el inicio de sesión automático en tableros públicos con el correo electrónico de un administrador o propietario del espacio de trabajo.

Se exigen tokens firmados, pero el inicio de sesión sigue fallando

  • Confirma que uj.identify reciba un token firmado con HS256 y el secreto del proyecto actual.

  • Confirma que iss coincida con tu ID del proyecto, que aud sea userjot y que tanto iat como exp sean segundos Unix con exp - iat <= 3600 (duración máxima de 1 hora).

  • Revisa la promesa que devuelve uj.identify para detectar IDENTIFY_FAILED.

Pasos siguientes

¿Respondió esto a tu pregunta?