> 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 los defensores de tus 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, puedes autenticar a los usuarios generando un [JSON Web Token (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 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 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 deberías usar este método si se cumplen todas las condiciones siguientes:

* 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 [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: Crear un micrositio sin identidad administrada

Cuando crees tu micrositio, tendrás que 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 ![](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 *Micrositio* tarjeta, selecciona **Editar configuración**.
3. Luego se te redirigirá a tu nuevo *Configuración del micrositio* .
4. Dentro de la *Inicio de sesión* secció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. Seleccione **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 configuración de la *Panel de control* página.
   * En el menú de navegación izquierdo, seleccione ![](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** → **Contenido de configuración** o **Editar contenido**.
   * Desde el *Micrositio* pestaña, selecciona **Panel de control** en el *Diseño de sesión iniciada* sección.
   * Seleccione ![](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**.
   * Desde el *Usuarios permitidos* lista desplegable, selecciona **No verificado**.
2. Añade el ID de tu programa a los componentes de la *Panel de control*.
   * Estadísticas del usuario — Debes añadir el ID a cada estadística individual de usuario 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="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 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. Pasa el cursor sobre la página o el diseño.
2. Seleccione ![](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. Eliminar el *Diseño de 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: Generar 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ñadir 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 usando un iframe. Si decides incrustar el micrositio, asegúrate de manejar [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 pruebas antes de lanzarlo para 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 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.
