Atlas App Services 백엔드에 연결 - Node.js SDK

시작하기 전에

1. App Services 앱 만들기

2. Realm Node.js SDK 설치

앱 클라이언트에 액세스

클라이언트 에서 App Services 백엔드 에 연결하려면 구성 객체 를 만들어야 합니다. 그런 다음 해당 구성 객체 를 Realm.App() 인스턴스 에 전달합니다.

App Services UI 에서 찾을수 있는 App Services App 의 id 필드 와 App ID 를 포함해야 합니다.

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

여러 앱 클라이언트 인스턴스를 만들어 여러 앱에 연결할 수 있습니다. 동일한 앱 ID 를 주식 하는 모든 앱 클라이언트 인스턴스는 동일한 기본 연결을 사용합니다.

앱 클라이언트의 인스턴스 조회

애플리케이션의 어느 곳에서나 앱 클라이언트의 인스턴스를 조회하려면 Realm.App.getApp() 을 호출하고 App ID 를 전달합니다.

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

앱 클라이언트에 대한 시간 초과 구성

AppConfiguration 에서 요청에 대한 선택적 timeout 를 구성할 수 있습니다. 요청 이 시간 초과되기 전에 밀리초 단위로 허용합니다.

이 시간 초과 간격은 선택 사항인 동기화 구성 cancelWaitsOnNonFatalErrors 부울과 함께 사용할 수 있습니다. 제한 시간 간격이 경과하면 업로드 및 다운로드를 기다리고 있는 미해결 작업이 모두 취소됩니다. 이 설정이 false이면 Realm이 이러한 시간 초과를 치명적이지 않은 오류로 처리하므로 업로드 및 다운로드 대기가 취소되지 않습니다.

예제 는 시간 초과 후 비동기 작업 취소를 참조하세요.

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

앱 메타데이터 암호화

Atlas App Services가 클라이언트 기기에 저장하는 메타데이터를 암호화할 수 있습니다. MetadataMode 열거형 값을 사용하여 암호화 동작을 결정합니다.

앱 메타데이터를 암호화하려면 다음을 수행합니다.

1. MetadataMode Realm 에서 를 가져오고 다른 종속성을 가져옵니다:

   JavaScript

   TypeScript

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

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

2. metadata 속성을 포함하는 앱 구성 객체를 만듭니다.

3. metadata.mode을 MetadataMode.Encryption로 설정합니다.

4. 암호화에 사용할 키로 metadata.encryptionKey 를 설정합니다.

5. 앱 구성 객체를 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);

특정 MongoDB 서버에 연결

기본적으로 Atlas Device SDK는 https://services.cloud.mongodb.com 의 글로벌 baseURL 를 사용하여 Atlas에 연결합니다. 경우에 따라 다른 서버에 연결해야 할 수도 있습니다.

• App Services App이 로컬 배포 를 사용하며 해당 리전의 로컬 baseURL 에 직접 연결하려고 합니다.

AppConfiguration에서 baseURL 를 지정할 수 있습니다.

.. code-block:: javascript
   const appConfig = {
     id: APP_ID,
     baseUrl: "https://example.com",
   };
   const app = new App(appConfig);

.. code-block:: typescript
   const appConfig: AppConfiguration = {
     id: APP_ID,
     baseUrl: "https://example.com",
   };
   const app = new App(appConfig);

const app = new App(EDGE_APP_ID);
await app.updateBaseUrl("http://localhost:80");
// ... log in a user and use the app...
// ... some time later...
// Reset baseURL to the default: https://services.cloud.mongodb.com
await app.updateBaseUrl(null);

const app = new App(EDGE_APP_ID);
await app.updateBaseUrl("http://localhost:80");
// ... log in a user and use the app...
// ... some time later...
// Reset baseURL to the default: https://services.cloud.mongodb.com
await app.updateBaseUrl(null);

import "realm/experimental/base-url";

{
   "target": "es2022",
   "module": "node16",
   "moduleResolution": "node16",
   // ...
}