Connect to an Atlas App Services Backend - Node.js SDK

Antes de comenzar

1. Crear una aplicación de servicios de aplicaciones

2. Install the Realm Node.js SDK

Access the App Client

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 un cliente de aplicación para conectarte a múltiples aplicaciones. Todas las instancias de cliente de aplicación que comparten el mismo ID de la aplicación utilizan la misma conexión subyacente.

Retrieve an Instance of the App Client

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

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

Configure a Timeout for the App Client

Puedes configurar un/una timeout opcional para las solicitudes en tu AppConfiguration. Acepta una cantidad de milisegundos antes de que la solicitud deba agotar el tiempo de espera.

You can use this timeout interval with the optional Sync configuration cancelWaitsOnNonFatalErrors boolean. When the timeout interval elapses, any outstanding work that is awaiting uploads and downloads cancels. When this setting is false, awaiting uploads and downloads does not cancel because Realm treats these timeouts as non-fatal errors.

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. Importa MetadataMode desde Realm e importa otras dependencias:

   JavaScript

   TypeScript

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

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

2. Create an App configuration object that contains the metadata property.

3. Establezca metadata.mode en MetadataMode.Encryption.

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

5. Pass the App configuration object to 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);