> 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/pt-br/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 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 uma senha antes de poderem acessar seus links de compartilhamento e detalhes de recompensas. No entanto, como uma alternativa avançada, você pode autenticar usuários gerando um [JSON Web Token (JWT)](https://en.wikipedia.org/wiki/JSON_Web_Token) no servidor e passá-lo 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 ao entrar no seu 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 do microsite e requer o suporte da sua equipe de desenvolvimento para ser configurada.
{% endhint %}
Você deve usar esse método somente se todos os itens a seguir se aplicarem:
* Você quer simular uma experiência de login único (SSO) fazendo o login dos participantes automaticamente no microsite do seu programa.
* Você pode gerar JWTs no servidor.
* Você não pode ou não quer instalar o [Tag Universal de Rastreamento (UTT)](/brand/pt-br/what-would-you-like-to-learn-about/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, será necessário desativar o Managed Identity Service e definir todas as suas páginas como acessíveis para usuários "não verificados". A *Painel* página usará o JWT para autenticar o usuário e carregar o microsite.
Criar o microsite
Primeiro, ajuste as configurações para desativar o *Login do participante* opção.
1. No menu de navegação à esquerda, selecione  **\[Engage]** **→ Conteúdo**.
2. Na *Microsite* cartão, selecione **Editar configurações**.
3. Em seguida, você será redirecionado para suas novas *Configurações do microsite* .
4. Dentro do *Login* seção, .svg?alt=media\&token=a85366cd-4b70-41a6-83df-319f89597ede) **\[Desativar]** **Login do participante**.
5. Selecione **Salvar configurações**.
Configurar a página do painel
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 sua *Painel* página.
* No menu de navegação à esquerda, selecione  **\[Engage]** **→ Conteúdo** → **Conteúdo de Configuração** ou **Editar conteúdo**.
* A partir do *Microsite* guia, selecione **Painel** em *Layout de usuário logado* seção.
* Selecione  **\[Menu] → Configurações**.
* A partir do *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 individual de usuário 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**.
Para obter ajuda com o uso do editor para encontrar e ajustar as configurações da sua página e dos componentes, consulte [Editor de Microsites Explicado](/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/microsite-experiences/microsite-editor-explained.md) e [Personalizar layouts e páginas do microsite](/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/microsite-experiences/customize-microsite-layouts-and-pages.md).
Remover páginas desnecessárias
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  **\[Mais]** **→ Excluir**.
3. Remova o *Layout de usuário logado*.
4. Remova as seguintes páginas:
* Editar perfil
* Verificação de e-mail
* Esqueci a senha
* Login
* Sair
* Registrar
* Redefinir senha
* Verificar e-mail
{% endstep %}
{% step %}
#### Etapa 2: Gere o JWT
A estrutura do JWT segue os requisitos padrão do Advocate para autenticação de usuários. Se você já integrou o Advocate antes, provavelmente já está gerando tokens semelhantes para UTT.
Você deve gerar o JWT com segurança no seu servidor ou em qualquer sistema backend confiável — nunca no navegador.
Saiba como [gerar um JWT e os requisitos da carga útil](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-tracking-integrations/json-web-tokens-jwts).
{% endstep %}
{% step %}
#### Etapa 3: Acrescente o JWT à URL do microsite
Depois que o usuário estiver conectado à 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=`
{% 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 adequadamente.
{% endstep %}
{% endstepper %}
#### Observações
* Se você usar esse 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 rigidamente controlado. Não o exponha nem o manipule em JavaScript no lado do cliente.
* Esta é uma abordagem não padrão — teste-a completamente em seu ambiente de homologação 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 da carga útil do JWT na sua solicitação de suporte.
---
# 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/pt-br/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=&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.
