Autenticar e gerenciar usuários

Provedores de autenticação

No App Services, um fornecedor de autenticação é um serviço modular. Esses serviços fornecem verificação de identidade e mantêm informações sobre usuários da aplicação.

Os usuários se autenticam fornecendo um conjunto de credenciais para um provedor de autenticação. Com credenciais válidas, o provedor retorna uma identidade exclusiva associada ao usuário. App Services os registram como o usuário ativo.

Os Serviços de aplicativos incluem fornecedores de autenticação integrados para casos de uso comuns. Isso inclui:

• Usuários anônimos

• Combinações de e-mail/senha

• Chaves de API

• OAuth 2.0 por meio do Facebook, Google e Apple ID

Você pode configurar fornecedores personalizados para integrar sistemas de autenticação externos.

• JWT Personalizado: o fornecedor aceita web tokens JSON assinados pelo sistema externo.

• Função Personalizada: o fornecedor permite que você defina a lógica de login personalizada em um Atlas Function.

Contas de Usuário

Uma conta de usuário representa um usuário único e distinto do seu aplicativo. O App Services cria o usuário quando um fornecedor de autenticação valida uma identidade única. Você pode obter metadados do usuário, como e-mail ou aniversário, de fornecedores de autenticação. Você pode associar cada usuário a dados personalizados.

Identidades do Fornecedor de Autenticação

O App Services armazena metadados de login para um usuário em uma identidade do provedor de autenticação. Os Serviços de apps utilizam estes metadados para autenticar o utilizador.

No primeiro login com um fornecedor de autenticação, o App Services cria um objeto de identidade. Cada objeto contém um ID exclusivo e metadados específicos do fornecedor sobre o usuário. Em logins posteriores, o App Services atualiza os dados de identidade existentes.

Uma única conta de usuário pode ter mais de uma identidade. Os SDKs do Realm permitem vincular identidades a contas de usuário existentes. Isso permite que os usuários façam login em uma única conta com mais de um provedor. Para obter mais informações, consulte a documentação sobre como vincular identidades para o SDK do cliente.

Usuário Ativo

Nos Realm SDKs, você pode fazer login em mais de um usuário, mas apenas uma conta pode estar ativa a qualquer momento. O usuário ativo é uma conta de usuário associada a uma solicitação de aplicativo.

O App Services executa solicitações de aplicativos clientes como usuário ativo. O App Services substitui referências dinâmicas ao usuário - por exemplo %%user em uma expressão JSON - com o usuário ativo.

Você pode usar um usuário ativo específico, ou o usuário do sistema, para executar funções.

Usuário do sistema

O usuário do sistema é um usuário interno que tem privilégios avançados. O usuário do sistema ignora todas as regras. Você pode executar funções como usuário do sistema em vez de o usuário fazer uma solicitação. Os acionadores são executados no contexto do usuário do sistema.

O usuário do sistema é útil para tarefas administrativas. Isso inclui:

• Tarefas que precisam contornar regras e queries

• Tarefas que precisam de acesso irrestrito às operações de agregação e CRUD do MongoDB

exports = function() {
  const activeUser = context.user
  const adminUserId = context.values.get("adminUserId");
  if(activeUser.id == adminUserId) {
    // The user can only execute code here if they're an admin.
  } else {
    throw Error("This user is not allowed to execute the system function")
  }
}

Sessões de usuário

Uma sessão de usuário representa um período de tempo em que um usuário autenticado pode interagir com sua aplicação As sessões de usuário começam quando um usuário faz login por meio de um SDK ou autentica por HTTPS. Uma sessão termina após 30 minutos, a menos que uma solicitação de SDK ou API atualize a sessão.

Para saber como criar, trabalhar e revogar sessões de usuário, consulte Gerenciar sessões de usuário.