# 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 compartición y detalles de recompensas. 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 iniciando 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 apoyo de su equipo de desarrollo para configurarla.
{% endhint %}

Solo debe usar este método si se cumplen todos los siguientes casos:

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

Cuando cree su micrositio, deberá desactivar el Servicio de Identidad Administrada y luego establecer que todas sus páginas sean accesibles para usuarios "no verificados". La *Panel* 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 ![](/files/2490c6c5d0e9f7678051487503c6596a01cd381c) **\[Engage]** **→ Contenido**.
2. En la *Micrositio* , selecciona **Editar configuración**.
3. Luego se le redirigirá a su nuevo *Configuración del micrositio* .
4. Dentro del *Inicio de sesión* sección, ![](/files/0f1119e23ac8b4454d420dab256ff17170f23a06) **\[Desactivar]** **Inicio de sesión de participantes**.
5. Selecciona **Guardar configuración**.

</details>

<details>

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

A continuación, configure la *Panel* 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* página de su sitio.
   * En el menú de navegación izquierdo, seleccione ![](/files/2490c6c5d0e9f7678051487503c6596a01cd381c) **\[Engage]** **→ Contenido** → **Contenido de configuración** o **Editar contenido**.
   * Desde el *Micrositio* selecciona **Panel** en el *Diseño de sesión iniciada* sección.
   * Selecciona ![](/files/05216d04c1834619d774d153fb492bb63248f3ee) **\[Menú] → Configuración**.
   * Desde el *Usuarios permitidos* lista desplegable, seleccione **No verificado**.
2. Añada el ID de su programa a los componentes de la *Panel*.
   * Estadísticas del usuario — Debe añadir el ID a cada estadística de usuario individual que elija mostrar.
   * Enlace para compartir
   * Código de referidos
   * Botones de redes sociales — Debe añadir el ID a cada botón individual para compartir en redes sociales que elija incluir.
3. En la esquina superior derecha, selecciona **Guardar**.

   <div data-with-frame="true"><figure><img src="/files/89b69b175ce4f0947a899134e6a1401e3c5933db" alt=""><figcaption></figcaption></figure></div>

Para obtener ayuda sobre el uso del editor para encontrar y ajustar la configuración de su página y 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 utilizará.

1. Pase el cursor sobre la página o el diseño.
2. Selecciona ![](/files/e623b6985bea839e92dc82c3889750228a7b7af5) **\[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é mi contraseña
   * Inicio de sesión
   * Cerrar sesión
   * Registro
   * Restablecer contraseña
   * Verificar correo electrónico

</details>
{% endstep %}

{% step %}

#### Paso 2: Genere 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.

Aprenda a [generar un JWT y los requisitos de la carga útil](https://integrations.impact.com/impact-brand/docs/json-web-tokens).
{% endstep %}

{% step %}

#### Paso 3: Añada 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=<YOUR_GENERATED_JWT>`
{% endhint %}

Puede abrir el micrositio en una nueva pestaña del navegador o incrustarlo en su aplicación mediante un iframe. Si decide incrustar el micrositio, asegúrese de manejar [intercambio 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 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 pruebas 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 un ejemplo de carga útil de JWT en su solicitud de soporte.


---

# Agent Instructions: 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:

```
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>
```

The question should be specific, self-contained, and written in natural language.
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.
