> 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 su programa Advocate normalmente requiere que sus defensores de clientes se registren con un nombre de usuario y una contraseña antes de poder acceder a sus enlaces de compartir y detalles de recompensa. Sin embargo, como alternativa avanzada, puede 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.

Usando 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 su 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 su equipo de desarrollo para configurarla.
{% endhint %}

Solo debe usar este método si se aplican todas las siguientes condiciones:

* Quiere simular una experiencia de inicio de sesión único (SSO) iniciando sesión automáticamente a los participantes en el micrositio de su programa.
* Puede generar JWT del lado del servidor.
* No puede o no quiere 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 su sitio.

{% stepper %}
{% step %}

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

Cuando cree su micrositio, deberá desactivar el Servicio de identidad administrada y luego configurar todas sus 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, ajuste 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 será redirigido a su nuevo *Configuración del micrositio* página.
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, configure la *Panel de control* página de su micrositio para que sea visible para usuarios no verificados. Luego, conecte los componentes de la página con su programa de referidos para que aparezca la información correcta.

1. Ajuste la configuración de la *Panel de control* página de su sitio.
   * 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, seleccione **No verificado**.
2. Agregue el ID de su programa a los componentes de la *Panel de control*.
   * Estadísticas de usuario — Debe agregar el ID a cada estadística individual de usuario que elija mostrar.
   * Enlace para compartir
   * Código de referido
   * Botones de redes sociales — Debe agregar el ID a cada botón individual de compartir en redes sociales que elija 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 su página y de sus componentes, consulte [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>

Elimine el diseño y las páginas que su micrositio no vaya a usar.

1. Coloque 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. Elimine las siguientes páginas:
   * Editar perfil
   * Verificación de correo electrónico
   * ¿Olvidó su 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 ha integrado Advocate antes, probablemente ya esté generando tokens similares para UTT.

Debe generar el JWT de forma segura en su 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 su plataforma, rediríjalo al micrositio con el JWT incluido en la cadena de consulta de la URL.

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

Puede abrir el micrositio en una nueva pestaña del navegador o incrustarlo en su aplicación usando un iframe. Si decide incrustar el micrositio, asegúrese 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 usa 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 exponga ni lo manipule en JavaScript del lado del cliente.
* Este es un enfoque no estándar: pruébelo a fondo en su entorno de staging antes de lanzar su programa.
* Si necesita [soporte](mailto:saasquatch-support@impact.com), incluya la URL de su micrositio, los detalles de implementación y una carga útil JWT de ejemplo en su 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.
