Criar um usuário do aplicativo

Visão geral

O Atlas App Services fornece vários fornecedores de autenticação para conectar usuários ao seu aplicativo. Para a maioria dos provedores, o App Services cria automaticamente uma conta de usuário na primeira vez que um usuário se autentica por meio do provedor. A única exceção é autenticação de usuário por e-mail/senha, que requer o registro e a confirmação de um usuário antes que ele possa se autenticar.

Identidade

Quando você faz login pela primeira vez com um provedor de autenticação, o App Services cria um objeto de usuário que contém uma ID de identidade exclusiva e metadados específicos do fornecedor sobre o usuário.

Criar um usuário com e-mail/senha

Ao usar a autenticação de usuário por e-mail/senha, você deve primeiro registrar um usuário, o que cria o objeto de usuário. Você pode registrar usuários em seu aplicação cliente usando seu SDK preferido ou pode criar manualmente usuários de e-mail/senha.

Depois de registrar o usuário, você deve confirmá- lo antes que ele possa se autenticar.

appservices users create --type=email

appservices users create --type=email \
  --app=<Your App ID> \
  --email=<User's Email Address> \
  --password=<User's Password>

curl --request POST \
  --header 'Authorization: Bearer <access_token>' \
  --data '{ "email": "<string>", "password": "<string>" }' \
  https://services.cloud.mongodb.com/api/admin/v3.0/groups/<groupId>/apps/<appId>/users

Confirmar um usuário

Você deve confirmar o endereço de e-mail dos novos usuários de e-mail/senha antes que eles tenham permissão para fazer login nos App Services. O método exato de confirmação depende da configuração do seu provedor, mas normalmente envolve um processo de handshake entre o usuário e seu aplicação. Você pode ler mais sobre a confirmação do usuário por e- mail/senha em Confirmação por e-mail/senha.

Às vezes, os usuários não conseguem concluir o processo de confirmação. Por exemplo:

• Um filtro de spam excessivo pode bloquear e-mails de confirmação por e-mail do App Services.

• Um proxy ou bloqueador da Web pode impedir que um usuário ative a função SDK do cliente confirmUser por meio do aplicação do cliente .

• Um erro de implementação pode fazer com que a página de confirmação do usuário do aplicativo cliente falhe em casos de uso específicos.

Para ajudá-lo a contornar casos como este, você pode confirmar usuários usando manualmente a IU dos Serviços de Aplicativo ou a API de Administração:

curl --request POST \
  --header 'Authorization: Bearer <access_token>' \
  https://services.cloud.mongodb.com/api/admin/v3.0/groups/<groupId>/apps/<appId>/user_registrations/by_email/<email>/confirm

Execute novamente o fluxo de trabalho de confirmação do usuário

Algumas circunstâncias podem levar a fluxos de trabalho incompletos de confirmação de usuário de e-mail/senha:

• Um e-mail é capturado por um filtro de spam, não entregue devido a um bug, ou excluído acidentalmente por um possível usuário dos Serviços de Aplicativo.

• Uma função de confirmação personalizada não consegue se comunicar com um usuário não confirmado devido a um bug ou supervisão.

• Um usuário não confirmado esqueceu de visitar seu link de confirmação dentro de 30 minutos de recebimento de seus tokens de login, e os tokens expiraram.

Os usuários presos nessa situação parecem presos em um estado não confirmado. Como uma conta existente tem seu e-mail registrado, os usuários não podem criar uma nova conta com o mesmo endereço de e-mail. Além disso, eles não podem se conectar a uma conta que não esteja confirmada.

Os aplicativos que usam o serviço interno de confirmação de email dos Serviços de Aplicativo podem usar o método SDK do Cliente resendConfirmationEmail para enviar um novo email com um novo link de confirmação para o usuário, permitindo que ele confirme sua conta e faça login. Chamar esse método resultará em um erro por qualquer aplicativo usando um fluxo de confirmação diferente de send a confirmation email.

Não existe um método muito específico para executar novamente uma função de confirmação personalizada. Em vez disso, o App Services tem um método para acionar uma nova execução de qualquer fluxo de trabalho atual de confirmação do usuário por e-mail/senha. Você pode executar de novo manualmente o fluxo de confirmação do usuário selecionado no momento usando a IU do App Services ou a App Services Admin API:

curl --request POST \
  --header 'Authorization: Bearer <access_token>' \
  https://services.cloud.mongodb.com/api/admin/v3.0/groups/<groupId>/apps/<appId>/user_registrations/by_email/<email>/run_confirm

Resumo

• Para todos os provedores, exceto para autenticação de e-mail/senha, Os Serviços de Aplicativo criam automaticamente um objeto de usuário na primeira vez que um usuário se autentica.

• Você pode fazer login em uma única conta com mais de um provedor usando os SDKs do Realm para vincular identidades.

• O provedor de autenticação de e-mail/senha exige que os usuários criem uma conta na primeira vez que se conectarem ao seu aplicativo.

• Os usuários de e-mail/senha devem ser confirmados manualmente por meio da IU do App Services ou da API Admin.

• Os usuários detectados em um fluxo de trabalho incompleto de confirmação de e-mail/senha devem executar novamente a confirmação por meio da IU do App Services ou da API Admin.