Autenticação
Use o Atoms Cloud para adicionar autenticação ao seu app, proteger páginas e ações, testar o acesso e visualizar os usuários registrados do app no módulo Usuários.
A autenticação nesta página usa Atoms Cloud. Se o projeto não estiver conectado, peça ao Agente para conectar o Atoms Cloud ou siga Atoms Cloud antes de continuar.
Como a autenticação funciona no Atoms Cloud
O Atoms Cloud gerencia as contas de usuário e as sessões do seu app. O Agente cria a experiência de cadastro e login e a conecta ao Atoms Cloud.
Você pode pedir ao Agente para proteger páginas ou ações específicas e criar diferentes funções ou níveis de acesso. Por exemplo, todos os usuários conectados podem visualizar um painel, enquanto apenas administradores podem acessar uma página de administração.
Os usuários do app são diferentes dos colaboradores do projeto. Atoms Cloud → Users lista as pessoas que se registraram no seu app. Ele não mostra os colegas de equipe que estão criando o projeto no Atoms. Para obter ajuda com sua própria conta do Atoms, consulte Managing Your Account.
Configure a autenticação com o Agente
No chat do projeto, descreva como você quer que toda a jornada de autenticação funcione. Inclua:
- Como os usuários devem criar uma conta e fazer login.
- Todos os métodos de login que você deseja oferecer.
- Quais páginas ou ações devem exigir que os usuários façam login.
- Se o seu app precisa de diferentes funções ou níveis de acesso.
O Atoms Cloud oferece suporte à criação de contas, login, permissões e sessões de usuário. Você pode usar autenticação por e-mail e senha. Se precisar de login com Google, solicite isso explicitamente e teste o fluxo concluído.
O Agente projeta a interface de autenticação para combinar com o seu app, então a aparência pode variar. Concentre-se em verificar se os métodos de login solicitados, as páginas protegidas, as funções e as regras de acesso funcionam corretamente.
Quando o Agente terminar:
- Teste a jornada completa no Visualizador de App.
- Crie uma conta de teste e confirme que o login funciona.
- Verifique se as páginas e ações protegidas têm as regras de acesso corretas.
- Abra Atoms Cloud → Users e confirme que a nova conta aparece.
Teste a autenticação do Atoms Cloud
Para testes de rotina, use o ambiente Development no Visualizador de App. Use Production apenas quando estiver testando intencionalmente o fluxo ao vivo. Antes de criar uma conta, confirme o ambiente e a URL selecionados. Use contas de teste dedicadas; nunca use informações reais de clientes nem reutilize uma senha pessoal. Se o seu app tiver várias funções, crie pelo menos uma conta para cada função.
Use as verificações abaixo para testar a jornada completa de autenticação:
| Teste | O que fazer | Resultado esperado |
|---|---|---|
| Acesso sem login | Saia da conta e depois tente visitar uma página ou usar um recurso que deve exigir autenticação. Teste tanto a jornada normal do usuário quanto a URL direta da página. | O app solicita que o usuário faça login e não exibe nenhum conteúdo protegido. |
| Criação de conta | Crie uma nova conta de teste usando cada método de cadastro disponível no app. | A conta é criada com sucesso e aparece em Atoms Cloud → Users. |
| Login | Saia da conta de teste e depois faça login novamente usando cada método disponível. | O usuário faz login e é levado para a página correta. |
| Estado de carregamento | Envie o formulário de cadastro ou login e observe o app enquanto a solicitação está sendo processada. | O app mostra que a solicitação está em andamento e impede envios repetidos sem revelar conteúdo protegido. |
| Dados incorretos | Tente fazer login usando um endereço de e-mail ou senha incorretos. | O app exibe um erro claro, mantém o conteúdo protegido oculto e permite que o usuário tente novamente. |
| Sessão ativa | Faça login, use o app e depois recarregue-o ou abra-o novamente. | O usuário permanece conectado pelo tempo que a sessão deve permanecer ativa. |
| Funções e permissões | Faça login com uma conta de cada função. Tente acessar páginas e ações permitidas e restritas. | Cada conta pode acessar apenas o conteúdo e as ações permitidos para sua função. |
| Logout e expiração da sessão | Saia da conta e depois tente voltar para áreas protegidas. Repita a verificação após permitir que uma sessão expire, se aplicável. | O app retorna a um estado seguro sem login e não exibe mais conteúdo protegido. |
Se uma verificação falhar. Confirme o ambiente e o método de login e depois tente novamente com uma conta de teste dedicada. Se a verificação ainda falhar ou a conta estiver ausente, peça ao Agente ou ao seu canal de Suporte aprovado para investigar. Inclua o link do projeto ou do Chat, URL, ambiente, método de login, função, erro exato e teste com falha. Nunca compartilhe senhas, códigos de verificação ou tokens.
Se o seu app incluir login com Google, teste-o em cada URL de Development e Production que seus usuários acessarão. Teste Development primeiro para verificações de rotina; teste Production apenas quando estiver verificando intencionalmente o fluxo ao vivo. O sucesso em uma URL não confirma que o login funciona em outra.
Os usuários de Development e Production são armazenados separadamente. Se o projeto tiver um banco de dados de Production, o painel Users exibirá os usuários de Production. Caso contrário, exibirá os usuários de Development. No momento, você não pode alternar manualmente entre ambientes neste painel. Se uma conta parecer estar ausente, verifique em qual ambiente ela foi criada. Para saber mais sobre os dois ambientes do banco de dados, consulte Banco de Dados.
Visualize usuários registrados no Atoms Cloud
- Abra o projeto em um dispositivo desktop.
- Na mesma barra de ferramentas do espaço de trabalho onde está o Visualizador de App, selecione Atoms Cloud.
- Selecione Users na barra lateral do Atoms Cloud.
- Em User Management, revise a lista ou use Search by name, email or UID para encontrar um usuário de teste específico.
Para projetos que usam autenticação do Atoms Cloud, a tabela Users mostra UID, Email, User Information, Role, Created e Last Updated. Use o campo de busca para encontrar um usuário por nome, e-mail ou UID.
O módulo Users permite visualizar e pesquisar as contas registradas no seu app. Ele não gerencia configurações de autenticação nem acesso de usuários. Você não pode usá-lo para:
- Configurar métodos de login ou regras de acesso.
- Convidar, excluir, desativar ou desconectar usuários.
- Redefinir senhas ou alterar funções de usuários.
Para fazer alterações na autenticação, diga ao Agente o que você quer mudar e depois teste a experiência atualizada no seu app.