> 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 de Advocates normalmente exige que seus defensores clientes se cadastrem com um nome de usuário e uma senha antes de poderem acessar os links de compartilhamento e os detalhes das recompensas. No entanto, como alternativa avançada, você pode autenticar os usuários gerando um [JSON Web Token (JWT)](https://en.wikipedia.org/wiki/JSON_Web_Token) no servidor e passando-o ao microsite por meio de um parâmetro de URL.

Com esse método, os participantes não terão credenciais de login para o microsite. Em vez disso, eles terão acesso ao fazer login no portal de clientes existente, que os redirecionará ao 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 ignora o Managed Identity Service padrão do microsite e exige o suporte da sua equipe de desenvolvimento para ser configurada.
{% endhint %}

Use este método somente se todas as condições a seguir forem atendidas:

* Você quer simular uma experiência de logon único (SSO), fazendo com que os participantes acessem automaticamente o microsite do seu programa.
* Você consegue gerar JWTs no servidor.
* Você não pode ou não quer instalar a [Universal Tracking Tag (UTT)](https://help.impact.com/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, você precisará desativar o Managed Identity Service e, em seguida, definir todas as páginas como acessíveis a usuários "não verificados". A página *Dashboard* 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 opção *Participant Login* .

1. No menu de navegação à esquerda, selecione ![](https://526234278-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]** **→ Conteúdo**.
2. No cartão *Microsite* , selecione **Editar configurações**.
3. Você será redirecionado à nova página *Configurações do microsite* .
4. Na seção *Login* , ![](https://526234278-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) **\[Desativar]** **Participant Login**.
5. Selecione **Salvar configurações**.

</details>

<details>

<summary>Configurar a página Dashboard</summary>

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

1. Ajuste as configurações da página *Dashboard* do seu site.
   * No menu de navegação à esquerda, selecione ![](https://526234278-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]** **→ Conteúdo** → **Configurar conteúdo** ou **Editar conteúdo**.
   * Na guia *Microsite* , selecione **Painel** na seção *Layout após o login* .
   * Selecione ![](https://526234278-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) **\[Menu] → Configurações**.
   * Na lista suspensa *Usuários permitidos* , selecione **Não verificado**.
2. Adicione o ID do seu programa aos componentes do *Painel*.
   * Estatísticas do usuário — você precisa 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 redes sociais — você precisa adicionar o ID a cada botão individual de compartilhamento em redes sociais que escolher incluir.
3. No canto superior direito, selecione **Salvar**.

   <div data-with-frame="true"><figure><img src="https://526234278-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 obter ajuda sobre como usar o editor para localizar e ajustar as configurações da página e dos componentes, consulte [Explicação do editor do microsite](https://help.impact.com/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](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/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 não serão usados pelo seu microsite.

1. Passe o cursor sobre a página ou o layout.
2. Selecione ![](https://526234278-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) **\[Mais]** **→ Excluir**.
3. Remova o *Layout após o login*.
4. Remova as seguintes páginas:
   * Editar perfil
   * Verificação de e-mail
   * Esqueci minha senha
   * Login
   * Logout
   * Cadastro
   * Redefinir senha
   * Verificar e-mail

</details>
{% endstep %}

{% step %}

#### Etapa 2: gerar 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á gera tokens semelhantes para o UTT.

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

Saiba como [gerar um JWT e conhecer os requisitos do payload](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-tracking-integrations/json-web-tokens-jwts).
{% endstep %}

{% step %}

#### Etapa 3: adicionar o JWT ao URL do microsite

Depois que o usuário fizer login na sua plataforma, redirecione-o para o microsite com o JWT incluído na string de consulta do 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 ao seu app usando um iframe. Se decidir incorporar o microsite, certifique-se de tratar corretamente [o compartilhamento de recursos entre origens (CORS)](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing) e as restrições do navegador.
{% 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 no lado do cliente.
* Esta é uma abordagem não padrão — teste-a cuidadosamente no seu ambiente de staging antes de implantar o programa.
* Se precisar de [suporte](mailto:saasquatch-support@impact.com), inclua a URL do microsite, os detalhes da implementação e um exemplo de payload 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=<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.
