Gerenciamento de usuários - Flutter SDK
Nesta página
Para acessar o Atlas App Services e usar o Atlas Device Sync com o Realm Flutter SDK, você deve primeiro autenticar um usuário com um provedor de autenticação do App Services.
Para mais informações sobre como configurar a Autenticação de App Services, consulte Autenticação de App Services na documentação de Atlas App Services .
Criar e excluir usuários
Para todos os provedores de autenticação que não sejam de autenticação por e-mail/senha, o App Services registra automaticamente um usuário na primeira vez que um usuário se autentica. Ao usar o provedor de autenticação por e-mail/senha , você deve registrar manualmente um usuário. Se um usuário se autenticar por meio de mais de um método, é possível vincular essas identidades de usuário a um único objeto de usuário.
Você também pode excluir usuários. A exclusão de um usuário remove os metadados anexados ao usuário do Atlas App Services, mas não exclui os dados inseridos pelo usuário do backend.
Dica
Requisitos de exclusão de conta Apple
A Apple exige que os aplicativos listados em sua App Store deve dar a qualquer usuário que crie uma conta a opção de excluí-la. Se você usa um método de autenticação em que deve registrar manualmente um usuário, como autenticação de e-mail/senha, ou um que cria automaticamente um usuário, como o Sign-In with Apple, você deve implementar a exclusão da conta de usuário até junho 30, 2022.
Conectar e desconectar usuários
Use um ou mais fornecedores de autenticação para conectar e desconectar usuários do seu aplicativo cliente. Você pode:
Faça login dos usuários com uma conta social existente, como Apple, Facebook ou Google.
Crie novas contas de usuário com o gerenciamento de e-mail/senha do Atlas App Services ou sua própria função personalizada ou o gerenciamento de usuários de JSON web token personalizado.
Habilite usuários anônimos para permitir que os usuários acessem seu App Services App sem persistir os dados do usuário.
Quando tem um usuário conectado, você pode:
Abrir um realm sincronizado com o objeto de configuração do usuário
Executar uma função de backend como o usuário conectado
Alterar o usuário ativo em um aplicativo multiusuário
Remover um usuário do dispositivo
Após o login bem-sucedido, o Flutter SDK armazena as credenciais em cache no dispositivo. Você pode ignorar o fluxo de login e acessar o usuário em cache. Use isso para abrir um domínio ou chamar uma Atlas Function quando o aplicativo for aberto posteriormente.
Objeto de usuário
Atlas App Services gerenciam sessões com tokens de acesso e atualizam tokens. Os SDKs do cliente fornecem a lógica para gerenciar tokens e fornecer solicitações.
O Realm usa tokens de atualização para atualizar automaticamente o token de acesso de um usuário quando ele expira. No entanto, o Realm não atualiza automaticamente o token de atualização. Quando o token de atualização expira, o SDK não pode mais obter um token de acesso atualizado e o dispositivo não pode sincronizar até que o usuário faça logon novamente.
Para mais informações sobre gerenciar sessões de usuário e tokens, consulte Sessões de Usuário na documentação do Atlas App Services .
Alguns fornecedores de autenticação permitem que os desenvolvedores acessem metadados do usuário, como nome completo ou endereço de e-mail. Ao configurar esses campos de metadados no Atlas App Services , você pode ler esses metadados do seu aplicativo cliente.
Para saber mais sobre o objeto de usuário que os App Services fornecem ao Flutter SDK, consulte a seguinte documentação:
Objetos de usuário na documentação do Atlas App Services .
Metadados do usuário na documentação do Flutter SDK .
Usuário na documentação de referência do Flutter SDK .
Ouça as alterações do usuário
Você pode ouvir e React às alterações em uma instância de usuário. Por exemplo, receba notificações quando o estado de um usuário for alterado ou um token de acesso do usuário for atualizado.
Para obter mais informações, consulte Registrar um ouvinte de alteração de instância do usuário.
Usuário de dados personalizado
Você pode associar dados personalizados a um usuário, como um idioma preferido ou fuso horário local, e lê-los no aplicação cliente . Para obter mais informações sobre como trabalhar com dados de usuário personalizados, consulte Dados de usuário personalizados.