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

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 dashboard, 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 Gerenciando sua conta.

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ê quer 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 email 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 dela pode variar. Concentre-se em verificar se os métodos de login solicitados, páginas protegidas, funções e regras de acesso funcionam corretamente.

Quando o Agente terminar:

1. Teste a jornada completa no Visualizador de App.
2. Crie uma conta de teste e confirme que o login funciona.
3. Verifique se as páginas e ações protegidas têm as regras de acesso corretas.
4. 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 em produção. 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 estar conectado	Saia da conta e depois tente visitar uma página ou usar um recurso que deva 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 email 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 em que a sessão deve permanecer ativa.
Funções e permissões	Faça login com uma conta para cada função. Tente acessar tanto páginas e ações permitidas quanto restritas.	Cada conta pode acessar apenas o conteúdo e as ações permitidos para sua função.
Saída e expiração da sessão	Saia da conta e depois tente retornar às áreas protegidas. Repita a verificação após permitir que uma sessão expire, se aplicável.	O app retorna a um estado seguro de usuário desconectado 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 projeto ou link do Chat, URL, ambiente, método de login, função, erro exato e teste que falhou. 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 em produção. O sucesso com uma URL não confirma que o login funciona com 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 de banco de dados, consulte Banco de Dados.

Visualize usuários registrados no Atoms Cloud

1. Abra o projeto em um dispositivo desktop.
2. Na mesma barra de ferramentas do espaço de trabalho onde está o Visualizador de App , selecione Atoms Cloud.
3. Selecione Users na barra lateral do Atoms Cloud.
4. 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, email 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.