Docs Menu
Docs Home
/
MongoDB Atlas
/
미국 정부 기관 위한 MongoDB Atlas
/
AtlasGov 프로그래밍 방식 액세스

API

이 페이지의 내용

  • 사용 예시
  • Atlas 문서 참조
  • 프로젝트 만들기
  • Atlas for Government 고려 사항
  • 데이터베이스 사용자
  • 클러스터
  • 알림
  • 타사 통합 설정
  • 클라우드 백업
  • Flex 및 공유 클러스터 스냅샷 및 복원 작업
  • 온라인 아카이브
  • 네트워크 피어링
  • 비공개 엔드포인트
  • 모니터링 및 로그
  • 고객 키 관리를 사용한 미사용 암호화
  • Atlas 사용자
  • Atlas Stream Processing
  • 트리거

정부 기관 API 용 MongoDB Atlas는 다음 기본 URL을 사용한다는 점을 제외하고 Atlas API 와 동일한 방식으로 작동합니다.

https://cloud.mongodbgov.com/api/atlas/v2

AtlasGov는 HTTP 다이제스트 인증 을 사용하여 로 API요청을 인증합니다.SHA-256

사용 예시

이 curl 예시에서는 프로젝트의 데이터베이스 사용자를 검색합니다.

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --header "Accept: application/vnd.atlas.2023-01-01+json" \ # update date to desired API version
  --include \
  --request GET "https://cloud.mongodbgov.com/api/atlas/v2/groups/{PROJECT-ID}/databaseUsers?pretty=true"

  • Project Settings 에서 PROJECT-ID 을 찾을 수 있습니다.

  • 조직의 Access Manager API Keys 탭 아래에서 API 키 쌍을 생성할 수 있습니다.

Atlas 문서 참조

프로젝트 만들기

프로젝트 생성 시 표준 또는 정부(gov) 리전 사용에 대한 프로젝트를 지정해야 합니다. 동일한 프로젝트에서 정부 및 표준 리전에 클러스터를 배포할 수 없습니다.

기본적으로 AtlasGov API는 표준 리전 사용에 대한 새 프로젝트를 지정합니다.

API를 사용하여 정부 리전을 위한 프로젝트를 생성하려면 POST 요청 데이터에 다음을 포함하세요.

"regionUsageRestrictions" : "GOV_REGIONS_ONLY"

팁

Atlas 문서

요청 예시 를 포함하여 API 를 사용하여 프로젝트 를 만드는 방법에 대한 자세한 내용은 프로젝트 1개 만들기를 참조하세요.

Atlas for Government 고려 사항

다음 cloud 공급자, MongoDB 제품 및 기능은 모든 API 리소스에서 사용할 수 없습니다.

  • Azure

  • Atlas Data Lake

  • Atlas Online Archives

  • Atlas 트리거

  • MongoDB 차트

  • Atlas Device SDK

  • 무료, 공유, Flex 및 M10 클러스터

많은 상용 Atlas API 리소스가 제한되거나 사용할 수 없습니다.

데이터베이스 사용자

SCRAM 으로 인증하는 데이터베이스 사용자는 SCRAM-SHA-256 를 사용해야 합니다.

클러스터

AtlasGov 클러스터는 계층 M20 이상이어야 합니다. Atlas 는 무료, flex 및 공유 클러스터를 지원 하지 않습니다.

알림

  • 결제 수단과 관련된 경고는 사용할 수 없습니다.

  • 경고는 여러 개의 서로 다른 이메일 주소에서 발송될 수 있습니다. 자세한 내용은 경고 및 커뮤니케이션을 참조하세요.

타사 통합 설정

타사 모니터링 통합을 구성하려면 Project Owner 역할이 있어야 합니다.

Datadog

AtlasGov는 Datadog과 통합될 경우 Datadog for Government 사이트(US1-FED)를 사용합니다.

미국1-FED에 대해 자세히 알아보려면 Datadog 문서를 참조하세요.

클라우드 백업

표준 프로젝트와 Gov 리전 전용 프로젝트 간의 복원은 허용되지 않습니다. Gov 리전 전용(Amazon Web Services GovCloud 또는 GCP Assuring Workloads) 프로젝트 의 클러스터 에서 백업 을 생성한 경우, 데이터는 Gov 리전 전용 프로젝트 의 클러스터 로만 복원할 수 있습니다. 표준 리전의 백업을 표준 프로젝트의 클러스터로만 복원할 수 있는 표준 프로젝트에도 동일한 제한 사항이 적용됩니다.

Amazon Web Services GovCloud와 GCP Assured Workloads 리전 간에 클라우드 간 복원 이 지원됩니다.

Flex 및 공유 클러스터 스냅샷 및 복원 작업

Flex 및 공유 클러스터는 AtlasGov에서 사용할 수 없습니다.

온라인 아카이브

AtlasGov에서는 Online Archive를 사용할 수 없습니다.

네트워크 피어링

  • Amazon Web Services GovCloud 리전의 MongoDB cluster와만 Amazon Web Services GovCloud 리전을 Peering할 수 있습니다. Amazon Web Services 표준 리전의 MongoDB cluster와만 Amazon Web Services 표준 리전을 Peering할 수 있습니다.

  • GCP 보장 워크로드 리전의 MongoDB 클러스터와만 GCP 보장 워크로드 리전을 피어링할 수 있습니다.

비공개 엔드포인트

  • Amazon Web Services GovCloud 리전은 Amazon Web Services GovCloud 리전의 MongoDB cluster와만 연결할 수 있습니다. Amazon Web Services 표준 리전은 Amazon Web Services 표준 리전의 MongoDB cluster에만 연결할 수 있습니다.

  • GCP Assuring Workloads 리전은 GCP Assuring Workloads 리전의 MongoDB cluster와만 연결할 수 있습니다.

모니터링 및 로그

표준 Atlas 로깅 외에도 AtlasGov는 모든 로그인 시도 실패, 임시 잠금 및 API 다이제스트 인증 실패와 관련된 사용자 이름 및 IP 주소를 기록합니다.

고객 키 관리를 사용한 미사용 암호화

  • Amazon Web GovCloud 및 Assuring KMS Workloads 리전 전용 프로젝트의 데이터를 암호화하려면 Amazon Web Services GCP Amazon Web Services GovCloud 및 GCP Assuring Workloads 리전에서 키를 사용해야 합니다. Standard 리전 전용 프로젝트의 데이터를 암호화하려면 Standard 리전의 KMS 키를 사용해야 Amazon Web Services Amazon Web Services 합니다.

Atlas 사용자

정부 기관 사용자를 위한 MongoDB Atlas는 만들 수 없습니다. MongoDB Atlas for Government는 초대를 통해서만 사용할 수 있습니다.

Atlas Stream Processing

AtlasGov에서는 Atlas Stream Processing을 사용할 수 없습니다.

트리거

AtlasGov에서는 Atlas Triggers를 사용할 수 없습니다.

돌아가기

보안

다음

AtlasGov 프로그래밍 방식 액세스