Início de sessão automático
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
Aceda a Definições → Início de sessão.
Em Authentication, ative Automatic login.
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
Ative o início de sessão automático em Definições → Início de sessão.
Instale o widget no seu produto.
Chame
uj.identify(...)assim que a sessão do utilizador for carregada (passando umtokenassinado, se necessário). A passagem de umemailassocia-se a uma conta UserJot existente apenas se o endereço de email dessa conta tiver sido confirmado.Crie uma ligação na sua aplicação para o URL público do UserJot (o endereço
userjot.comou o seu domínio personalizado).
<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.
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.identifyassinado funciona para administradores e proprietários, sincronizandotraitsecompanies, 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.identifyseja rejeitado comIDENTIFY_FAILEDe 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.identifyfoi executado antes de clicar na ligação.Confirme se a ligação aponta para o subdomínio
userjot.comexato 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.identifyrecebe umtokenassinado com HS256 e com o seu segredo do projeto atual.Confirme se
isscorresponde ao seu ID do projeto, seaudéuserjot, e seiateexpestão ambos em segundos Unix comexp - iat <= 3600(validade máxima de 1 hora).Inspecione a promessa devolvida por
uj.identifypara verificarIDENTIFY_FAILED.
Próximos passos
Gere JWTs do lado do servidor em Identidade assinada.
Compare todas as opções de autenticação em Identificar utilizadores.