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
- Banco de dados → — regras de segurança em nível de linha
- Agentes e seus dados → — como os agentes respeitam o acesso do usuário
- Gerenciamento de usuários → — login e funções para sua própria equipe