Conectarse a un backend de Atlas App Services: SDK de Node.js

Antes de comenzar

1. Crear una aplicación de servicios de aplicaciones

2. Instalar el SDK de Node.js de Realm

Acceder al cliente de la aplicación

Para conectarse al backend de App Services desde su cliente, debe crear un objeto de configuración. Luego, páselo a un Realm.App() instancia.

Debe incluir el campo id y el App ID para su aplicación de Servicios de aplicaciones, que puede encontrar en la interfaz de usuario de Servicios de aplicaciones.

// Initialize your App.
const app = new Realm.App({
  id: "<yourAppId>",
});

Puedes crear varias instancias de cliente de aplicación para conectarte a varias aplicaciones. Todas las instancias de cliente de aplicación que comparten el mismo ID de aplicación usan la misma conexión subyacente.

Recuperar una instancia del cliente de la aplicación

Para recuperar una instancia del cliente de la aplicación desde cualquier lugar de su aplicación, llame a Realm.App.getApp() y pase App ID su.

const app = Realm.App.getApp("<yourAppId>");

Configurar un tiempo de espera para el cliente de la aplicación

Puedes configurar un opcional timeout para las solicitudes en tu AppConfiguration. Acepta un número de milisegundos antes de que la solicitud expire.

Puede usar este intervalo de tiempo de espera con el booleano cancelWaitsOnNonFatalErrors de configuración de sincronización opcional. Al transcurrir este tiempo de espera, se cancela cualquier trabajo pendiente de carga y descarga. Si esta configuración es falsa, la espera de cargas y descargas no se cancela, ya que Realm considera estos tiempos de espera como errores no fatales.

Para ver un ejemplo, consultar Cancelar operaciones asíncronas después de un tiempo de espera.

const app = new Realm.App({
  id: APP_ID,
  // You can optionally specify a timeout in milliseconds
  timeout: 10000,
});

Encriptar Metadatos de la aplicación

Puedes cifrar los metadatos que aplicación Services almacena en los dispositivos de los clientes. Utiliza los valores del enumerado MetadataMode para determinar el comportamiento de cifrado.

Para cifrar los metadatos de la aplicación:

1. Importar MetadataMode desde Realm e importar otras dependencias:

   JavaScript

   TypeScript

   import Realm, { BSON, MetadataMode } from "realm";

   import Realm, {
     AppConfiguration,
     BSON,
     MetadataMode,
     Configuration,
   } from "realm";

2. Cree un objeto de configuración de aplicación que contenga la propiedad metadata.

3. Establezca metadata.mode en MetadataMode.Encryption.

4. Configura metadata.encryptionKey como la clave que deseas usar para el cifrado.

5. Pase el objeto de configuración de la aplicación a new Realm.App().

// Retrieve encryption key from secure location or create one
const encryptionKey = new ArrayBuffer(64);
// Use encryption key in app configuration
const config = {
  id: APP_ID,
  metadata: { mode: MetadataMode.Encryption, encryptionKey: encryptionKey },
};
const app = new Realm.App(config);

// Retrieve encryption key from secure location or create one
const encryptionKey = new ArrayBuffer(64);
// Use encryption key in app configuration
const config: AppConfiguration = {
  id: APP_ID,
  metadata: { mode: MetadataMode.Encryption, encryptionKey: encryptionKey },
};
const app = new Realm.App(config);