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

고급 사용자 구성

사용 가능한 인증 방법을 포함하여 Atlas Data Federation의 데이터베이스 사용자에 대핕 고급 인증 및 권한 부여 설정에 대해 알아봅니다. Atlas CLI, Atlas Administration API 및 Atlas UI를 사용하여 사용자를 관리할 수 있습니다.

참고

Atlas는 기본적으로 Atlas 프로젝트당 최대 100명의 데이터베이스 사용자를 지원합니다. 프로젝트에 100명 이상의 데이터베이스 사용자가 필요한 경우 Atlas 관리 API 를 사용하여 한도를 늘릴 수 있습니다. 도움이 필요하면 Atlas 지원팀에 문의하세요.

고급 데이터베이스 사용자 구성을 사용하려면 Atlas 에서 Organization Owner, Project Owner 또는 Project Database Access Admin 액세스 있어야 합니다.

Atlas CLI, Atlas Administration API 또는 Atlas UI를 사용하여 Atlas Data Federation의 데이터베이스 사용자를 관리합니다.

Atlas Data Federation은 데이터베이스 사용자를 위해 다음과 같은 인증 형식을 제공합니다.

  • 비밀번호: SCRAM은 MongoDB의 기본 인증 방법입니다. SCRAM은 각 사용자에게 비밀번호를 요구합니다.

    SCRAM 인증 사용자를 위한 인증 데이터베이스는 admin 데이터베이스입니다.

    참고

    기본값 으로 Atlas SCRAM-SHA-256 인증 지원합니다. MongoDB 4.0 이전에 사용자를 생성한 경우, MongoDB 4.0을 업데이트 비밀번호를 업데이트 SCRAM-SHA-256 자격 증명 생성해야 합니다. 기존 비밀번호를 재사용할 수 있습니다.

    SCRAM 사용해야 하는 경우:

    인간 사용자 및 애플리케이션 사용자에 대해 SCRAM 인증 사용할 수 있습니다. 낮은 환경에서는 SCRAM 이 적합한 인증 방법입니다. 프로덕션 및 상위 환경의 경우, PAM(Privileged Access Management) 솔루션과의 통합과 같은 보안 권장사항 따라 비밀을 안전하게 단기적으로 보호하세요.

  • X.509 인증서: X.509 인증서는 상호 TLS 또는 mTLS라고도 하며 신뢰할 수 있는 인증서를 사용하여 암호 없는 인증을 허용합니다.

    X.509인증 사용자를 위한 인증 데이터베이스는 $external 데이터베이스입니다.

    LDAP 권한 부여를 활성화하면 Atlas managed X.509 인증서로 인증하는 사용자로 클러스터에 연결할 수 없습니다. LDAP를 활성화하고 X.509 사용자로 클러스터에 연결하려면 자체 관리형 X.509 인증서 설정을 참조하세요.

    X.509를 사용해야 하는 경우:

    X.509 인증 워크로드 ID 페더레이션(OIDC) 또는 AWS IAM 인증 불가능하거나 상호 인증 필요한 경우 안전한 워크로드 액세스 에 적합합니다.

  • OIDC: OIDC(OpenID Connect) 인증 외부 ID 제공자를 사용하여 암호 없는 와 비밀이 없는 인증 가능하게 합니다. Atlas 다음과 같은 유형의 OIDC 인증 지원합니다.

    OIDC 인증 사용자를 위한 인증 데이터베이스 는 $external 데이터베이스 입니다.

    OIDC 인증 MongoDB 버전 7.0 이상을 사용하는 클러스터에서만 사용할 수 있습니다.

    OIDC를 사용해야 하는 경우:

    인간 사용자의 경우 OIDC와 함께 Workforce Identity Federation을 사용하는 것이 좋습니다.

    애플리케이션 사용자의 경우 GCP 또는 Azure 에서 실행 애플리케이션에 OIDC와 함께 Workload Identity Federation을 사용하는 것이 좋습니다.

  • AWS IAM: AWS IAM 사용자 또는 역할 ARN을 인증 수단으로 사용하는 데이터베이스 사용자를 생성할 수 있습니다.

    AWS IAM 인증 사용자를 위한 인증 데이터베이스는 $external 데이터베이스입니다.

    AWS IAM을 사용해야 하는 경우:

    AWS에서 실행 애플리케이션 사용자에 대해서는 IAM 역할과 함께 AWS IAM 인증 사용하는 것이 좋습니다.

프로젝트에는 다양한 인증 방법을 사용하는 사용자가 있을 수 있습니다.

사용자의 인증 방법은 생성 시 고정됩니다. 다른 인증 방법을 사용하려면 새 사용자를 생성하세요.

Atlas CLI는 다음 명령어를 사용하여 새 데이터베이스 사용자와 X.509 인증서를 생성합니다. 지정하는 옵션에 따라 인증 방법이 결정됩니다.

Atlas CLI를 사용하여 프로젝트에 대한 데이터베이스 사용자를 생성하려면 다음 명령어를 실행하세요.

atlas dbusers create [builtInRole]... [options]

Atlas CLI를 사용하여 지정된 데이터베이스 사용자에 대한 새 Atlas 관리 X.509 인증서를 생성하려면 다음 명령어를 실행하십시오.

atlas dbusers certs create [options]

이전 명령의 구문과 매개변수에 대한 자세한 내용은 Atlas CLI 문서에서 Atlas dbusers 생성 및 Atlas dbusers CERT를 참조하세요.

팁

참조: 관련 링크

Atlas Administration API를 통해 데이터베이스 사용자를 추가할 수 있습니다. 지정하는 옵션에 따라 인증 방법이 결정됩니다. 자세한 내용은 단일 데이터베이스 사용자 생성을 참조하세요.

인증 메커니즘을 선택하고 단계에 따라 Atlas UI를 사용하여 새 데이터베이스 사용자를 생성합니다.

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

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

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

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

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

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

3

Add New Database User 모달 창의 Authentication Method 섹션에서 Password로 레이블이 지정된 상자를 선택합니다.

4

Password Authentication 아래에는 두 개의 텍스트 필드가 있습니다.

  1. 상단 텍스트 필드에 새 사용자의 사용자 이름을 입력합니다.

  2. 하단 텍스트 필드에 새 사용자의 비밀번호를 입력합니다.

Atlas에서 자동 생성된 비밀번호를 사용하려면 Autogenerate Secure Password 버튼을 클릭합니다.

5

데이터베이스 사용자 권한을 선택합니다. 다음 중 한 가지 이상의 방법으로 새 사용자에게 권한을 할당할 수 있습니다.

  • Built-in Role 드롭다운 메뉴에서 내장 역할을 선택합니다. Atlas UI에서 데이터베이스 사용자당 하나의 내장 역할을 선택할 수 있습니다. 기본 옵션을 삭제하는 경우 Add Built-in Role을 클릭하여 새 내장 역할을 선택할 수 있습니다.

  • 사용자 지정 역할이 정의되어 있는 경우에는 Custom Roles 섹션을 펼치고 Custom Roles 드롭다운 메뉴에서 하나 이상의 역할을 선택할 수 있습니다. Add Custom Role을 클릭하여 사용자 지정 역할을 추가합니다. Custom Roles 링크를 클릭하여 프로젝트의 사용자 지정 역할을 볼 수도 있습니다.

  • Specific Privileges 섹션을 확장하고 Specific Privileges 드롭다운 메뉴에서 하나 이상의 권한을 선택합니다. 권한을 더 추가하려면 Add Specific Privilege를 클릭합니다. 이렇게 하면 개별 데이터베이스 및 컬렉션에 대한 사용자별 권한이 할당됩니다.

Atlas는 단일 데이터베이스 사용자에게 내장 역할, 여러 사용자 지정 역할, 여러 특정 권한을 적용할 수 있습니다.

적용된 역할 또는 권한을 제거하려면 삭제하려는 역할 또는 권한 옆에 있는 Delete를 클릭합니다.

참고

Atlas는 하나의 옵션만 선택한 경우 Built-in Role, Custom Role 또는 Specific Privilege 선택 항목 옆에 Delete 아이콘을 표시하지 않습니다. 다른 역할이나 권한을 적용한 후에는 선택한 역할이나 권한을 삭제할 수 있습니다.

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

6

기본적으로 사용자는 프로젝트의 모든 클러스터 및 연합 데이터베이스 인스턴스에 액세스할 수 있습니다. 다음을 수행하면 특정 클러스터 및 연합 데이터베이스 인스턴스에 대한 액세스를 제한할 수 있습니다.

  1. Restrict Access to Specific Clusters/Federated Database Instances 를 ON로 전환합니다.

  2. Grant Access To 목록에서 사용자 액세스 권한을 부여할 클러스터 및 연합 데이터베이스 인스턴스를 선택합니다.

7

Temporary User에서 On(으)로 토글하고 Atlas가 Temporary User Duration 드롭다운에서 사용자를 삭제할 수 있는 시간을 선택합니다. 사용자가 존재할 다음 기간 중 하나를 선택할 수 있습니다.

  • 6시간

  • 1일

  • 1주

Database Users 탭에서 임시 사용자는 Atlas가 사용자를 삭제할 때까지 남은 시간을 표시합니다. Atlas가 사용자를 삭제하면 임시 사용자의 자격 증명을 사용하는 모든 클라이언트 또는 애플리케이션은 클러스터에 액세스할 수 없게 됩니다.

8

Atlas CLI를 사용하여 프로젝트의 모든 Atlas 데이터베이스 사용자를 나열하려면 다음 명령어를 실행하십시오.

atlas dbusers list [options]

Atlas CLI를 사용하여 지정한 프로젝트에서 단일 Atlas 데이터베이스 사용자에 대한 세부 정보를 반환하려면 다음 명령어를 실행합니다.

atlas dbusers describe <username> [options]

이전 명령의 구문 및 매개변수에 대해 자세히 알아보려면 Atlas CLI 문서에서 Atlas dbusers 목록 및 Atlas dbusers 설명을 참조하세요.

팁

참조: 관련 링크

Atlas CLI를 사용하여 데이터베이스 사용자에 대해 만료되지 않은 모든 Atlas 관리 인증서를 나열하려면 다음 명령어를 실행합니다.

atlas dbusers certs list <username> [options]

명령 구문 및 매개변수에 관한 자세한 사항은 Atlas CLI 문서에서 Atlas dbusers CERT 목록을 참조하세요.

Atlas Administration API로 Atlas 데이터베이스 사용자를 보려면 모두 가져오기를 참조하세요.

Atlas UI에서 Atlas 데이터베이스 사용자 및 X.509 인증서를 보려면 다음을 수행합니다.

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

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

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

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

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

  2. 사용자가 권한, 인증 세부 정보 및 X.509 인증서를 보려면 Edit을 클릭합니다.

Atlas CLI를 사용하여 프로젝트에서 데이터베이스 사용자를 삭제하려면 다음 명령어를 실행하십시오.

atlas dbusers update <username> [options]

명령 구문 및 매개변수에 관한 자세한 사항은 Atlas CLI 문서에서 Atlas dbusers 업데이트를 참조하세요.

Atlas 관리 API를 통해 데이터베이스 사용자를 업데이트할 수 있습니다. 자세한 내용은 업데이트 1을 참조하세요.

Atlas 프로젝트의 기존 사용자를 수정하려면 다음을 수행합니다.

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

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

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

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

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

  2. 수정하려는 사용자에 대해 Edit을(를) 클릭합니다.

    사용자에게 할당된 권한 및 인증 세부 정보를 수정할 수 있습니다. 인증 방법은 수정할 수 없습니다.

    다음 표에서는 각 사용자에 대해 수행할 수 있는 작업을 설명합니다.

    사용자 유형
    작업

    SCRAM 인증 사용자

    사용자의 비밀번호를 수정합니다.

    X.509 인증서 인증 사용자

    새 인증서를 다운로드합니다.

    AWS IAM 사용자

    데이터베이스 액세스 권한을 수정합니다.

    임시 사용자

    사용자의 만료일이 아직 지나지 않았다면 사용자가 존재하는 기간을 수정하거나 사용자를 영구 사용자로 설정합니다.

    참고

    영구 사용자를 임시 사용자로 변경할 수 없습니다. 임시 사용자를 영구 사용자로 변경하면 다시 임시 사용자로 만들 수 없습니다.

  3. Update User을 클릭해 변경 사항을 저장합니다.

Atlas CLI를 사용하여 프로젝트에서 데이터베이스 사용자를 삭제하려면 다음 명령어를 실행하세요.

atlas dbusers delete <username> [options]

명령 구문 및 매개변수에 관한 자세한 사항은 Atlas CLI 문서에서 Atlas dbusers 삭제를 참조하세요.

Atlas Administration API를 통해 데이터베이스 사용자를 삭제할 수 있습니다. 자세한 내용은 단일 삭제를 참조하세요.

Atlas UI를 사용하여 Atlas 프로젝트의 기존 사용자를 삭제하려면 다음을 수행합니다.

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

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

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

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

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

  2. 삭제하려는 사용자 옆의 Delete을(를) 클릭합니다.

  3. 다시 Delete을(를) 클릭하여 확인합니다.