Login automático
O Login automático permite que o UserJot mantenha a sessão de um usuário conectado ao sair do seu produto e acessar seu quadro público de feedback, roadmap, changelog, Central de Ajuda e incorporações inline, sem solicitar um segundo login.
O widget pode identificar usuários por conta própria; o Login automático é a configuração do workspace que permite usar essa identidade para conectar usuários às suas páginas públicas, incorporações inline e ao Swift SDK.
Ativar o login automático
Acesse Configurações → Login.
Em Autenticação, ative Login automático.
Para sessões verificadas pelo servidor, ative também Exigir tokens assinados (essa opção aparece quando o Login automático está ativado).
O Login automático requer o plano Starter ou Professional. No plano Free, a opção aparece, mas fica bloqueada.
O que a opção Exigir tokens assinados faz
Uma chamada uj.identify simples é executada no navegador e pode ser editada por um visitante. Com Exigir tokens assinados ativado, 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 no lado do cliente e exibindo um aviso UNSIGNED_COMPANY_IGNORED) e aceita apenas identidades assinadas no seu servidor com um JWT HS256 (ou uma assinatura HMAC-SHA256 no SDK Swift). Consulte Identidade assinada para ver exemplos no lado do servidor.
Como funciona
Ative o Login automático em Configurações → Login.
Instale o widget no seu produto.
Faça a chamada
uj.identify(...)assim que a sessão do usuário for carregada (passando umtokenassinado, se necessário). A passagem de umemailvincula a uma conta existente do UserJot somente se o endereço de e-mail dessa conta tiver sido confirmado.Crie um link do seu app para a URL pública do UserJot (o endereço
userjot.comou 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 anexa a sessão automaticamente quando os usuários acessam links para o domínio do seu projeto; não é necessário adicionar tokens às URLs. As incorporações inline usam a mesma troca automaticamente depois 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 do espaço de trabalho em quadros públicos. O login automático não conecta administradores nem proprietários do espaço de trabalho a quadros públicos (sempre teste o login automático no quadro com uma conta de cliente comum; os membros da equipe acessam os quadros públicos diretamente com a conta do UserJot ou por redirecionamento de SSO). Dentro do widget no aplicativo, um token
uj.identifyassinado funciona para administradores e proprietários, sincronizandotraitsecompaniese mantendo inalterados o nome, o avatar e o e-mail gerenciados pelo painel.É diferente do Single sign-on. O Login automático leva as sessões do widget para as páginas públicas a partir do seu app; o Single sign-on substitui o botão Entrar do quadro por um redirecionamento para sua própria página de login.
O modo estrito falha de forma segura. Quando Exigir tokens assinados está ativado, a ausência ou invalidade de um token faz com que
uj.identifyseja rejeitado comIDENTIFY_FAILEDe mantém o visitante desconectado.
Solução de problemas
O usuário ainda vê uma solicitação de login
Confirme que o Login automático está ativado em Configurações → Login.
Confirme que o SDK do widget foi carregado na página que contém o link e que
uj.identifyfoi executado antes de clicar no link.Confirme se o link aponta para o subdomínio
userjot.comexato ou para o seu domínio personalizado.Confirme que você não está testando o login automático em um quadro público com o e-mail de um administrador ou proprietário do espaço de trabalho.
Tokens assinados são obrigatórios, mas o login ainda falha
Confirme se
uj.identifyrecebe umtokenassinado com HS256 e com o Segredo do projeto atual.Confirme se
isscorresponde ao seu ID do projeto, seaudéuserjote seiateexpestão ambos em segundos Unix comexp - iat <= 3600(validade máxima de 1 hora).Verifique a promessa retornada por
uj.identifypara identificarIDENTIFY_FAILED.
Próximas etapas
Gere JWTs no lado do servidor em Identidade assinada.
Compare todas as opções de autenticação em Identificar usuários.