Configurar SSO para um microsite do impact.com via JWT

O microsite do seu programa Advocate normalmente exige que seus defensores do cliente se cadastrem com um nome de usuário e uma senha antes de conseguirem acessar seus links de compartilhamento e detalhes das recompensas. No entanto, como uma alternativa avançada, você pode autenticar os usuários gerando um Token Web JSON (JWT) no lado do servidor e passando-o ao microsite por meio de um parâmetro na 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 fazer login no seu portal de clientes existente, que então os redireciona para o microsite usando o JWT para identificá-los e exibir o conteúdo personalizado.

Antes de começar

Importante: Essa é uma implementação avançada que contorna o Serviço de Identidade Gerenciada padrão para o microsite e requer o suporte da sua equipe de desenvolvimento para ser configurada.

Você só deve usar este método se todos os itens a seguir se aplicarem:

• Você quer simular uma experiência de login único (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 Tag Universal de Rastreamento (UTT) no seu site.

1

Etapa 1: Criar um microsite sem identidade gerenciada

Ao criar seu microsite, você precisará desativar o Serviço de Identidade Gerenciada 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.

Criar o microsite

Primeiro, ajuste as configurações para desativar o Login do participante .

1. No menu de navegação à esquerda, selecione [Engage] → Conteúdo.
2. Na Microssite cartão, selecione Editar configurações.
3. Em seguida, você será redirecionado para o seu novo Configurações do microsite página.
4. Dentro da Login seção, [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 a տեղեկատվação correta apareça.

1. Ajuste as configurações da Painel página do seu site.

   • No menu de navegação à esquerda, selecione [Engage] → Conteúdo → Conteúdo de configuração ou Editar conteúdo.
   • Na Microssite guia, selecione Painel no Layout para usuários autenticados seção.
   • Selecione [Menu] → Configurações.
   • Na Usuários permitidos lista suspensa, selecione Não verificado.
2. Adicione o ID do seu programa aos componentes da 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 localizar e ajustar as configurações da sua página e dos componentes, consulte Editor do Microsite Explicado e Personalizar layouts e páginas do microsite.

Remover páginas desnecessárias

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

1. Passe o cursor sobre a página ou o layout.
2. Selecione [Mais] → Excluir.
3. Remova o Layout para usuários autenticados.
4. Remova as seguintes páginas:

   • Editar perfil
   • Verificação de e-mail
   • Esqueceu a senha
   • Login
   • Sair
   • Cadastro
   • Redefinir senha
   • Verificar e-mail

2

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á está gerando tokens semelhantes para UTT.

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

Saiba como gerar um JWT e os requisitos da carga útil.

3

Etapa 3: Anexar 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.

Exemplo: https://your-microsite.squatch.app/?jwt=<SEU_JWT_GERADO>

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 lidar com compartilhamento de recursos de origem cruzada (CORS) e as restrições do navegador de forma apropriada.

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 rigidamente controlado. Não o exponha nem o manipule em JavaScript do lado do cliente.
• Essa é uma abordagem não padrão — teste-a minuciosamente no seu ambiente de homologação antes de lançar o seu programa.
• Se você precisar suporte, inclua a URL do seu microsite, os detalhes da implementação e uma amostra da carga útil do JWT na sua solicitação de suporte.