Device Sync 권한 가이드

사용자 지정 사용자 데이터 활성화 및 구성

Atlas App Services는 사용자 지정 사용자 데이터에 해당하는 MongoDB 문서를 연결된 MongoDB Atlas 클러스터에 저장합니다. 애플리케이션에 대한 사용자 지정 사용자 데이터를 구성할 때 클러스터, 데이터베이스, 컬렉션을 지정하고 마지막으로 사용자 지정 사용자 데이터 문서를 인증된 사용자의 ID에 매핑하는 사용자 ID 필드를 지정합니다.

App Services UI에서 사용자 지정 사용자 데이터를 활성화하려면 다음 단계를 따릅니다.

1. 왼쪽 패널에서 App Users 를 클릭합니다.

2. User Settings 탭을 선택하고 Custom User Data 섹션을 찾습니다.

3. Enable Custom User Data 토글을 On 으로 설정합니다.

4. 다음 값을 지정합니다.

   • Cluster Name: 사용자 지정 사용자 데이터 데이터베이스를 포함할 연결된 MongoDB 클러스터의 이름입니다.

   • Database Name: 사용자 지정 사용자 데이터 컬렉션을 포함할 MongoDB 데이터베이스의 이름입니다.

   • Collection Name: 사용자 지정 사용자 데이터가 포함된 MongoDB 컬렉션의 이름입니다.

5. 사용자 ID 필드를 지정합니다. 사용자 지정 사용자 데이터 컬렉션의 모든 문서에는 특정 사용자에 매핑되는 필드가 있어야 합니다. 이 필드는 사용자에게 매핑되는 모든 문서에 포함되어야 하며, 사용자 ID를 문자열로 포함해야 합니다. 사용자 ID를 저장하려면 표준 _id 필드를 사용하는 것이 좋습니다. MongoDB는 _id 필드에 자동으로 제약 조건을 설정하여 고유성을 보장합니다.

   참고

   이 컬렉션에 있는 두 문서에 동일한 사용자 ID 값이 포함되어 있으면 App Services에서 일치하는 첫 번째 문서를 사용하므로 예기치 않은 결과가 발생합니다.

6. 변경 사항을 저장하고 배포합니다.

   참고

   사용자 지정 사용자 데이터 업데이트 후 동기화 세션 다시 시작하기

   동기화 서버는 세션이 진행되는 동안 사용자 지정 사용자 데이터를 캐시합니다. 따라서 사용자 지정 사용자 데이터를 업데이트한 후 동기화 세션을 다시 시작해야 보상 쓰기 오류를 방지할 수 있습니다. 동기화 세션을 다시 시작하려면 클라이언트 애플리케이션에서 열려 있는 모든 동기화 세션을 일시 중지했다가 다시 시작하세요. 클라이언트 SDK에서 동기화를 일시 중지하고 다시 시작하는 방법에 대한 자세한 내용은 자주 사용하는 SDK를 참조하세요.

   • Device Sync 세션 일시중지 또는 다시 시작 - Flutter SDK

   • Device Sync 세션 일시중지 또는 다시 시작 - Kotlin SDK

   • Device Sync 세션 일시 중지 또는 다시 시작 - Java SDK

   • Device Sync 세션 일시 중지 또는 다시 시작 - .Net SDK

   • Device Sync 세션 일시 중지 또는 다시 시작 - Node SDK

   • Device Sync 세션 일시중지 또는 다시 시작 - React Native SDK

   • DDevice Sync 세션 일시중지 또는 다시 시작 - Swift SDK

관리자 권한 설정

사용자 지정 사용자 데이터를 활성화한 후 관리자 권한 전략을 구현할 수 있습니다. 이렇게 하려면 다음과 같은 일반적인 단계를 따르세요.

1. Realm UI에 로그인한 다음 왼쪽 패널에서 Sync를 클릭합니다.

2. Sync Type에서 Flexible을 선택합니다.

3. Development Mode 토글을 활성화로 설정합니다.

4. 동기화하려는 클러스터를 선택합니다.

5. Define a Database Name: +Add a new database를 선택하고 Realm에서 동기화된 객체를 저장하는 데 사용할 데이터베이스의 이름을 입력합니다. 원하는 이름을 지정할 수 있습니다. 만들고 있는 앱의 이름을 따서 데이터베이스 이름을 짓는 것이 일반적인 전략입니다.

6. Select Queryable Fields: owner_id를 입력합니다. 이렇게 하면 다음에 설정하게 될 권한 표현식에서 owner_id인 모든 필드를 사용할 수 있습니다.

7. Advanced Configuration을 건너뛴 다음 Save Changes을 클릭하여 Sync를 활성화합니다.

이제 권한을 구성해야 합니다. Rules 페이지로 이동합니다. 기본 역할을 수정하려면 Default Roles and Filters 버튼을 클릭합니다. 템플릿 드롭다운을 사용하여 "사용자는 자신의 데이터만 읽고 쓸 수 있음, 관리자는 모든 데이터 읽고 쓸 수 있음"이라는 템플릿을 선택합니다.

그러면 규칙 표현식 상자가 다음과 같이 채워집니다.

[
   {
     "name": "admin",
     "apply_when": {
       "%%user.custom_data.isGlobalAdmin": true
     },
     "document_filters": {
       "read": true,
       "write": true
     },
     "read": true,
     "write": true
   },
   {
     "name": "user",
     "apply_when": {},
     "document_filters": {
       "read": { "owner_id": "%%user.id" },
       "write": { "owner_id": "%%user.id" }
     },
     "read": true,
     "write": true
   }
]

사용자 지정 사용자 데이터 활성화 및 구성

App Services UI에서 사용자 지정 사용자 데이터를 활성화하려면 다음 단계를 따릅니다.

1. 왼쪽 패널에서 App Users 를 클릭합니다.

2. User Settings 탭을 선택하고 Custom User Data 섹션을 찾습니다.

3. Enable Custom User Data 토글을 On 으로 설정합니다.

4. 다음 값을 지정합니다.

   • Cluster Name: 사용자 지정 사용자 데이터 데이터베이스를 포함할 연결된 MongoDB 클러스터의 이름입니다.

   • Database Name: 사용자 지정 사용자 데이터 컬렉션을 포함할 MongoDB 데이터베이스의 이름입니다.

   • Collection Name: 사용자 지정 사용자 데이터가 포함된 MongoDB 컬렉션의 이름입니다.

5. 사용자 ID 필드를 지정합니다. 사용자 지정 사용자 데이터 컬렉션의 모든 문서에는 특정 사용자에 매핑되는 필드가 있어야 합니다. 이 필드는 사용자에게 매핑되는 모든 문서에 포함되어야 하며, 사용자 ID를 문자열로 포함해야 합니다. 사용자 ID를 저장하려면 표준 _id 필드를 사용하는 것이 좋습니다. MongoDB는 _id 필드에 자동으로 제약 조건을 설정하여 고유성을 보장합니다.

   참고

   이 컬렉션에 있는 두 문서에 동일한 사용자 ID 값이 포함되어 있으면 App Services에서 일치하는 첫 번째 문서를 사용하므로 예기치 않은 결과가 발생합니다.

6. 변경 사항을 저장하고 배포합니다.

   참고

   사용자 지정 사용자 데이터 업데이트 후 동기화 세션 다시 시작하기

   동기화 서버는 세션이 진행되는 동안 사용자 지정 사용자 데이터를 캐시합니다. 따라서 사용자 지정 사용자 데이터를 업데이트한 후 동기화 세션을 다시 시작해야 보상 쓰기 오류를 방지할 수 있습니다. 동기화 세션을 다시 시작하려면 클라이언트 애플리케이션에서 열려 있는 모든 동기화 세션을 일시 중지했다가 다시 시작하세요. 클라이언트 SDK에서 동기화를 일시 중지하고 다시 시작하는 방법에 대한 자세한 내용은 자주 사용하는 SDK를 참조하세요.

   • Device Sync 세션 일시중지 또는 다시 시작 - Flutter SDK

   • Device Sync 세션 일시중지 또는 다시 시작 - Kotlin SDK

   • Device Sync 세션 일시 중지 또는 다시 시작 - Java SDK

   • Device Sync 세션 일시 중지 또는 다시 시작 - .Net SDK

   • Device Sync 세션 일시 중지 또는 다시 시작 - Node SDK

   • Device Sync 세션 일시중지 또는 다시 시작 - React Native SDK

   • DDevice Sync 세션 일시중지 또는 다시 시작 - Swift SDK

인증 트리거 함수 생성

사용자가 처음 인증할 때 사용자 지정 사용자 객체를 생성하는 인증 트리거 함수를 만들어야 합니다. 이렇게 하려면 다음 단계를 따라 진행합니다.

1. Realm UI에 로그인한 다음 왼쪽 패널에서 Triggers를 클릭합니다.

2. Add a Trigger 버튼을 클릭합니다.

3. Trigger Type 토글을 Authentication 으로 설정합니다.

4. Triggers 세부 정보에서 다음 값을 지정합니다.

   • Name: "onUserCreated"

   • Enbaled: 토글을 "켜짐"으로 전환합니다.

   • Action Type: "만들기"를 선택합니다.

   • Provider(s): "이메일/비밀번호" 또는 사용 중인 인증 제공자를 선택합니다.

   • Select an Event Type: "기능"을 선택합니다.

   • Function: " +새 기능"을 선택합니다:

     • Function Name: "onUserCreated"

     • Function: 자리 표시자 텍스트를 다음 함수로 바꿉니다.

     exports = function(authEvent) {
         const user = authEvent.user;
         const collection = context.services.get("mongodb-atlas").db("Item").collection("User");
         const newDoc = {
           _id: user.id,
           email: user.data.email, // Useful for looking up user IDs by email later - assuming email/password auth is used
           team: "", // Used for tiered privileges
           isTeamAdmin: false, // Used for tiered privileges
           isGlobalAdmin: false, // Used for admin privileges
           subscribedTo: [], // Used for restricted feed
         };
         return collection.insertOne(newDoc);
     };

제한된 권한 설정

사용자 지정 사용자 데이터 객체에서 사용자가 팔로우하는 각 작성자의 _id 값을 보유하는 배열을 만듭니다. 이 예에서는 "구독"이라고 부르겠습니다. 사용자 데이터 객체는 다음과 같이 표시되며, 여기서 Lily Realmster("_id": "1234")는 사용자 "456" 및 "789" 이 작성한 모든 문서를 구독합니다.

{
   "_id" : "1234",
   "firstName": "Lily",
   "lastName": "Realmster",
   "user.custom_data.subscribedTo": [
     "456",
     "789"
   ]
}

이제 제한된 권한 전략을 구현할 수 있습니다. 이렇게 하려면 다음과 같은 일반적인 단계를 따르세요.

1. Realm UI에 로그인한 다음 왼쪽 패널에서 Sync를 클릭합니다.

2. Sync Type에서 Flexible을 선택합니다.

3. Development Mode 토글을 활성화로 설정합니다.

4. 동기화하려는 클러스터를 선택합니다.

5. Define a Database Name: +Add a new database를 선택하고 Realm에서 동기화된 객체를 저장하는 데 사용할 데이터베이스의 이름을 입력합니다. 원하는 이름을 지정할 수 있습니다. 만들고 있는 앱의 이름을 따서 데이터베이스 이름을 짓는 것이 일반적인 전략입니다.

6. Select Queryable Fields: owner_id를 입력합니다. 이렇게 하면 다음에 설정하게 될 권한 표현식에서 owner_id인 모든 필드를 사용할 수 있습니다.

7. Advanced Configuration을 건너뛴 다음 Save Changes을 클릭하여 Sync를 활성화합니다.

이제 권한을 구성해야 합니다. Rules 페이지로 이동합니다. 기본 역할을 수정하려면 Default Roles and Filters 버튼을 클릭합니다. 템플릿 드롭다운을 사용하여 "사용자는 자신의 데이터만 읽고 쓸 수 있음"이라는 템플릿을 선택합니다. 이렇게 하면 규칙 표현식 상자가 다음과 같이 채워지는데, 우리가 원하는 것과 정확히 일치하지는 않지만 대부분의 논리를 제공합니다.

{
  "name": "owner-read-write",
  "apply_when": {},
  "document_filters": {
    "read": { "owner_id": "%%user.id" },
    "write": { "owner_id": "%%user.id" }
  },
  "read": true,
  "write": true
}

사용자는 현재 자신의 문서("read": {"owner_id": "%%user.id"})만 읽을 수 있습니다. 작성자가 사용자의 "SubscribeDto" 배열에 ID를 가진 문서를 포함하도록 변경할 수 있습니다. 이를 위해 $in 연산자를 사용합니다. 표현식은 다음과 같습니다.

{
  "name": "owner-read-write",
  "apply_when": {},
  "document_filters": {
    "read": {
      "owner_id": {
        "$in": "%%user.custom_data.subscribedTo"
      }
    },
    "write": { "owner_id": "%%user.id" }
  },
  "read": true,
  "write": true
}

규칙 표현식 상자를 이 새 로직으로 업데이트하고 변경 내용을 저장합니다.

참고: document_filters.read 표현식을 구독자 배열의 작성자만 언급하도록 변경했지만, document_filters.read 표현식으로 인해 사용자는 여전히 "읽기" 자신의 문서에 대한 액세스 권한을 가집니다. 쓰기 액세스가 부여될 때마다 읽기 액세스가 암시적으로 부여됩니다.

subscribeToUser 함수 생성

한 사용자를 다른 사용자에 구독하는 기능이 필요합니다. 작성자의 사용자 ID가 구독자의 사용자 지정 사용자 데이터 "subscribedTo" 배열에 있는 경우, 구독자가 작성자를 "구독"한 것으로 간주하도록 권한이 설정됩니다. "subscribeToUser" 함수는 사용자의 이메일 주소를 가져와 사용자 지정 사용자 데이터 컬렉션에서 해당 사용자 ID를 찾은 다음, 요청 사용자의 "subscribedTo" 배열에 해당 ID를 추가합니다.

이 함수는 시스템 인증 하에 실행 되며 사용자 지정 사용자 데이터 에 기록됩니다. 권한에 사용자 지정 사용자 데이터 를 사용하는 경우 클라이언트가 사용자 지정 사용자 데이터 를 직접 편집하도록 허용해서는 안 됩니다. 그렇지 않으면 모든 사용자가 자신에게 모든 권한을 부여할 수 있습니다. 대신 시스템 함수를 사용하여 백엔드 에서 사용자 데이터를 수정하세요. 이 함수는 사용자의 권한 요청 이 유효한지 확인하는 데 필요한 모든 검사를 수행해야 합니다.

함수를 만들려면 다음 단계를 따르세요.

1. Realm UI에 로그인한 다음 왼쪽 패널에서 Functions를 클릭합니다.

2. Create New Function 버튼을 클릭합니다.

3. 다음 값을 지정합니다.

   • Name: "subscribeToUser"

   • Authentication: "System"

4. Function Editor 탭으로 전환하고 자리 표시자 텍스트를 다음 코드로 바꿉니다.

   exports = async function(email) {
     const collection = context.services.get("mongodb-atlas").db("Item").collection("User");
     // Look up the author object to get the user id from an email
     const author = await collection.findOne({email});
     if (author == null) {
       return {error: `Author ${email} not found`};
     }
     // Whoever called this function is the would-be subscriber
     const subscriber = context.user;
     try {
       return await collection.updateOne(
         {_id: subscriber.id},
         {$addToSet: {
             subscribedTo: author._id,
           }
         });
     } catch (error) {
       return {error: error.toString()};
     }
   };

권한 설정

이 전략을 구현하려면 다음과 같은 일반적인 단계를 따르세요:

1. Realm UI에 로그인한 다음 왼쪽 패널에서 Sync를 클릭합니다.

2. Sync Type에서 Flexible을 선택합니다.

3. Development Mode 토글을 활성화로 설정합니다.

4. 동기화하려는 클러스터를 선택합니다.

5. Define a Database Name: +Add a new database를 선택하고 Realm에서 동기화된 객체를 저장하는 데 사용할 데이터베이스의 이름을 입력합니다. 원하는 이름을 지정할 수 있습니다. 만들고 있는 앱의 이름을 따서 데이터베이스 이름을 짓는 것이 일반적인 전략입니다.

6. Select Queryable Fields: owner_id를 입력합니다. 이렇게 하면 다음에 설정하게 될 권한 표현식에서 owner_id인 모든 필드를 사용할 수 있습니다.

7. Advanced Configuration을 건너뛴 다음 Save Changes을 클릭하여 Sync를 활성화합니다.

Select Queryable Fields 필드에 collaborators도 입력합니다. 이 필드는 문서를 읽고 쓸 수 있는 사용자의 ID를 저장하는 필드입니다.

이제 권한을 구성해야 합니다. Define Permissions에서 템플릿 드롭다운을 사용하여 "사용자 지정(처음부터 시작)"을 선택합니다. 규칙 표현식 상자에 다음을 붙여넣습니다.

{
  "name": "collaborator",
  "apply_when": {},
  "document_filters": {
    "read": {
      "$or": [
        {
          "owner_id": "%%user.id"
        },
        {
          "collaborators": "%%user.id"
        }
      ]
    },
    "write": {
      "$or": [
        {
          "owner_id": "%%user.id"
        },
        {
          "collaborators": "%%user.id"
        }
      ]
    }
  },
  "read": true,
  "write": true
}

"쓰기" 및 "읽기" 표현식은 동일합니다. 그 중 하나를 살펴보세요. $or는 옵션 배열을 사용합니다. 사용자가 문서를 작성할 수 있는 두 가지 가능한 조건은 다음과 같습니다.

• 문서의 owner_id 필드가 사용자의 ID와 같습니다.

• 문서의 collaborators 배열 필드에 사용자 ID가 포함되어 있습니다.

일반적으로 사용자에게 쓰기 권한이 부여되면 해당 사용자는 자동으로 읽기 권한을 얻습니다. 그러나 App Services에서는 역할이 동기화 호환되도록 정의하기 위해 document_filters.read 및 document_filters.write가 모두 필요하므로 document_filters.read 표현식을 생략할 수 없습니다.

협업자 추가하기

사용자는 문서의 collaborators 배열 필드에 해당 사용자 ID를 추가하여 다른 사용자에게 문서에 대한 쓰기 액세스 권한을 부여할 수 있습니다. 클라이언트 사이드에서 이 작업을 수행할 수 있습니다.

보안

매우 중요한 데이터에는 이 모델을 사용하지 않는 것이 좋습니다.

이 모델은 권한 시스템을 사용하여 문서 작성자와 문서에 추가하는 협업자 사이에서 문서를 비공개로 유지합니다. 그러나 사용자가 문서에 대한 쓰기 액세스 권한을 갖고 있는 경우 문서의 모든 필드에 쓸 수 있습니다. 따라서 이 전략을 사용하면 협업자가 다른 협업자를 추가할 수 있습니다. 또한 공동 작업자가 owner_id 필드를 수정할 수 있습니다. 필드 수준 권한은 동기화 호환을 위해 부울 리터럴이어야 하므로 이러한 필드에 대한 쓰기를 특정 사용자로 제한할 수 없습니다.

사용자 검색

다른 사용자의 ID를 정확히 가져오는 방법은 앱의 세부 정보에 따라 다릅니다. 예를 들어, 사용자가 문서에 다른 사용자를 추가하려는 경우 이메일 주소를 허용하는 검색창이 있을 수 있습니다. 지정된 이메일 주소가 다른 사용자와 일치하는 경우 클라이언트는 해당 사용자의 ID를 문서의 collaborators 배열에 추가할 수 있습니다.

Realm에는 사용자를 검색하는 기본 제공 방법이 없습니다. 일반적으로 사용자를 검색하는 흐름은 다음과 같습니다.

• 사용자가 등록할 때 사용자 문서를 생성하도록 인증 트리거를 설정합니다. 사용자 문서에는 사용자의 이메일 주소와 같이 나중에 검색하는 데 사용할 정보가 들어 있습니다.

• 사용자에 대한 사용자 데이터 컬렉션을 쿼리하는 함수를 만듭니다.

• 사용자가 다른 사용자를 찾고자 할 때 클라이언트 사이드에서 함수를 호출합니다.

인증 트리거를 만들려면 다음 단계를 수행합니다.

1. Realm UI에 로그인한 다음 왼쪽 패널에서 Triggers를 클릭합니다.

2. Add a Trigger 버튼을 클릭합니다.

3. Trigger Type 토글을 Authentication 으로 설정합니다.

4. Triggers 세부 정보에서 다음 값을 지정합니다.

   • Name: "onUserCreated"

   • Enbaled: 토글을 "켜짐"으로 전환합니다.

   • Action Type: "만들기"를 선택합니다.

   • Provider(s): "이메일/비밀번호" 또는 사용 중인 인증 제공자를 선택합니다.

   • Select an Event Type: "기능"을 선택합니다.

   • Function: " +새 기능"을 선택합니다:

     • Function Name: "onUserCreated"

     • Function: 자리 표시자 텍스트를 다음 함수로 바꿉니다.

     exports = function(authEvent) {
         const user = authEvent.user;
         const collection = context.services.get("mongodb-atlas").db("Item").collection("User");
         const newDoc = {
           _id: user.id,
           email: user.data.email, // Useful for looking up user IDs by email later - assuming email/password auth is used
           team: "", // Used for tiered privileges
           isTeamAdmin: false, // Used for tiered privileges
           isGlobalAdmin: false, // Used for admin privileges
           subscribedTo: [], // Used for restricted feed
         };
         return collection.insertOne(newDoc);
     };

다음으로 findUser이라는 시스템 기능을 만듭니다.

• Realm UI에 로그인하고 Realm 앱으로 이동한 다음 왼쪽 패널에서 Functions를 클릭합니다.

• Create New Function 버튼을 클릭합니다.

• 함수에 대한 설명 Name을 입력합니다.

• Authentication: System을 선택합니다. 이를 통해 함수가 컬렉션에 대한 권한을 우회할 수 있습니다.

• Log Function Argumentsoff로 둡니다.

• Authorization:

  • Can Evaluate: 비워 둡니다.

  • Privateoff로 둡니다.

• Save를 클릭합니다. 이제 실행할 항목을 입력할 수 있는 Function Editor로 이동합니다.

Function Editor0}에 다음 코드를 붙여넣고 저장합니다:

exports = async function(email) {
  const collection = context.services.get("mongodb-atlas")
    .db("Item").collection("User");
  const filter = {
    email,
  };
  // Search for the user by email
  const result = await collection.findOne(filter);
  // Return corresponding user id or null
  return result != null ? result._id : null;
};

이제 클라이언트에서 이 함수를 호출할 수 있습니다. 함수의 유일한 인수는 이메일 주소 문자열입니다. 이메일이 사용자에 해당하는 경우 이 함수는 사용자의 ID를 반환합니다. 그렇지 않으면 null을 반환합니다.

사용자 지정 사용자 데이터 활성화 및 구성

App Services UI에서 사용자 지정 사용자 데이터를 활성화하려면 다음 단계를 따릅니다.

1. 왼쪽 패널에서 App Users 를 클릭합니다.

2. User Settings 탭을 선택하고 Custom User Data 섹션을 찾습니다.

3. Enable Custom User Data 토글을 On 으로 설정합니다.

4. 다음 값을 지정합니다.

   • Cluster Name: 사용자 지정 사용자 데이터 데이터베이스를 포함할 연결된 MongoDB 클러스터의 이름입니다.

   • Database Name: 사용자 지정 사용자 데이터 컬렉션을 포함할 MongoDB 데이터베이스의 이름입니다.

   • Collection Name: 사용자 지정 사용자 데이터가 포함된 MongoDB 컬렉션의 이름입니다.

5. 사용자 ID 필드를 지정합니다. 사용자 지정 사용자 데이터 컬렉션의 모든 문서에는 특정 사용자에 매핑되는 필드가 있어야 합니다. 이 필드는 사용자에게 매핑되는 모든 문서에 포함되어야 하며, 사용자 ID를 문자열로 포함해야 합니다. 사용자 ID를 저장하려면 표준 _id 필드를 사용하는 것이 좋습니다. MongoDB는 _id 필드에 자동으로 제약 조건을 설정하여 고유성을 보장합니다.

   참고

   이 컬렉션에 있는 두 문서에 동일한 사용자 ID 값이 포함되어 있으면 App Services에서 일치하는 첫 번째 문서를 사용하므로 예기치 않은 결과가 발생합니다.

6. 변경 사항을 저장하고 배포합니다.

   참고

   사용자 지정 사용자 데이터 업데이트 후 동기화 세션 다시 시작하기

   동기화 서버는 세션이 진행되는 동안 사용자 지정 사용자 데이터를 캐시합니다. 따라서 사용자 지정 사용자 데이터를 업데이트한 후 동기화 세션을 다시 시작해야 보상 쓰기 오류를 방지할 수 있습니다. 동기화 세션을 다시 시작하려면 클라이언트 애플리케이션에서 열려 있는 모든 동기화 세션을 일시 중지했다가 다시 시작하세요. 클라이언트 SDK에서 동기화를 일시 중지하고 다시 시작하는 방법에 대한 자세한 내용은 자주 사용하는 SDK를 참조하세요.

   • Device Sync 세션 일시중지 또는 다시 시작 - Flutter SDK

   • Device Sync 세션 일시중지 또는 다시 시작 - Kotlin SDK

   • Device Sync 세션 일시 중지 또는 다시 시작 - Java SDK

   • Device Sync 세션 일시 중지 또는 다시 시작 - .Net SDK

   • Device Sync 세션 일시 중지 또는 다시 시작 - Node SDK

   • Device Sync 세션 일시중지 또는 다시 시작 - React Native SDK

   • DDevice Sync 세션 일시중지 또는 다시 시작 - Swift SDK

인증 트리거 함수 생성

사용자가 처음 인증할 때 사용자 지정 사용자 객체를 생성하는 인증 트리거 함수를 만들어야 합니다. 이렇게 하려면 다음 단계를 따라 진행합니다.

1. Realm UI에 로그인한 다음 왼쪽 패널에서 Triggers를 클릭합니다.

2. Add a Trigger 버튼을 클릭합니다.

3. Trigger Type 토글을 Authentication 으로 설정합니다.

4. Triggers 세부 정보에서 다음 값을 지정합니다.

   • Name: "onUserCreated"

   • Enbaled: 토글을 "켜짐"으로 전환합니다.

   • Action Type: "만들기"를 선택합니다.

   • Provider(s): "이메일/비밀번호" 또는 사용 중인 인증 제공자를 선택합니다.

   • Select an Event Type: "기능"을 선택합니다.

   • Function: " +새 기능"을 선택합니다:

     • Function Name: "onUserCreated"

     • Function: 자리 표시자 텍스트를 다음 함수로 바꿉니다.

     exports = function(authEvent) {
         const user = authEvent.user;
         const collection = context.services.get("mongodb-atlas").db("Item").collection("User");
         const newDoc = {
           _id: user.id,
           email: user.data.email, // Useful for looking up user IDs by email later - assuming email/password auth is used
           team: "", // Used for tiered privileges
           isTeamAdmin: false, // Used for tiered privileges
           isGlobalAdmin: false, // Used for admin privileges
           subscribedTo: [], // Used for restricted feed
         };
         return collection.insertOne(newDoc);
     };

joinTeam 함수 생성

이제 팀에 사용자를 추가하는 기능이 필요합니다. 이 기능은 시스템 인증 하에서 실행되며 사용자 지정 사용자 데이터에 기록됩니다. 사용자가 처음 인증에 성공할 때 사용자 맞춤 데이터가 생성되었으므로 업서트를 수행하지 않습니다.

함수를 만들려면 다음 단계를 따르세요.

1. Realm UI에 로그인한 다음 왼쪽 패널에서 Functions를 클릭합니다.

2. Create New Function 버튼을 클릭합니다.

3. 다음 값을 지정합니다.

   • Name: "joinTeam"

   • Authentication: "System"

4. Function Editor 탭으로 전환하고 자리 표시자 텍스트를 다음 코드로 바꿉니다.

   exports = async function(userId, teamName) {
     const collection = context.services.get("mongodb-atlas")
       .db("Item").collection("User");
     const filter = { _id: userId };
     const update = { $set: { team: teamName }};
     const options = { upsert: false };
     return collection.updateOne(filter, update, options);
   };

권한 정의

다음 권한은 두 가지 역할을 지정합니다/

• teamAdmin은 사용자의 맞춤 데이터에 isTeamAdmin: true가 있는 경우에만 적용됩니다. 이 경우 사용자는 문서의 team 값이 사용자의 team 값과 일치하는 모든 문서를 읽고 쓸 수 있습니다.

• teamMember는 모든 사용자에게 적용됩니다. 사용자는 자신의 문서를 작성하고 문서의 team 값이 사용자의 team 값과 일치하는 모든 문서를 읽을 수 있습니다.

[
   {
     "name": "admin",
     "apply_when": {
       "%%user.custom_data.isTeamAdmin": true
     },
     "document_filter": {
       "read": {
         "team": "%%user.custom_data.team"
       },
       "write": {
         "team": "%%user.custom_data.team"
       }
     },
     "read": true,
     "write": true
   },
   {
     "name": "user",
     "apply_when": {},
     "document_filters": {
       "read": {
         "team": "%%user.custom_data.team"
       },
       "write": {
         "owner_id": "%%user.id"
       }
     },
     "read": true,
     "write": true
   }
]