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

# Configura el SSO para un micrositio de impact.com mediante JWT

El micrositio de tu programa Advocate normalmente requiere que tus clientes promotores se registren con un nombre de usuario y una contraseña antes de que puedan 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, accederán iniciando sesión en tu portal de clientes actual, que luego los redirigirá 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 del micrositio y requiere el apoyo de tu equipo de desarrollo para configurarla.
{% endhint %}

Utiliza este método solo si se cumplen todas las condiciones siguientes:

* Quieres simular una experiencia de inicio de sesión único (SSO) iniciando sesión automáticamente en el micrositio de tu programa para los participantes.
* Puedes generar JWT en el servidor.
* No puedes o no quieres instalar la [etiqueta de seguimiento universal (UTT)](https://help.impact.com/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

Al crear tu micrositio, tendrás que desactivar el servicio de identidad administrada y configurar todas tus páginas para que sean accesibles a usuarios «no verificados». La página *Panel* utilizará el JWT para autenticar al usuario y cargar el micrositio.

<details>

<summary>Crea el micrositio</summary>

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

1. En el menú de navegación de la izquierda, selecciona ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FGgFZ4TpepHNOLrRI2yRk%2Fimage.png?alt=media\&token=5b166f3c-f805-4aaf-b2c4-0f7e11697ec0) **\[Engage]** **→ Contenido**.
2. En la tarjeta *Micrositio* , selecciona **Editar configuración**.
3. Luego se te redirigirá a la nueva página *Configuración del micrositio* .
4. En la sección *Inicio de sesión* , ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FACIoqj1Ayhx8QzL9aqYB%2Ftoggle-off-solid%20\(1\).svg?alt=media\&token=a85366cd-4b70-41a6-83df-319f89597ede) **\[Desactivar]** **Inicio de sesión de participantes**.
5. Selecciona **Guardar configuración**.

</details>

<details>

<summary>Configura la página Panel</summary>

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

1. Ajusta la configuración de la página *Panel* de tu sitio.
   * En el menú de navegación de la izquierda, selecciona ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FGgFZ4TpepHNOLrRI2yRk%2Fimage.png?alt=media\&token=5b166f3c-f805-4aaf-b2c4-0f7e11697ec0) **\[Engage]** **→ Contenido** → **Configurar contenido** o **Editar contenido**.
   * En la pestaña *Micrositio* , selecciona **Panel** en la sección *Diseño con sesión iniciada* .
   * Selecciona ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FNVJihd9nYKCiCEg5tI6i%2F2a92939e8e78dd7e0c0416b1a250d5ef1d7ab0dec966fb5ed320ca62acfc06c5.svg?alt=media\&token=7cab8ce5-a26b-4057-a822-0746130d9117) **\[Menú] → Configuración**.
   * En la lista desplegable *Usuarios permitidos* , selecciona **Sin verificar**.
2. Añade el ID de tu programa a los componentes de *Panel*.
   * Estadísticas de usuarios: debes añadir el ID a cada estadística de usuario individual que quieras mostrar.
   * Enlace para compartir
   * Código de referido
   * Botones de redes sociales: debes añadir el ID a cada botón individual para compartir en redes sociales que quieras incluir.
3. En la esquina superior derecha, selecciona **Guardar**.

   <div data-with-frame="true"><figure><img src="https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FILGfObvnj8KJZ7tCnv1N%2FScreenshot%202026-05-18%20at%2008.35.52.png?alt=media&amp;token=e25b48a9-0ec3-4410-9dc0-feb609d46d34" alt="" width="563"><figcaption></figcaption></figure></div>

Para obtener ayuda sobre cómo usar el editor para encontrar y ajustar la configuración de tus páginas y componentes, consulta [Explicación del editor de micrositios](https://help.impact.com/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 de micrositios](https://help.impact.com/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 las páginas innecesarias</summary>

Elimina el diseño y las páginas que no se usarán en tu micrositio.

1. Coloca el cursor sobre la página o el diseño.
2. Selecciona ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FMLtRUwWz0pujlfmYWOgg%2FMoreVN.svg?alt=media\&token=03a3c355-a347-4207-baf7-c44fadf6d080) **\[Más]** **→ Eliminar**.
3. Elimina el *Diseño con sesión iniciada*.
4. Elimina las siguientes páginas:
   * Editar perfil
   * Verificación de correo electrónico
   * ¿Olvidaste la contraseña?
   * Iniciar sesión
   * Cerrar sesión
   * Registrarse
   * Restablecer contraseña
   * Verificar correo electrónico

</details>
{% endstep %}

{% step %}

#### Paso 2: Generar el JWT

La estructura del JWT sigue los requisitos estándar de Advocate para la autenticación de usuarios. Si ya integraste Advocate, es probable que ya generes tokens similares para UTT.

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

Aprende a [generar un JWT y cuáles son los requisitos de la carga útil](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-tracking-integrations/json-web-tokens-jwts).
{% endstep %}

{% step %}

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

Cuando 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 mediante un iframe. Si decides incrustarlo, asegúrate de gestionar [el uso compartido 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 utilizas 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 con JavaScript del lado del cliente.
* Este método no es estándar: pruébalo exhaustivamente en tu entorno de preparación antes de implementar el programa.
* Si necesitas [asistencia](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 asistencia.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
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>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
