Início de sessão automático

Shayan TaslimAtualizado

O início de sessão automático permite ao UserJot manter a sessão iniciada de um utilizador quando este sai do seu produto e acede ao seu quadro público de feedback, roteiro, registo de alterações, Centro de Ajuda e incorporações em linha, sem pedir que inicie sessão novamente.

O widget consegue identificar utilizadores por si só; o início de sessão automático é a definição do espaço de trabalho que permite usar essa identidade para iniciar a sessão dos utilizadores nas suas páginas públicas, incorporações em linha e no Swift SDK.

Ativar o início de sessão automático

  1. Aceda a Definições → Início de sessão.

  2. Em Authentication, ative Automatic login.

  3. Para sessões verificadas pelo servidor, ative também a opção Exigir tokens assinados (aparece quando o início de sessão automático está ativado).

O início de sessão automático requer o plano Starter ou Professional. No plano Free, a opção está visível, mas bloqueada.

O que faz a opção «Exigir tokens assinados»

Uma chamada simples a uj.identify é executada no browser e pode ser editada por um visitante. Com a opção Exigir tokens assinados ativada, o UserJot rejeita chamadas identify não assinadas, exige que as associações a empresas sejam incluídas no token assinado (ignorando companies não assinado do lado do cliente e apresentando um aviso UNSIGNED_COMPANY_IGNORED) e só aceita identidades assinadas no seu servidor com um JWT HS256 (ou uma assinatura HMAC-SHA256 no SDK Swift). Consulte Identidade assinada para ver exemplos do lado do servidor.

Como funciona

  1. Ative o início de sessão automático em Definições → Início de sessão.

  2. Instale o widget no seu produto.

  3. Chame uj.identify(...) assim que a sessão do utilizador for carregada (passando um token assinado, se necessário). A passagem de um email associa-se a uma conta UserJot existente apenas se o endereço de email dessa conta tiver sido confirmado.

  4. Crie uma ligação na sua aplicação para o URL público do UserJot (o endereço userjot.com ou o seu domínio personalizado).

HTML
<a href="https://feedback.example.com/">Give feedback</a>
<a href="https://feedback.example.com/roadmap">Roadmap</a>
<a href="https://feedback.example.com/updates">Updates</a>

O SDK associa a sessão automaticamente quando os utilizadores seguem ligações para o domínio do seu projeto; não precisa de acrescentar tokens aos URLs. As incorporações em linha usam automaticamente o mesmo processo assim que uj.identify é executado.

JavaScript
if (user) {
  uj.identify({ token: user.userJotToken });
} else {
  uj.logout();
}

Limitações

  • Não se aplica a administradores nem proprietários de espaços de trabalho em quadros públicos. O início de sessão automático não inicia sessão dos administradores nem dos proprietários de espaços de trabalho em quadros públicos (teste sempre o início de sessão automático num quadro com uma conta de cliente normal; os membros da equipa iniciam sessão diretamente nos quadros públicos com a respetiva conta UserJot ou através de um redirecionamento SSO). No widget na aplicação, um token uj.identify assinado funciona para administradores e proprietários, sincronizando traits e companies, sem alterar o nome, o avatar e o email geridos no respetivo dashboard.

  • É independente do início de sessão único. O início de sessão automático transfere sessões do widget para páginas públicas a partir da sua aplicação; o início de sessão único substitui o botão Iniciar sessão do quadro por um redirecionamento para a sua própria página de início de sessão.

  • O modo estrito falha de forma segura. Quando a opção Exigir tokens assinados está ativada, a ausência de um token ou um token inválido faz com que uj.identify seja rejeitado com IDENTIFY_FAILED e mantém a sessão do visitante terminada.

Resolução de problemas

O utilizador continua a ver um pedido para iniciar sessão

  • Confirme se o início de sessão automático está ativado em Definições → Início de sessão.

  • Confirme se o SDK do widget está carregado na página onde se encontra a ligação e se uj.identify foi executado antes de clicar na ligação.

  • Confirme se a ligação aponta para o subdomínio userjot.com exato ou para o seu domínio personalizado.

  • Confirme que não está a testar o início de sessão automático em quadros públicos com o email de um administrador ou proprietário de um espaço de trabalho.

Os tokens assinados são obrigatórios, mas o início de sessão continua a falhar

  • Confirme se uj.identify recebe um token assinado com HS256 e com o seu segredo do projeto atual.

  • Confirme se iss corresponde ao seu ID do projeto, se aud é userjot, e se iat e exp estão ambos em segundos Unix com exp - iat <= 3600 (validade máxima de 1 hora).

  • Inspecione a promessa devolvida por uj.identify para verificar IDENTIFY_FAILED.

Próximos passos

Isto respondeu à sua pergunta?