참고: 프로젝트 ID와 그룹 ID라는 용어는 서로 바꿔 사용할 수 있습니다.

Atlas App Services 관리자 API 엔드포인트의 경우 URL에 두 개의 매개변수를 포함해야 하는 경우가 많습니다.

• Atlas 프로젝트 ID(그룹 ID라고도 함)
• App Services 애플리케이션 ID

프로젝트 ID

프로젝트 ID는 MongoDB Atlas 대시보드 또는 MongoDB Atlas CLI에서 찾을 수 있습니다.

애플리케이션 ID

애플리케이션 ID를 찾으려면 프로젝트의 앱 나열 엔드포인트에 요청합니다. 이 요청을 하려면 access_token이 필요합니다. 토큰 획득 방법을 알아보려면 관리자 API 세션 액세스 토큰 가져오기를 참조하세요.

curl --request GET \
  --header 'Authorization: Bearer <access_token>' \
  https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps

그러면 제공된 프로젝트/그룹의 각 App Services 앱을 설명하는 객체 목록이 반환됩니다. 관리자 API 요청의 경우 애플리케이션 ID는 client_app_id가 아니라 _id 필드의 ObjectId 값입니다.

[
  {
    "_id": "5997529e46224c6e42gb6dd9",
    "group_id": "57879f6cc4b32dbe440bb8c5",
    "domain_id": "5886619e46124e4c42fb5dd8",
    "client_app_id": "myapp-abcde",
    "name": "myapp",
    "location": "US-VA",
    "deployment_model": "GLOBAL",
    "last_used": 1615153544,
    "last_modified": 0,
    "product": "standard",
    "environment": ""
  }
]

App Services 관리자 API에 대한 모든 요청에는 MongoDB 클라우드 API에서 발급한 유효하고 만료되지 않은 액세스 토큰이 포함되어야 합니다. 베어러 인증 체계를 사용하여 각 요청의 Authorization 헤더에 이 토큰을 포함합니다.

토큰을 가져오려면 MongoDB Atlas에 유효한 MongoDB Atlas 프로그래밍 방식 API 키가 필요합니다.

API 키 쌍이 준비되면 인증 엔드포인트를 호출합니다.

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

인증이 성공하면 App Services는 JSON 응답 문서의 일부로 액세스 토큰을 반환합니다.

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

access_token은 관리자 API와 상호 작용할 수 있는 한시적 권한을 나타냅니다. 요청을 인증하려면 베어러 토큰 Authorization 헤더에 토큰을 포함합니다.

Authorization: Bearer <access_token>

세션 액세스 토큰은 발급된 후 30분 후에 만료됩니다. 로그인하면 응답에 새 액세스 토큰을 얻는 데 사용할 수 있는 refresh_token도 포함됩니다. 자격 증명을 사용하여 한 번만 로그인하면 되기 때문에 유용합니다. 그 후에는 새로 고침 토큰을 사용하여 토큰이 유효한 기간 동안 재인증할 수 있습니다.

기본적으로 새로 고침 토큰은 발행 후 60일 후에 만료됩니다. 새로 고침 토큰 만료를 최소 30분 또는 최대 5년으로 사용자 지정할 수 있습니다.

인증을 새로 고치고 새 access_token을 가져오려면 Authorization 헤더에 refresh_token을 사용하여 인증 세션 엔드포인트를 호출합니다.

curl --request POST \
  --header 'Authorization: Bearer <refresh_token>' \
  https://services.cloud.mongodb.com/api/admin/v3.0/auth/session

새로 고침 토큰이 유효한 경우 응답 본문에는 다음 30분 동안 유효한 새 access_token이 포함됩니다.

{
  "access_token": "<access_token>"
}

로그인하여 App Services 앱을 관리합니다.

API 키 제공자를 통해 API 키를 보고 관리합니다.

Atlas 프로젝트에서 애플리케이션을 보고 관리합니다.

인증 제공자를 보고 관리합니다.