Página inicial do Docs → Desenvolver aplicações → Atlas Device SDKs
Gerenciar usuários - SDK do Node.js.
Nesta página
Ao usar o Atlas App Services para dar suporte à sua aplicação cliente, você obtém acesso a um objeto de usuário. Use os métodos do SDK do Node.js com este objeto de usuário para:
Criar e excluir usuários
Conectar e desconectar usuários
Criar e atualizar dados de usuário personalizados
Leia os metadados do usuário dos provedores de login social
Criar e excluir usuários
Para todos os provedor de autenticação que não sejam a autenticação por e-mail/senha, o App Services cria automaticamente um objeto na primeira vez que um usuário se autentica. 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ê pode excluir objetos de usuário. A exclusão de um objeto de usuário exclui os metadados anexados ao objeto de usuário, 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 por e-mail/senha, ou um método que cria automaticamente um usuário, como o Sign-In with Apple, 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 App Services, ou sua própria função personalizada ou gerenciamento de usuários JWT 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 você tem um usuário conectado, os métodos do SDK permitem:
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
No login bem-sucedido, o Node.js 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 Realm ou chamar uma função após a abertura subsequente do aplicativo.
Sessões de usuário
O 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 obter mais informações sobre o gerenciamento de sessões de usuário e tokens, consulte Sessões de usuário na documentação do App Services.
Ler e atualizar dados de usuário personalizados
Você pode associar dados personalizados a um objeto de usuário, como um idioma preferido ou fuso horário local, e lê-los no aplicativo cliente. Um objeto de usuário tem uma propriedade customData que você pode utilizar para acessar dados de usuário personalizados.
Para criar e atualizar dados de usuário personalizados, você deve acessar seu conjunto de dados do MongoDB diretamente. App Services does not offer a SDK method to create or update this custom user data; it's a read-only property.
Ler metadados do usuário a partir dos provedores de login
Alguns provedor de autenticação permitem que os desenvolvedores acessem os metadados do usuário, como nome completo ou endereço de e-mail. Ao configurar esses campos de metadados no aplicativo App Services, você pode ler esses metadados do seu aplicativo cliente. Um objeto de usuário tem uma propriedade profile que você pode utilizar para acessar os metadados do usuário.