> 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 de compartición y detalles de recompensa. Sin embargo, como alternativa avanzada, puedes autenticar a los usuarios generando un [Token Web JSON (JWT)](https://en.wikipedia.org/wiki/JSON_Web_Token) en el 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, acceden iniciando 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 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:

* Deseas simular una experiencia de inicio de sesión único (SSO) al iniciar 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 la [Etiqueta universal de seguimiento (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* página usará el JWT para autenticar al usuario y cargar el micrositio.

<details>

<summary>Crea el micrositio</summary>

Primero, ajusta la configuración para desactivar la *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, seleccione **Editar configuración**.
3. Luego se te redirigirá a tu nuevo *Configuración del micrositio* página.
4. Dentro del *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* 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* configuración de la página.
   * En el menú de navegación izquierdo, seleccione ![](/files/2490c6c5d0e9f7678051487503c6596a01cd381c) **\[Engage]** **→ Contenido** → **Contenido de configuración** o **Editar contenido**.
   * En el *Micrositio* pestaña, seleccione **Panel** en el *Diseño para usuarios conectados* sección.
   * Seleccione ![](/files/05216d04c1834619d774d153fb492bb63248f3ee) **\[Menú] → Configuración**.
   * En el *Usuarios permitidos* lista desplegable, selecciona **No verificado**.
2. Añade el ID de tu programa a los componentes de la *Panel*.
   * Estadísticas del 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 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 sus 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 conectados*.
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/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 incluyendo el JWT 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 manejar [el uso compartido de recursos de origen cruzado (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 estar estrictamente controlado. 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 pruebas 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 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.
