Login para usuários do seu aplicativo

Seu aplicativo vem com contas

Os aplicativos desenvolvidos em Kliv têm seus próprios usuários — os clientes, membros ou colegas de equipe de quem usa seu produto. Cada aplicativo recebe um sistema de login completo para esses usuários, integrado desde o início. Você não integra um provedor de autenticação nem gerencia o armazenamento de senhas: descreva quem deve poder fazer login e Kliv cuida do resto.

Uma distinção a ser mantida: esta página é sobre os usuários do seu aplicativo. O login para sua própria equipe — as pessoas que criam o aplicativo com você no Kliv, incluindo qualquer SSO corporativo que sua organização usa — é separado e é abordado em Gerenciamento de usuários.

Métodos de login

Os usuários do seu aplicativo podem fazer login com:

  • E-mail e senha — a conta tradicional com endereço de e-mail verificado
  • Entrar com Google e Entrar com Facebook — login social com um clique com uma conta que eles já possuem
  • Chaves de acesso (WebAuthn) — login sem senha usando a biometria do dispositivo ou uma chave de segurança
  • Autenticação de dois fatores (TOTP) — um código baseado em tempo de um aplicativo autenticador como segunda etapa

Diga ao Kliv, na conversa, quais métodos seu aplicativo deve oferecer. “Permita que os usuários se inscrevam com e-mail ou Google e suportem chaves de acesso” é o suficiente.

Organizações e Funções

Os usuários não precisam ser uma lista simples. Os usuários do seu aplicativo podem pertencer a organizações e, dentro de uma organização, cada usuário tem uma função. Esta é a estrutura natural de produtos para equipes e aplicativos B2B: uma empresa se cadastra, convida seus colaboradores e o que cada pessoa pode fazer depende da sua função. Descreva as funções que você precisa e Kliv as configura.

Login e acesso a dados

O login não é apenas um portão na porta — ele determina o que cada usuário pode alcançar. O acesso aos dados segue as regras de segurança em nível de linha do seu banco de dados, portanto, um usuário conectado lê e grava apenas as linhas permitidas por essas regras. Consulte Banco de dados para saber como funciona a segurança em nível de linha.

O mesmo vale para os agentes. Se seu aplicativo incluir um agente, o estado de login de um usuário abrange o que o agente pode ler em seu nome — um agente que responde à pergunta de um usuário não pode ler linhas que o próprio usuário não conseguiria ver. Veja Agentes e seus dados.

Use suas próprias credenciais do Google ou do Facebook

O login com Google e Facebook funciona de imediato com chaves gerenciadas pelo Kliv, e você não precisa registrar nada no provedor. Usar suas próprias chaves é opcional: com elas, a tela de consentimento do provedor mostra o nome do seu aplicativo em vez do Kliv.

Se você usar suas próprias chaves, registre no provedor um URI de redirecionamento para cada endereço em que os visitantes fazem login:

https://<endereço do seu site>/api/v2/auth/oauth/<provedor>/complete

Por exemplo: https://example.com/api/v2/auth/oauth/google/complete. Você precisa de um por endereço: um para cada domínio personalizado e mais um para o endereço <chave-do-site>.kliv.site do seu site, se os visitantes o usarem. Um endereço www que redireciona para o domínio principal não precisa de nenhum.

Você não precisa montá-los manualmente. Em Configurações do site → Login social → Use suas credenciais OAuth aparecem os URIs exatos do seu site, cada um com um botão de copiar.

Onde adicioná-los:

  • Google: no Google Cloud Console, abra seu cliente OAuth e adicione-os em URIs de redirecionamento autorizados (Authorized redirect URIs). Origens JavaScript autorizadas pode ficar vazio.
  • Facebook: no seu app de desenvolvedor da Meta, abra as configurações do Login do Facebook e adicione-os em URIs de redirecionamento do OAuth válidos (Valid OAuth Redirect URIs).

O login com a Apple aceita apenas chaves gerenciadas pelo Kliv.

O login em endereços de pré-visualização não funciona com suas próprias chaves, então teste no site publicado.

Documentação Relacionada