> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/es/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/microsite-experiences/set-up-sso-for-an-impactcom-microsite-via-jwt.md).

# Configurar SSO para un micrositio de impact.com mediante JWT

El micrositio de tu programa Advocate normalmente requiere que tus defensores de clientes se registren con un nombre de usuario y una contraseña antes de poder acceder a sus enlaces para compartir y a los detalles de sus recompensas. Sin embargo, como alternativa avanzada, puedes autenticar a los usuarios generando un [JSON Web Token (JWT)](https://en.wikipedia.org/wiki/JSON_Web_Token) en el servidor y pasándolo al micrositio mediante un parámetro de URL.

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

#### Antes de empezar

{% hint style="warning" %}
**Importante:** Esta es una implementación avanzada que omite el Servicio de Identidad Administrada estándar para el micrositio y requiere el apoyo de tu equipo de desarrollo para configurarla.
{% endhint %}

Solo debes usar este método si se cumple todo lo siguiente:

* Quieres simular una experiencia de inicio de sesión único (SSO) iniciando sesión automáticamente a los participantes en el micrositio de tu programa.
* Puedes generar JWT en el servidor.
* No puedes o no quieres instalar el [Universal Tracking Tag (UTT)](/brand/es/what-would-you-like-to-learn-about/platform-features/tracking/javascript-tag-tracking/tracking-with-universal-tracking-tag-utt.md) en tu sitio.

{% stepper %}
{% step %}

#### Paso 1: Crea un micrositio sin identidad administrada

Cuando crees tu micrositio, deberás desactivar el Servicio de Identidad Administrada y luego configurar todas tus páginas para que sean accesibles para usuarios "no verificados". La *Panel de control* página usará el JWT para autenticar al usuario y cargar el micrositio.

<details>

<summary>Crear el micrositio</summary>

Primero, ajusta la configuración para desactivar la *Inicio de sesión de participante* .

1. Desde el menú de navegación de la izquierda, selecciona ![](/files/2490c6c5d0e9f7678051487503c6596a01cd381c) **\[Engage]** **→ Contenido**.
2. En la *Microsite* selecciona **Editar configuración**.
3. Luego se te redirigirá a la nueva *Configuración del micrositio* .
4. Dentro de la *Inicio de sesión* sección, ![](/files/0f1119e23ac8b4454d420dab256ff17170f23a06) **\[Desactivar]** **Inicio de sesión de participante**.
5. Selecciona **Guardar configuración**.

</details>

<details>

<summary>Configurar la página del panel</summary>

A continuación, configura la *Panel de control* página de tu micrositio para que sea visible para usuarios no verificados. Luego, conecta los componentes de la página con tu programa de referidos para que aparezca la información correcta.

1. Ajusta la *Panel de control* configuración de página de tu sitio.
   * Desde el menú de navegación de la izquierda, selecciona ![](/files/2490c6c5d0e9f7678051487503c6596a01cd381c) **\[Engage]** **→ Contenido** → **Contenido de configuración** o **Editar contenido**.
   * Desde el *Microsite* selecciona **Panel de control** en el cuadro *Diseño de usuario conectado* .
   * Selecciona ![](/files/05216d04c1834619d774d153fb492bb63248f3ee) **\[Menú] → Configuración**.
   * Desde el *Usuarios permitidos* de la lista desplegable, selecciona **No verificado**.
2. Añade el ID de tu programa a los componentes de la *Panel de control*.
   * Estadísticas de usuario — Debes añadir el ID a cada estadística de usuario individual que elijas mostrar.
   * Enlace para compartir
   * Código de referido
   * Botones de redes sociales — Debes añadir el ID a cada botón individual de compartición en redes sociales que elijas incluir.
3. En la esquina superior derecha, selecciona **Guardar**.

   <div data-with-frame="true"><figure><img src="/files/50437009f1a1acd1af393fc5315e88916da576d7" alt="" width="563"><figcaption></figcaption></figure></div>

Para obtener ayuda sobre cómo usar el editor para encontrar y ajustar la configuración de tu página y de los componentes, consulta [Explicación del editor de micrositios](/brand/es/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/microsite-experiences/microsite-editor-explained.md) y [Personalizar diseños y páginas del micrositio](/brand/es/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/microsite-experiences/customize-microsite-layouts-and-pages.md).

</details>

<details>

<summary>Eliminar páginas innecesarias</summary>

Elimina el diseño y las páginas que tu micrositio no utilizará.

1. Coloca el cursor sobre la página o el diseño.
2. Selecciona ![](/files/e623b6985bea839e92dc82c3889750228a7b7af5) **\[Más]** **→ Eliminar**.
3. Eliminar el *Diseño de usuario conectado*.
4. Elimina 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

</details>
{% endstep %}

{% step %}

#### Paso 2: Genera el JWT

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

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

Aprende a [generar un JWT y los requisitos de la carga útil](https://integrations.impact.com/impact-brand/docs/json-web-tokens).
{% endstep %}

{% step %}

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

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

{% hint style="info" %}
**Ejemplo:** `https://your-microsite.squatch.app/?jwt=<YOUR_GENERATED_JWT>`
{% endhint %}

Puedes abrir el micrositio en una nueva pestaña del navegador o incrustarlo en tu aplicación usando un iframe. Si decides incrustar el micrositio, asegúrate de gestionar [el intercambio de recursos entre orígenes (CORS)](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing) y las restricciones del navegador de forma adecuada.
{% endstep %}
{% endstepper %}

#### Notas

* Si usas 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 expongas ni lo manipules en JavaScript del lado del cliente.
* Este es un enfoque no estándar: pruébalo a fondo en tu entorno de staging antes de lanzar tu programa.
* Si necesitas [soporte](mailto:saasquatch-support@impact.com), incluye la URL de tu micrositio, los detalles de implementación y un ejemplo de la carga útil del JWT en tu solicitud de soporte.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.impact.com/brand/es/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/microsite-experiences/set-up-sso-for-an-impactcom-microsite-via-jwt.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
