Visão geral

A verificação de identidade garante que as interações entre você e seus usuários sejam mantidas em sigilo e que um agente mal-intencionado não possa se passar por seus usuários. Em resumo, se você configurar a identificação do usuário e enviar informações críticas para a UserGuiding, deverá configurar e aplicar a verificação de identidade.

Observação: Se você usar a UserGuiding apenas para visitantes do site que não fazem login, não precisará da verificação de identidade. Ele só se aplica a usuários para os quais você tem identificadores como endereço de e-mail ou user_id.

O que é um ataque de personificação de usuário?

Em espaços de trabalho sem verificação de identidade, é possível que um agente mal-intencionado se faça passar por um usuário. Isso significa que um malfeitor pode ver o histórico de conversas de um usuário, aparecer para seus colegas de equipe como esse usuário e induzi-los a realizar ações na conta desse usuário.

Por exemplo, sem a verificação de identidade, alguém pode interagir com os materiais da UserGuiding e falsificar a identidade de outro usuário, fornecendo um identificador conhecido, como endereço de e-mail ou user_id. Isso permite que um invasor se passe por um usuário real para os seus colegas de equipe, dando acesso a interações anteriores e a dados potencialmente confidenciais.

Como a verificação de identidade protege minha conta?

Com a Verificação de Identidade, você gera um hash único de usuário para cada um de seus usuários com base no e-mail ou no user_id e no segredo de verificação de identidade da sua conta. Sua integração irá gerar e enviar esses hashes junto com cada requisição ao UserGuiding, permitindo que a plataforma confie que a solicitação realmente veio de você.

Veja como as requisições do UserGuiding são protegidas contra falsificação quando a Verificação de Identidade está corretamente habilitada no seu workspace.

A Verificação de identidade impede a falsificação de identidade entre usuários no seu espaço de trabalho porque, sem acesso ao seu segredo, um terceiro que tentar falsificar o identificador de um usuário para a UserGuiding não conseguirá enviar à UserGuiding um hash de usuário válido para esse usuário.

Quando a verificação de identidade for aplicada, o container da UserGuiding não carregará nem aceitará solicitações de usuários conectados sem um hash de usuário válido.

A verificação de identidade afeta a experiência do usuário?

Com a verificação de identidade configurada corretamente, não há impacto para seus clientes. Os usuários usarão a UserGuiding normalmente. Não há nenhuma ação extra exigida deles para se autenticarem ou usarem os materiais da UserGuiding.

Por que você não tem um segredo para todas as plataformas?

Criamos um segredo único para cada plataforma para facilitar a rotação de cada uma delas ou a ativação da verificação de identidade em cada plataforma independentemente.

Como faço para gerar um hash único por plataforma quando uso o mesmo backend para todos os usuários?

Você não deve gerar o hash e armazená-lo no seu banco de dados. Em vez disso, deve gerá-lo e enviá-lo dinamicamente ao identificar o usuário para a UserGuiding. Isso significa que, quando você alterar os segredos ou o usuário estiver usando uma plataforma diferente, o hash correto será enviado.

Se você armazenasse o hash e o enviasse, teria que fazer uma regeneração em massa após qualquer alteração no seu segredo, o que criaria atrito.

Como configurar a verificação de identidade?

1. Ative a Verificação de Identidade no Painel

• Acesse a seção de Instalação no seu Painel do UserGuiding.
• Em Identificação de Usuário, clique no botão Ativar Verificação de Identidade.
• Será exibida a chave secreta única do seu workspace. Essa chave é usada para gerar com segurança o hash do usuário (HMAC) para cada usuário logado.

⚠️ Importante: Mantenha sua chave secreta segura. Nunca a armazene no código do frontend ou em qualquer local acessível a terceiros.

1. Gere o user_hash no Seu Servidor]
   
   Para cada usuário logado, você deve gerar um HMAC (Código de Autenticação de Mensagem baseado em Hash) usando sua chave secreta e um identificador único do usuário (como user_id ou e-mail).
   
   Oferecemos suporte para várias linguagens de backend. Você encontrará exemplos para Node.js, Rails, Django, PHP, Go e Java no painel.
   
2. Identifique o Usuário com o user_hash
   
   Ao identificar o usuário para o UserGuiding no seu frontend, inclua o HMAC gerado como user_hash.
   
   
3. Verifique a Instalação
   Depois de adicionar o user_hash na sua chamada de identificação, volte ao painel e clique em Verificar Instalação para confirmar que tudo está configurado corretamente.
   
   Assim que a verificação for concluída com sucesso, a Verificação de Identidade estará ativa e aplicada no seu workspace.
   
   👉 Nota: Os domínios personalizados que você definir para sua Knowledge Base e Product Updates Pages devem ser o mesmo domínio da sua aplicação web, caso você esteja utilizando o método de Verificação de Identidade para controlar o Acesso à sua Base de Conhecimento e Páginas de Atualizações do Produto."