> 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 detalles de recompensas. Sin embargo, como alternativa avanzada, puedes autenticar a los usuarios generando un [Token web JSON (JWT)](https://en.wikipedia.org/wiki/JSON_Web_Token) del lado del 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 comenzar

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

Solo deberías usar este método si se cumplen todas las siguientes condiciones:

* 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 del lado del 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 el *Inicio de sesión de participantes* opción.

1. En el menú de navegación izquierdo, seleccione ![](/files/2490c6c5d0e9f7678051487503c6596a01cd381c) **\[Engage]** **→ Contenido**.
2. En la *Micrositio* tarjeta, selecciona **Editar configuración**.
3. Luego se te redirigirá a tu nuevo *Configuración del micrositio* página.
4. Dentro de la *Inicio de sesión* sección, ![](/files/0f1119e23ac8b4454d420dab256ff17170f23a06) **\[Desactivar]** **Inicio de sesión de participantes**.
5. Seleccione **Guardar configuración**.

</details>

<details>

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

A continuación, configura la *Panel de control* página 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 configuración de tu sitio *Panel de control* de la página.
   * En el menú de navegación izquierdo, seleccione ![](/files/2490c6c5d0e9f7678051487503c6596a01cd381c) **\[Engage]** **→ Contenido** → **Contenido de configuración** o **Editar contenido**.
   * En la *Micrositio* pestaña, selecciona **Panel de control** en el *Diseño para usuarios con sesión iniciada* sección.
   * Seleccione ![](/files/05216d04c1834619d774d153fb492bb63248f3ee) **\[Menú] → Configuración**.
   * En la *Usuarios permitidos* lista desplegable, selecciona **No verificados**.
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 para compartir 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>Elimina las páginas innecesarias</summary>

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

1. Pasa el cursor sobre la página o el diseño.
2. Seleccione ![](/files/e623b6985bea839e92dc82c3889750228a7b7af5) **\[Más]** **→ Eliminar**.
3. Elimina el *Diseño para usuarios con sesión iniciada*.
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, es probable que 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.

Aprenda a [generar un JWT y 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ñ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 incrustar el micrositio en tu aplicación mediante un iframe. Si decides incrustar el micrositio, asegúrate de gestionar [la compartición 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 preparación antes de lanzar tu programa.
* Si necesitas [soporte](mailto:saasquatch-support@impact.com), incluye la URL de tu micrositio, los detalles de la implementación y un ejemplo de carga útil 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, and the optional `goal` 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>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
