Configurar SSO para un micrositio de impact.com mediante JWT

El micrositio de su programa Advocate normalmente requiere que sus defensores de clientes se registren con un nombre de usuario y una contraseña antes de poder acceder a sus enlaces de compartición y detalles de recompensas. Sin embargo, como alternativa avanzada, puede autenticar a los usuarios generando un Token Web JSON (JWT) del lado del servidor y pasándolo al micrositio mediante un parámetro de URL.

Usando este método, los participantes no tendrán credenciales de inicio de sesión para el micrositio. En su lugar, obtienen acceso iniciando sesión en su portal de clientes existente, que luego los redirige al micrositio usando el JWT para identificarlos y mostrar su contenido personalizado.

Antes de comenzar

Importante: Esta es una implementación avanzada que omite el Servicio de Identidad Administrada estándar para el micrositio y requiere apoyo de su equipo de desarrollo para configurarla.

Solo debe usar este método si se cumplen todos los siguientes casos:

• Quiere simular una experiencia de inicio de sesión único (SSO) iniciando sesión automáticamente a los participantes en el micrositio de su programa.

• Puede generar JWT del lado del servidor.

• No puede o no quiere instalar el Etiqueta Universal de Seguimiento (UTT) en su sitio.

1

Paso 1: Cree un micrositio sin identidad administrada

Cuando cree su micrositio, deberá desactivar el Servicio de Identidad Administrada y luego establecer que todas sus páginas sean accesibles para usuarios "no verificados". La Panel página usará el JWT para autenticar al usuario y cargar el micrositio.

Crear el micrositio

Primero, ajuste la configuración para desactivar el Inicio de sesión de participantes opción.

1. En el menú de navegación izquierdo, seleccione [Engage] → Contenido.

2. En la Micrositio , selecciona Editar configuración.

3. Luego se le redirigirá a su nuevo Configuración del micrositio .

4. Dentro del Inicio de sesión sección, [Desactivar] Inicio de sesión de participantes.

5. Selecciona Guardar configuración.

Configurar la página del panel

A continuación, configure la Panel página de su micrositio para que sea visible para usuarios no verificados. Luego, conecte los componentes de la página con su programa de referidos para que aparezca la información correcta.

1. Ajuste la configuración de la Panel página de su sitio.

   • En el menú de navegación izquierdo, seleccione [Engage] → Contenido → Contenido de configuración o Editar contenido.

   • Desde el Micrositio selecciona Panel en el Diseño de sesión iniciada sección.

   • Selecciona [Menú] → Configuración.

   • Desde el Usuarios permitidos lista desplegable, seleccione No verificado.

2. Añada el ID de su programa a los componentes de la Panel.

   • Estadísticas del usuario — Debe añadir el ID a cada estadística de usuario individual que elija mostrar.

   • Enlace para compartir

   • Código de referidos

   • Botones de redes sociales — Debe añadir el ID a cada botón individual para compartir en redes sociales que elija incluir.

3. En la esquina superior derecha, selecciona Guardar.

   

Para obtener ayuda sobre el uso del editor para encontrar y ajustar la configuración de su página y sus componentes, consulte Explicación del editor de micrositios y Personalizar diseños y páginas del micrositio.

Eliminar páginas innecesarias

Elimine el diseño y las páginas que su micrositio no utilizará.

1. Pase el cursor sobre la página o el diseño.

2. Selecciona [Más] → Eliminar.

3. Eliminar el Diseño de sesión iniciada.

4. Elimine las siguientes páginas:

   • Editar perfil

   • Verificación de correo electrónico

   • Olvidé mi contraseña

   • Inicio de sesión

   • Cerrar sesión

   • Registro

   • Restablecer contraseña

   • Verificar correo electrónico

2

Paso 2: Genere el JWT

La estructura del JWT sigue los requisitos estándar de Advocate para la autenticación de usuarios. Si ha integrado Advocate antes, probablemente ya esté generando tokens similares para UTT.

Debe generar el JWT de forma segura en su servidor o en cualquier sistema backend de confianza; nunca en el navegador.

Aprenda a generar un JWT y los requisitos de la carga útil.

3

Paso 3: Añada el JWT a la URL del micrositio

Una vez que el usuario haya iniciado sesión en su plataforma, rediríjalo al micrositio con el JWT incluido en la cadena de consulta de la URL.

Ejemplo: https://your-microsite.squatch.app/?jwt=<YOUR_GENERATED_JWT>

Puede abrir el micrositio en una nueva pestaña del navegador o incrustarlo en su aplicación mediante un iframe. Si decide incrustar el micrositio, asegúrese de manejar intercambio de recursos de origen cruzado (CORS) y las restricciones del navegador de forma adecuada.

Notas

• Si usa este método de autenticación, los usuarios no tendrán credenciales de inicio de sesión para el micrositio.

• El acceso basado en JWT debe controlarse estrictamente. No lo exponga ni lo manipule en JavaScript del lado del cliente.

• Este es un enfoque no estándar: pruébelo a fondo en su entorno de pruebas antes de lanzar su programa.

• Si necesita soporte, incluya la URL de su micrositio, los detalles de implementación y un ejemplo de carga útil de JWT en su solicitud de soporte.