사용자 지정 사용자 메타데이터 정의

사용자 지정 사용자 데이터 구성 화면으로 이동

왼쪽 탐색 메뉴에서 App Users 를 클릭합니다. 그런 다음 User Settings 탭 을 선택하고 Custom User Data 섹션을 찾습니다.

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

Enable Custom User Data 토글을 클릭하여 On(으)로 설정합니다.

클릭하여 확대

사용자 지정 사용자 데이터 컬렉션 지정

애플리케이션 사용자에 대한 사용자 지정 데이터를 연결된 MongoDB Atlas 클러스터의 단일 collection에 저장해야 합니다. 이 collection에서 사용자 데이터를 읽도록 애플리케이션을 구성하려면 다음 값을 지정해야 합니다.

• Cluster Name: 사용자 지정 사용자 데이터 컬렉션 을 포함하는 연결된 MongoDB cluster 의 이름입니다.

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

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

클릭하여 확대

사용자 ID 필드 지정

사용자 지정 사용자 데이터 컬렉션의 모든 문서에는 해당 문서를 특정 애플리케이션 사용자에 매핑하는 필드가 있습니다. 필드는 ObjectID 유형이거나 해당 ObjectID를 나타내는 string 유형이어야 합니다. 이 필드는 사용자에게 매핑되는 모든 문서에 포함되어야 합니다.

User ID Field 입력란에 각 사용자의 ID가 포함된 필드의 이름을 지정합니다.

사용자 생성 함수 정의(선택 사항)

사용자 생성 함수 를 사용하려면 인라인 편집기에서 정의하거나 이름으로 기존 함수를 참조하세요.

업데이트된 애플리케이션 배포

사용자 지정 사용자 데이터 컬렉션을 구성한 후에는 애플리케이션을 배포하여 클라이언트 애플리케이션에서 사용자 지정 사용자 데이터를 사용할 수 있도록 설정할 수 있습니다. App Services UI에서 초안 애플리케이션을 배포하려면 다음을 수행합니다.

1. 왼쪽 탐색 패널에서 Deploy 을 클릭합니다.

2. 배포서버 기록 테이블에서 초안을 찾은 다음 Review & Deploy Changes을 클릭합니다.

3. 변경 사항의 차이를 검토한 다음 Deploy을(를) 클릭합니다.

애플리케이션이 성공적으로 배포되면 App Services는 사용자 지정 데이터를 사용자와 연결하기 시작합니다. 사용자가 로그인하면 App Services는 지정된 User ID Field에 사용자 ID가 포함된 문서에 대해 사용자 지정 사용자 데이터 컬렉션을 자동으로 쿼리합니다. 문서가 일치하는 경우 App Services는 해당 사용자의 사용자 객체의 custom_data 필드에 문서의 데이터를 노출합니다.

앱의 최신 버전 가져오기

appservices로 사용자 지정 사용자 데이터 를 정의하려면 애플리케이션 구성 파일의 로컬 복사본이 필요합니다.

최신 버전의 앱의 로컬 사본을 가져오려면 다음을 실행하세요.

appservices pull --remote="<Your App ID>"

사용자 지정 사용자 데이터 구성

애플리케이션 사용자에 대한 사용자 지정 데이터를 연결된 Atlas cluster 의 단일 컬렉션 에 저장 해야 합니다. 컬렉션 의 모든 문서 에는 해당 문서에서 설명하는 App Services 사용자의 사용자 ID 가 포함된 특정 필드 가 포함되어야 합니다.

이 컬렉션 에서 사용자 데이터를 읽도록 애플리케이션 을 구성하려면 /auth/custom_user_data.json 에서 사용자 지정 사용자 데이터 구성 문서 를 정의합니다.

{
  "enabled": <Boolean>,
  "mongo_service_name": "<MongoDB Data Source Name>",
  "database_name": "<Database Name>",
  "collection_name": "<Collection Name>",
  "user_id_field": "<User ID Field Name>",
  "on_user_creation_function_name": "<Function Name>"
}

사용자 지정 사용자 데이터 구성 배포

사용자 지정 사용자 데이터 를 구성한 후에는 업데이트된 구성을 원격 앱 에 푸시할 수 있습니다. App Services CLI 는 푸시 시 업데이트 를 즉시 배포합니다.

appservices push --remote="<Your App ID>"

인증 제공자 구성 화면으로 이동

App Services UI에서 사용자 메타데이터를 구성하고 활성화할 수 있습니다. 구성 페이지로 이동하려면 다음을 따릅니다:

• 왼쪽 탐색 패널에서 Authentication 을 클릭합니다.

• 0}Authentication Providers 탭을 선택합니다.

• 구성하려는 메타데이터가 있는 제공자의 EDIT 버튼을 누르세요.

사용자 메타데이터 구성

Google 또는 Facebook

활성화하려는 메타데이터 필드 옆에 있는 확인란을 선택합니다.

클릭하여 확대

사용자 지정 JWT 인증

멱등이 지원하는 메타데이터 필드를 지정할 수 있습니다. Add Field 버튼을 누른 후 정의합니다:

• 경로

• 필드 이름

• 필드가 선택 사항인지 필수 사항인지 여부

자세한 내용은 JWT 메타데이터 필드를 참조하십시오.

클릭하여 확대

액세스하려는 메타데이터를 구성한 후 Save Draft 버튼을 누르세요.

업데이트된 애플리케이션 배포

메타데이터 구성을 업데이트한 후에는 애플리케이션을 배포해야 합니다. App Services UI에서 초안 애플리케이션을 배포하려면 다음을 수행합니다.

1. 왼쪽 탐색 패널에서 Deploy 을 클릭합니다.

2. 배포서버 기록 테이블에서 초안을 찾은 다음 Review & Deploy Changes을 클릭합니다.

3. 변경 사항의 차이를 검토한 다음 Deploy을(를) 클릭합니다.

애플리케이션이 성공적으로 배포되면 App Services는 메타데이터를 사용자와 연결하기 시작합니다. 사용자가 로그인하면 App Services는 요청된 메타데이터에 액세스할 수 있는 권한을 사용자에게 요청합니다. 사용자가 승인하면 App Services는 해당 사용자의 사용자 객체에 있는 데이터를 노출합니다.

앱의 최신 버전 가져오기

appservices로 앱 을 업데이트 하려면 구성 파일의 로컬 복사본이 필요합니다.

최신 버전의 앱의 로컬 사본을 가져오려면 다음을 실행하세요.

appservices pull --remote="<Your App ID>"

메타데이터 필드 구성

/auth/providers.json 에서 앱 에 대한 인증 제공자 metadata_fields 를 찾을 수 있습니다. 인증 제공자 에게 사용자 메타데이터 를 요청 하려면 이 배열 을 업데이트합니다.

Google 또는 Facebook

이 배열 은 다음과 유사합니다.

{ ...other config details...
  "metadata_fields": [
    {
      "required": false,
      "name": "name"
    },
    {
      "required": false,
      "name": "gender"
    }
  ]
}

사용자 지정 JWT 인증

metadata_fields 배열 에는 추가 속성field_name 이(가) 있습니다. 사용자 지정 JSON web token 인증 에서 name 는 필드 의 경로를 나타냅니다. field_name 는 필드 의 이름을 나타냅니다.

{ ...other config details...
  "metadata_fields": [
    {
      "required": true,
      "name": "user.name",
      "field_name": "name"
    },
    {
      "required": false,
      "name": "user.favoriteColor",
      "field_name": "favoriteColor"
    }
  ]
}

사용자 지정 사용자 데이터 구성 배포

사용자 지정 사용자 데이터 를 구성한 후에는 업데이트된 구성을 원격 앱 에 푸시할 수 있습니다. App Services CLI 는 푸시 시 업데이트 를 즉시 배포합니다.

appservices push --remote="<Your App ID>"

MongoDB Atlas 사용자 인증하기

MongoDB Atlas API 키 쌍을 사용하여 관리자 사용자 인증 엔드포인트를 호출합니다.

curl -X POST \
  https://services.cloud.mongodb.com/api/admin/v3.0/auth/providers/mongodb-cloud/login \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{
    "username": "<Public API Key>",
    "apiKey": "<Private API Key>"
  }'

인증 이 성공하면 응답 본문에 access_token 값을 가진 JSON 객체 가 포함됩니다.

{
  "access_token": "<access_token>",
  "refresh_token": "<refresh_token>",
  "user_id": "<user_id>",
  "device_id": "<device_id>"
}

access_token 은(는) App Services Admin API 에 대한 액세스 을 부여합니다. 모든 관리자 API 요청에 대해 Authorization 헤더에 베어러 토큰으로 포함해야 합니다.

메타데이터 필드 구성

인증 제공자 업데이트 엔드포인트에 요청 을 보냅니다. 요청 본문에서 제공자 에 대해 metadata_fields 를 정의합니다.

관리자 API access_token, 앱이 포함된 Atlas 프로젝트 의 groupId, 앱의 내부 appId 16진수 string 및 인증 제공자 의 _id 값을 포함해야 합니다.

curl --request PATCH 'https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps/{appId}/auth_providers/{providerId}' \
  --header 'Authorization:  Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "_id": "<Provider ID>",
    "name": "oauth2-facebook",
    "type": "oauth2-facebook",
    "redirect_uris": ["https://example.com/"],
    "config": {
      "clientId": "<Facebook Client ID>"
    },
    "secret_config": {
      "clientSecret": "<Facebook Client Secret Name>"
    },
    "metadata_fields": [
      { "required": false, "name": "name" },
      { "required": true, "name": "first_name" },
      { "required": true, "name": "last_name" },
      { "required": false, "name": "picture" },
      { "required": false, "name": "gender" },
      { "required": false, "name": "birthday" },
      { "required": false, "name": "min_age" },
      { "required": false, "name": "max_age" },
      { "required": false, "name": "email" }
    ],
    "disabled": false
  }'

curl --request PATCH 'https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps/{appId}/auth_providers/{providerId}' \
  --header 'Authorization:  Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "_id": "<Provider ID>",
    "name": "oauth2-google",
    "type": "oauth2-google",
    "redirect_uris": ["https://example.com/"],
    "config": {
      "clientId": "<Google Client ID>"
    },
    "secret_config": {
      "clientSecret": "<Google Client Secret Name>"
    },
    "metadata_fields": [
      { "required": false, "name": "name" },
      { "required": true, "name": "first_name" },
      { "required": true, "name": "last_name" },
      { "required": false, "name": "picture" },
      { "required": false, "name": "gender" },
      { "required": false, "name": "birthday" },
      { "required": false, "name": "min_age" },
      { "required": false, "name": "max_age" },
      { "required": false, "name": "email" }
    ],
    "disabled": false
  }'

curl --request PATCH 'https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps/{appId}/auth_providers/{providerId}' \
  --header 'Authorization:  Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "_id": "<Provider ID>",
  "name": "custom-token",
  "type": "custom-token",
  "metadata_fields": [
    {
      "required": true,
      "name": "jwt.field.path",
      "field_name": "metadataFieldName"
    }
  ],
  "config": {
    "audience": [],
    "requireAnyAudience": false,
    "signingAlgorithm": "HS256",
    "useJWKURI": false
  },
  "secret_config": {
    "signingKeys": [
      "<JWT Signing Key>"
    ]
  },
  "disabled": true
  }'

제공자의 메타데이터 필드를 성공적으로 구성하면 App Services 는 204 응답을 반환합니다.