Login automático

Shayan TaslimAtualizado

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

  1. Acesse Configurações → Login.

  2. Em Autenticação, ative Login automático.

  3. 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

  1. Ative o Login automático em Configurações → Login.

  2. Instale o widget no seu produto.

  3. Faça a chamada uj.identify(...) assim que a sessão do usuário for carregada (passando um token assinado, se necessário). A passagem de um email vincula a uma conta existente do UserJot somente se o endereço de e-mail dessa conta tiver sido confirmado.

  4. Crie um link do seu app para a URL pública do UserJot (o endereço userjot.com ou 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 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.

JavaScript
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.identify assinado funciona para administradores e proprietários, sincronizando traits e companies e 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.identify seja rejeitado com IDENTIFY_FAILED e 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.identify foi executado antes de clicar no link.

  • Confirme se o link aponta para o subdomínio userjot.com exato 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.identify recebe um token assinado com HS256 e com o 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).

  • Verifique a promessa retornada por uj.identify para identificar IDENTIFY_FAILED.

Próximas etapas

Isso respondeu à sua pergunta?