Autenticar usuários - SDK do Node.js

Conecte-se

O Realm fornece uma API para autenticar usuários em um aplicativo com qualquer provedor de autenticação habilitado. Instancie um objeto Credentials e passe-o para o método app.login() para autenticar um logon de usuário e criar um objeto User.

Utilizador anónimo

O fornecedor Anônimo permite que os usuários conectem-se em seu aplicativo com contas temporárias que não têm informações associadas.

Para se conectar, crie uma credencial anônima e passe-a para App.logIn():

Usuário de e-mail/senha

O fornecedor de autenticação por e-mail/senha permite que os usuários se conectem no seu aplicativo com um endereço de e-mail e uma senha.

Para se conectar, crie uma credencial de e-mail/senha com o endereço de e-mail e a senha do usuário e passe-a para App.logIn():

Usuário da chave de API

O fornecedor de autenticação de chave API permite que os processos de servidor acessem sua aplicação diretamente ou em nome de um usuário.

Para se conectar com uma chave de API, crie uma credencial de chave de API com uma chave de API de servidor ou usuário e passe-a para App.logIn():

Usuário JWT personalizado

O fornecedor de autenticação JWT personalizado permite que você lide com a autenticação do usuário com qualquer sistema de autenticação que retorne um JSON web token.

Para se conectar, crie uma credencial JWT personalizada com um JWT do sistema externo e passe-a para App.logIn():

Usuário de função personalizada

O fornecedor de autenticação de função personalizada permite lidar com a autenticação do usuário executando uma função que recebe uma carga de informações arbitrárias sobre um usuário.

Para se conectar com o provedor de função personalizada, crie uma credencial de função personalizada com um objeto de carga útil e passe-a para App.logIn():

Usuário do Facebook

O fornecedor de autenticação do Facebook permite que você autentique usuários por meio de uma aplicação do Facebook usando sua conta existente do Facebook.

Você pode usar o SDK oficial do Facebook para lidar com a autenticação do usuário e redirecionar o fluxo de um aplicativo cliente. Quando autenticado, o SDK do Facebook retorna um token de acesso que você pode enviar para sua aplicação Node.js e usar para acabar de conectar o usuário à sua aplicação.

// Get the access token from the Facebook SDK
const { accessToken } = FB.getAuthResponse();
// Define credentials with the access token from the Facebook SDK
const credentials = Realm.Credentials.facebook(accessToken);
// Log the user in to your app
await app.logIn(credentials);

Usuário do Google

O fornecedor de autenticação do Google permite autenticar usuários por meio de um projeto do Google usando a conta do Google existente.

Para configurar seu aplicativo para autenticação de usuário do Google na configuração do seu aplicativo:

1. No console do Google Cloud Platform, crie um OAuth 2.0 ID do cliente do tipo "aplicativo Web".

2. Configure seu aplicativo de backend para usar esse ID de cliente e o segredo de cliente associado.

3. Habilite o OpenID Connect no backend.

Use a Google Auth Library oficial para Node.js para lidar com a autenticação do usuário e redirecionar o fluxo de um aplicativo cliente Node.js:

1. Instale os pacotes Realm e Google APIs npm.

   npm install realm googleapis

2. Importe os pacotes para o seu projeto.

   const Realm = require("realm");
   const { google } = require("googleapis");

3. Criar configuração para o cliente Google OAuth 2,0 e Realm.

   // Configure and instantiate Google OAuth2.0 client
   const oauthConfig = {
     client_id: GOOGLE_CLIENT_ID,
     project_id: GOOGLE_PROJECT_ID,
     auth_uri: "https://accounts.google.com/o/oauth2/auth",
     token_uri: "https://oauth2.googleapis.com/token",
     auth_provider_x509_cert_url: "https://www.googleapis.com/oauth2/v1/certs",
     client_secret: GOOGLE_CLIENT_SECRET,
     redirect_uris: [`${BASE_URL}/auth/google/callback`],
     JWTsecret: "secret",
     scopes: [
       "https://www.googleapis.com/auth/userinfo.email",
       "https://www.googleapis.com/auth/userinfo.profile",
       "openid",
       // any other scopes you might require. View all here - https://developers.google.com/identity/protocols/oauth2/scopes
     ],
   };
   const OAuth2 = google.auth.OAuth2;
   const oauth2Client = new OAuth2(
     oauthConfig.client_id,
     oauthConfig.client_secret,
     oauthConfig.redirect_uris[0]
   );
   // Instantiate Realm app
   const realmApp = new Realm.App({
     id: REALM_APP_ID,
   });

4. Gere um link de login OAuth e passe para o cliente do aplicativo.

   // generate OAuth 2.0 log in link
   const loginLink = oauth2Client.generateAuthUrl({
     access_type: "offline", // Indicates that we need to be able to access data continuously without the user constantly giving us consent
     scope: oauthConfig.scopes,
   });

5. Processe a solicitação do servidor de autenticação do Google, que inclui um código de acesso na string de query usando o método getToken() do cliente Google OAuth 2.0. Na função de retorno de chamada, entre em seu aplicativo utilizando o id_token.

   // Get Google token and use it to sign into Realm
   oauth2Client.getToken(authCodeFromQueryString, async function (
     error,
     token
   ) {
     if (error) return errorHandler(error);
     try {
       const credential = Realm.Credentials.google({
         idToken: token.id_token,
       });
       const user = await realmApp.logIn(credential);
       console.log("signed in as Realm user", user.id);
     } catch (error) {
       errorHandler(error);
     }
   });

Usuário da Apple

O fornecedor de autenticação Apple permite que você autentique usuários por meio do Sign-in With Apple.

Você pode usar o login oficial com o Apple JS SDK para lidar com a autenticação do usuário e redirecionar o fluxo de um aplicativo cliente. Quando autenticado, o SDK do JS da Apple retorna um token de ID que você pode enviar para sua aplicação Node.js e usar para acabar de conectar o usuário à sua aplicação.

// Get the ID token from the Apple SDK
const { id_token } = await AppleID.auth.signIn();
// Define credentials with the ID token from the Apple SDK
const credentials = Realm.Credentials.apple(id_token);
// Log the user in to your app
const user = await app.logIn(credentials);

Login off-line

Quando seu aplicativo Realm autentica um usuário, armazena em cache as credenciais do usuário. Você pode verificar as credenciais de usuário existentes para ignorar o fluxo de login e acessar o usuário em cache. Use isto para abrir um realm offline.

// Log user into your App Services App.
// On first login, the user must have a network connection.
const getUser = async () => {
  // If the device has no cached user credentials, log in.
  if (!app.currentUser) {
    const credentials = Realm.Credentials.anonymous();
    await app.logIn(credentials);
  }
  // If the app is offline, but credentials are
  // cached, return existing user.
  return app.currentUser!;
};

Para saber como usar o usuário em cache na Configuração Sincronizada e acessar um domínio enquanto estiver off-line, leia a documentação Open a Synced Realm While Offline (Abrir um domínio sincronizado enquanto estiver off-line ).

Obtenha um token de acesso do usuário

Quando um usuário se conecta, o Atlas App Services cria um token de acesso para o usuário que lhe concede acesso à sua aplicação. O Realm SDK gerencia automaticamente os tokens de acesso, atualiza-os quando expiram e inclui um token de acesso válido para o usuário atual em cada solicitação. O Realm não atualiza automaticamente o token de atualização. Quando o token de atualização expira, o usuário deve se conectar novamente.

Se você enviar solicitações fora do SDK, precisará incluir o token de acesso do usuário em cada solicitação e atualizar manualmente o token quando ele expirar.

Você pode acessar e atualizar um token de acesso de usuário conectado ao SDK a partir de seu objeto Realm.User, como no seguinte exemplo:

Atualize a expiração do token

A atualização dos tokens expira após um período de tempo definido. Quando o token de atualização expira, o token de acesso não pode mais ser atualizado e o usuário deve se conectar novamente.

Se o token de atualização expirar após a abertura do realm, o dispositivo não poderá sincronizar até que o usuário faça login novamente. Seu manipulador de erros de sincronização deve implementar uma lógica que capture um erro de token expirado ao tentar sincronizar e, em seguida, redirecionar os usuários para um fluxo de login.

Para obter informações sobre como configurar a expiração do token de atualização, consulte Gerenciar sessões de usuário na documentação do App Services.

Desconectar um usuário

Para desconectar qualquer usuário, chame o User.logOut() em sua instância de usuário.

// Log out the current user
await app.currentUser?.logOut();