# Configurar SSO para um Microsite do impact.com via JWT

O microsite do seu programa Advocate normalmente exige que seus defensores de clientes se cadastrem com um nome de usuário e senha antes de poderem acessar seus links de compartilhamento e detalhes de recompensa. No entanto, como uma alternativa avançada, você pode autenticar os usuários gerando um [JSON Web Token (JWT)](https://en.wikipedia.org/wiki/JSON_Web_Token) no lado do servidor e passando-o para o microsite por meio de um parâmetro de URL.

Usando esse método, os participantes não terão credenciais de login para o microsite. Em vez disso, eles obtêm acesso fazendo login no portal de clientes existente, que então os redireciona para o microsite usando o JWT para identificá-los e exibir seu conteúdo personalizado.

#### Antes de começar

{% hint style="warning" %}
**Importante:** Esta é uma implementação avançada que contorna o Managed Identity Service padrão para o microsite e requer suporte da sua equipe de desenvolvimento para ser configurada.
{% endhint %}

Você deve usar este método somente se todas as condições a seguir se aplicarem:

* Você quer simular uma experiência de single sign-on (SSO) fazendo login automático dos participantes no microsite do seu programa.
* Você pode gerar JWTs no lado do servidor.
* Você não pode ou não quer instalar o [Universal Tracking Tag (UTT)](/brand/pt-br/sobre-o-que-voce-gostaria-de-aprender/platform-features/tracking/javascript-tag-tracking/tracking-with-universal-tracking-tag-utt.md) no seu site.

{% stepper %}
{% step %}

#### Etapa 1: Crie um microsite sem identidade gerenciada

Ao criar seu microsite, você precisará desativar o Managed Identity Service e, em seguida, definir todas as suas páginas para ficarem acessíveis a usuários "não verificados". A *Painel* página usará o JWT para autenticar o usuário e carregar o microsite.

<details>

<summary>Criar o microsite</summary>

Primeiro, ajuste as configurações para desativar a *Entrada de Participante* opção.

1. No menu de navegação à esquerda, selecione ![](/files/09c4b72c9241e7c215aa7515183583a0107746fd) **\[Engajar]** **→ Conteúdo**.
2. No *Microsite* cartão, selecione **Editar configurações**.
3. Em seguida, você será redirecionado para a nova *Configurações do Microsite* .
4. Dentro do *seção de* Login, ![](/files/31ae814d7a1b0e318e06b0e354badc33a8e27e14) **\[Desativar]** **Entrada de Participante**.
5. Selecione **Salvar Configurações**.

</details>

<details>

<summary>Configurar a página do Painel</summary>

Em seguida, configure a *Painel* página do seu microsite para ficar visível para usuários não verificados. Depois, conecte os componentes da página ao seu programa de indicação para que as informações corretas apareçam.

1. Ajuste as configurações da *Painel* página do seu site.
   * No menu de navegação à esquerda, selecione ![](/files/09c4b72c9241e7c215aa7515183583a0107746fd) **\[Engajar]** **→ Conteúdo** → **Configurar conteúdo** ou **Editar conteúdo**.
   * No *Microsite* aba, selecione **Painel** na caixa *Layout de Usuário Logado* .
   * Selecione ![](/files/c3dcc94bb9cd244308d5bd6e9cc311dc83028e53) **\[Menu] → Configurações**.
   * No *Usuários permitidos* lista suspensa, selecione **Não verificado**.
2. Adicione o ID do seu programa aos componentes na *Painel*.
   * Estatísticas do Usuário — Você deve adicionar o ID a cada estatística de usuário individual que escolher exibir.
   * Link de compartilhamento
   * código de indicação
   * Botões de mídia social — Você deve adicionar o ID a cada botão individual de compartilhamento em mídia social que escolher incluir.
3. No canto superior direito, selecione **Salvar**.

   <div data-with-frame="true"><figure><img src="/files/3aa240fb6c61d040472f893df5897554138701af" alt="" width="563"><figcaption></figcaption></figure></div>

Para obter ajuda com o uso do editor para localizar e ajustar as configurações da sua página e dos componentes, consulte [Editor de Microsite Explicado](/brand/pt-br/sobre-o-que-voce-gostaria-de-aprender/advocate-program/manage-advocate-participant-experiences/microsite-experiences/microsite-editor-explained.md) e [Personalizar Layouts e Páginas do Microsite](/brand/pt-br/sobre-o-que-voce-gostaria-de-aprender/advocate-program/manage-advocate-participant-experiences/microsite-experiences/customize-microsite-layouts-and-pages.md).

</details>

<details>

<summary>Remover páginas desnecessárias</summary>

Remova o layout e as páginas que seu microsite não usará.

1. Passe o cursor sobre a página ou o layout.
2. Selecione ![](/files/19661962d7c41673a711ca84d7efe61f00165e41) **\[Mais]** **→ Excluir**.
3. Remova o *Layout de Usuário Logado*.
4. Remova as seguintes páginas:
   * Editar Perfil
   * Verificação de E-mail
   * Esqueci minha Senha
   * seção de
   * Sair
   * Registrar
   * Redefinir Senha
   * Verificar E-mail

</details>
{% endstep %}

{% step %}

#### Etapa 2: Gere o JWT

A estrutura do JWT segue os requisitos padrão do Advocate para autenticação de usuário. Se você já integrou o Advocate antes, provavelmente já está gerando tokens semelhantes para o UTT.

Você deve gerar o JWT com segurança em seu servidor ou em qualquer sistema de backend confiável — nunca no navegador.

Saiba como [gerar um JWT e os requisitos do payload](https://integrations.impact.com/impact-brand/docs/json-web-tokens).
{% endstep %}

{% step %}

#### Etapa 3: Adicione o JWT à URL do microsite

Depois que o usuário estiver logado na sua plataforma, redirecione-o para o microsite com o JWT incluído na string de consulta da URL.

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

Você pode abrir o microsite em uma nova aba do navegador ou incorporá-lo no seu app usando um iframe. Se decidir incorporar o microsite, certifique-se de lidar com [compartilhamento de recursos entre origens (CORS)](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing) e as restrições do navegador de forma adequada.
{% endstep %}
{% endstepper %}

#### Observações

* Se você usar este método de autenticação, os usuários não terão credenciais de login para o microsite.
* O acesso baseado em JWT deve ser rigorosamente controlado. Não o exponha nem o manipule em JavaScript do lado do cliente.
* Esta é uma abordagem não padrão — teste-a minuciosamente em seu ambiente de staging antes de lançar seu programa.
* Se você precisar de [suporte](mailto:saasquatch-support@impact.com), inclua a URL do seu microsite, os detalhes da implementação e um exemplo de payload do JWT na sua solicitação de suporte.


---

# 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/pt-br/sobre-o-que-voce-gostaria-de-aprender/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.
