AI 에이전트의 경우: 문서 인덱스는 https://www.mongodb.com/ko-kr/docs/llms.txt에서 사용할 수 있으며, 모든 페이지의 마크다운 버전은 어떤 URL 경로에 .md를 추가하여 사용할 수 있습니다.
Docs Menu

Atlas Data Federation 인증 방법

Atlas Data Federation은(는) 많은 인증 방법을 지원하므로 연합 데이터베이스 인스턴스에 연결할 수 있습니다. AWS IAM 자격 증명을 사용하여 AWS 환경에서 암호 없는 액세스할 수 있습니다. 또는 X.509 인증서를 사용하여 상호 TLS 인증을 수행할 수 있습니다. 구성 단계를 확인하려면 인증 방법을 선택합니다.

비밀번호를 관리하지 않고 AWS IAM 사용자 또는 역할을 사용하여 Atlas 클러스터에 데이터베이스 사용자를 인증할 수 있습니다. AWS IAM을 사용하면 관리해야 하는 인증 메커니즘의 수와 비밀의 수가 줄어들어요. Atlas는 유선을 통해 사용자의 인증 시크릿 키를 받지 않으며 드라이버는 이를 유지하지 않습니다.

사용 사례 에 적합한 인증 방법을 선택하세요.

  • IAM 역할: AWS 서비스(EC2, Lambda, ECS) 또는 연합 사용자가 맡는 역할입니다. AWS 컴퓨팅 리소스에서 실행 워크로드에 대한 애플리케이션 및 워크로드 액세스 에는 IAM 역할을 사용하는 것이 좋습니다.

  • IAM 사용자: 데이터베이스 직접 액세스 해야 하는 개별 AWS 사용자입니다. 이 옵션은 특정 사용자 자격 증명 으로 실행 애플리케이션에 적합할 수 있습니다. 개발자 및 관리자와 같은 인간 사용자의 경우 ID 제공자와의 직접 SSO 환경을 위해 OIDC와 함께 Workforce Identity Federation 을 사용하는 것이 좋습니다.

중요

클라이언트가 AWS IAM 데이터베이스 인증 사용하여 연결할 수 있으려면 먼저 IAM 인증 위해 구성된 데이터베이스 사용자를 생성해야 합니다. IAM Users 또는 IAM Roles 인증에 사용하는 데이터베이스 사용자를 생성하는 방법을 학습 보려면 데이터베이스 사용자 관리를 참조하세요.

참고

Atlas AWS STS 를 사용하여 IAM 사용자 및 역할의 ID를 확인합니다. AWS는 계정당, 리전당 초당 600 개의 요청이라는 기본값 요청 할당량을 시행합니다. 이 할당량은 IAM 사용자 또는 역할의 AWS 계정에 적용됩니다.

IAM Amazon Web Services Amazon Web Services 역할을 설정하다 Atlas 하여 cluster에 대해 컴퓨팅 유형을 인증할 수 있습니다.

참고

LDAP 권한 부여 활성화된 경우 Amazon Web Services IAM 주체에 대한 인증 설정하다 수 없습니다.

Amazon Web Services IAM 주체에 대한 인증 이 필요한 경우, Amazon Web Services IAM 인증 을 사용하여 액세스 하려는 클러스터를 LDAP 권한 부여 가 비활성화된 다른 프로젝트 로 이동하는 것이 좋습니다.

AWS Lambda 및 HTTP(ECS 및 EC2)의 경우 드라이버는 환경 변수에서 자동으로 읽습니다. AWS EKS의 경우 IAM 역할을 수동으로 할당해야 합니다.

이 페이지에서는 AWS Lambda, AWS ECS,AWS EKS 가 AWS IAM 역할을 사용하여 연결하는 방법을 설명합니다.

참고

AWS 콘솔에서 Lambda, EC, ECS 또는 EKS에 IAM 역할을 할당해야 합니다.2

Lambda 함수에 실행 역할을 할당하는 경우,Amazon Web Services Lambda는 다음 환경 변수를 통해 함수에 정보를 전달합니다.

  • AWS_ACCESS_KEY_ID

  • AWS_SECRET_ACCESS_KEY

  • AWS_SESSION_TOKEN

참고

함수에서 실행 역할을 사용하는 경우 이러한 환경 변수를 수동으로 만들 필요가 없습니다.

이러한 환경 변수에 대해 자세히 학습하려면 Amazon Web Services Lambda 환경 변수 사용을 참조하세요.

AWS IAM 역할에 데이터베이스 액세스 부여하려면 AWS IAM 의 데이터베이스 사용자 구성 섹션에 설명된 단계를 완료합니다. Atlas CLI, Atlas 관리 API 또는 Atlas UI 사용하여 데이터베이스 액세스 부여하는 방법에 대한 자세한 내용은 데이터베이스 사용자 구성을 참조하세요.

을(를) 사용하여 AWS IAM 자격 증명으로 Atlas에 mongosh 연결하려면 MongoDB-AWS 인증 메커니즘을 지정하는 연결 문자열 을 제공합니다. 이 연결 문자열 형식은 모든 AWS IAM 인증 메커니즘에 적용됩니다.

중요

이 연결 문자열 형식을 사용하려면 먼저 Amazon Web Services IAM 역할로 인증 설정 에 설명된 방법 중 하나를 사용하여 인증 구성해야 합니다.

mongosh와 AWS IAM 인증을 사용하여 Atlas에 연결하려면 shell 버전 v0.9.0 이상이 필요합니다.

다음 사항을 고려하세요:

  • 액세스 키 ID를 사용자 이름으로, 시크릿 키를 암호로 활용하여 AWS IAM 자격 증명을 사용하세요.

  • authSource 쿼리 매개변수는 $external이며, %24external로 URL 인코딩됩니다.

  • authMechanism 쿼리 매개변수는 MONGODB-AWS입니다.

    예시

    mongosh "mongodb+srv://<atlas-host-name>/test?authSource=%24external&authMechanism=MONGODB-AWS" --username <access-key-id> --password <secret-key>

X.509 인증서는 데이터베이스 사용자 에게 프로젝트의 클러스터에 대한 액세스를 제공합니다. 데이터베이스 사용자는 Atlas 사용자와 다릅니다. 데이터베이스 사용자는 MongoDB 데이터베이스에 액세스 할 수 있는 반면, Atlas 사용자는 Atlas 애플리케이션 자체에 액세스 할 수 있습니다.

X.509 인증서는 다음 유형 중 하나일 수 있습니다.

  • 자체 관리형 인증서. 자체 관리형 인증서를 사용하는 경우 인증 기관(CA)을 제공하고 데이터베이스 사용자를 위한 자체 인증서를 생성해야 합니다. 프로젝트 에서 자체 관리형 인증서를 설정하는 방법에 대한 자세한 내용은 공개 키 인프라를 사용하도록 프로젝트 구성 을 참조하세요.

  • Atlas 관리형 인증서. Atlas 관리형 인증서를 사용하면 Atlas 는 CA도 관리하고 데이터베이스 사용자를 위한 인증서를 생성합니다. Atlas 관리형 인증서로 추가 CA 구성을 처리하다 할 필요가 없습니다.

X.509 인증서를 자체 관리하려면 공개 키 인프라(PKI) 와 통합할 공개 키 인프라(PKI)가 있어야 합니다.

자체 관리형 X.509 인증서로 작업하기로 선택한 경우 제공한 PKI를 사용하도록 프로젝트 구성해야 합니다.

1
  1. 아직 표시되지 않은 경우 탐색 표시줄의 Organizations 메뉴에서 프로젝트가 포함된 조직을 선택합니다.

  2. 아직 표시되지 않은 경우 내비게이션 바의 Projects 메뉴에서 프로젝트를 선택합니다.

  3. 사이드바에서 Security 제목 아래의 Database & Network Access를 클릭합니다.

  4. 사이드바에서 Advanced를 클릭합니다.

    고급 페이지가 표시됩니다.

2

Self-Managed X.509 Authentication 를 ON로 전환합니다.

3

Atlas CLI를 사용하여 지정한 프로젝트에 대해 하나의 고객 관리형 X.509 구성을 저장하려면 다음 명령어를 실행합니다.

atlas security customerCerts create [options]

명령 구문 및 매개변수에 대한 자세한 내용은 Atlas CLI 문서에서 Atlas 보안 고객 인증서 생성을 참조하세요.

4

업로드한 후 CA를 수정하려면 Self-Managed X.509 Authentication Settings 을 클릭합니다. 아이콘입니다.

1
  1. 아직 표시되지 않은 경우 탐색 표시줄의 Organizations 메뉴에서 프로젝트가 포함된 조직을 선택합니다.

  2. 아직 표시되지 않은 경우 내비게이션 바의 Projects 메뉴에서 프로젝트를 선택합니다.

  3. 사이드바에서 Security 제목 아래의 Database & Network Access를 클릭합니다.

이전 단계를 완료하면 데이터베이스 & 네트워크 액세스 페이지가 표시됩니다.

2
  1. 아직 표시되지 않은 경우 Database Users 탭을 클릭합니다.

  2. 딸깍 하는 소리 Add New Database User.

3
4
필드
설명

Common Name

TLS/SSL 인증서로 보호되는 사용자의 일반 이름(CN)입니다. 자세한 내용은 RFC 2253 를 참조하세요.

예를 예시, 일반 이름이 "Jane Doe"이고, 조직 이 "MongoDB"이며, 국가가 "US" 인 경우 Common Name 필드 에 다음을 삽입합니다.

CN=Jane Doe,O=MongoDB,C=US

User Privileges

다음 중 한 가지 방법으로 역할을 할당할 수 있습니다:

내장 Atlas 권한에 대한 자세한 내용은 내장 역할.을 참조하세요.

권한 부여에 대한 자세한 내용은 MongoDB 매뉴얼의 Role-Based Access Control(역할 기반 액세스 제어) 및 Built-in Roles(내장 역할)를 참조하세요.

5
이 페이지 평가하기