db.createUser() (mongosh 메서드)

정의

db.createUser(user, writeConcern)

메서드가 실행 데이터베이스 에 대한 새 사용자를 만듭니다. db.createUser() 사용자가 데이터베이스 에 이미 존재하는 경우 는 중복 사용자 오류를 반환합니다.

중요

Mongo쉬 방법

이 페이지에서는 mongosh 메서드를 설명합니다. 이는 데이터베이스 명령 또는 Node.js와 같은 언어별 드라이버에 대한 설명서가 아닙니다.

데이터베이스 명령의 경우 createUser 명령을 참조하세요.

MongoDB API 드라이버의 경우 언어별 MongoDB 드라이버 설명서를 참조하세요.

createUser() 의 구문은 다음과 같습니다:

필드	유형	설명
user	문서	생성할 사용자에 대한 인증 및 액세스가 포함된 문서입니다.
writeConcern	문서	선택 사항입니다. 작업에 대한 쓰기 고려 수준입니다. 쓰기 고려 사양을 참조하세요.

user 문서는 사용자를 정의하며 다음과 같은 형식을 가집니다.

팁

메서드/명령 호출에서 암호를 직접 지정하는 대신 passwordPrompt() 메서드를 다양한 사용자 인증/관리 메서드/명령과 함께 사용하여 암호를 묻는 메시지를 표시할 수 있습니다. 그러나 이전 버전의 mongo 셸에서와 마찬가지로 비밀번호를 직접 지정할 수도 있습니다.

{
  user: "<name>",
  pwd: passwordPrompt(),      // Or  "<cleartext password>"
  customData: { <any information> },
  roles: [
    { role: "<role>", db: "<database>" } | "<role>",
    ...
  ],
  authenticationRestrictions: [
     {
       clientSource: ["<IP>" | "<CIDR range>", ...],
       serverAddress: ["<IP>" | "<CIDR range>", ...]
     },
     ...
  ],
  mechanisms: [ "<SCRAM-SHA-1|SCRAM-SHA-256>", ... ],
  passwordDigestor: "<server|client>"
}

user 문서에 다음과 같은 필드가 있습니다:

필드	유형	설명
user	문자열	새 사용자의 이름입니다.
pwd	문자열	사용자의 비밀번호입니다. $external 데이터베이스 에서 db.createUser() 를 실행 자격 증명 MongoDB 외부에 저장된 사용자를 생성하는 경우 pwd 필드 필요하지 않습니다. 값은 다음 중 하나일 수 있습니다. 일반 텍스트 문자열로 된 사용자의 비밀번호 passwordPrompt() 은(는) 사용자의 비밀번호를 묻는 메시지를 표시합니다. 메서드/명령 호출에서 암호를 직접 지정하는 대신 passwordPrompt() 메서드를 다양한 사용자 인증/관리 메서드/명령과 함께 사용하여 암호를 묻는 메시지를 표시할 수 있습니다. 그러나 이전 버전의 mongo 셸에서와 마찬가지로 비밀번호를 직접 지정할 수도 있습니다.
customData	문서	선택 사항. 사용자의 전체 이름 또는 직원 ID 와 같이 사용자와 연결하려는 임의의 정보입니다.
roles	배열	사용자에게 부여된 역할입니다. 빈 배열 []을 지정하여 역할이 없는 사용자를 만들 수 있습니다.
authenticationRestrictions	배열	선택 사항입니다. 서버가 생성된 사용자에게 시행하는 인증 제한 사항입니다. 사용자가 서버에 연결할 수 있거나 서버가 사용자를 받아들일 수 있는 IP 주소 및 CIDR 범위의 목록을 지정합니다.
mechanisms	배열	선택 사항입니다. SCRAM 사용자 자격 증명을 생성하기 위한 특정 SCRAM 메커니즘(1개 또는 여러 개)을 지정합니다. authenticationMechanisms를 지정하면 authenticationMechanisms의 하위 집합만 지정할 수 있습니다. 유효한 값은 다음과 같습니다. "SCRAM-SHA-1" SHA-1 해시 함수를 사용합니다. "SCRAM-SHA-256" SHA-256 해시 함수를 사용합니다. passwordDigestor가 server여야 합니다. 기본값은 SCRAM-SHA-1과 SCRAM-SHA-256 모두입니다.
passwordDigestor	문자열	선택 사항입니다. 서버 또는 클라이언트 중 어느 쪽에서 비밀번호를 해독할지를 나타냅니다. 사용 가능한 값은 다음과 같습니다. "server" (기본값) 서버는 클라이언트로부터 다이제스트되지 않은 비밀번호를 수신하여 비밀번호를 다이제스트합니다. "client" (SCRAM-SHA-256과 호환되지 않음) 클라이언트는 비밀번호를 다이제스트하고, 이후 다이제스트된 비밀번호를 서버에 전달합니다.

"readWrite"

{ role: "<role>", db: "<database>" }

호환성

이 메서드는 다음 환경에서 호스팅되는 배포에서 사용할 수 있습니다.

• MongoDB Enterprise: MongoDB의 구독 기반 자체 관리 버전

• MongoDB Community: MongoDB의 소스 사용 가능 무료 자체 관리 버전

행동

필요한 액세스 권한

• 데이터베이스에서 새 사용자를 생성하려면 해당 데이터베이스 리소스에 대해 createUser 작업을 수행할 수 있어야 합니다.

• 사용자에게 역할을 부여하려면 역할의 데이터베이스에 grantRole 조치가 있어야 합니다.

userAdmin 및 userAdminAnyDatabase 기본 제공 역할은 해당 리소스에 대한 createUser 및 grantRole 조치를 제공합니다.

예시

다음 작업은 products 데이터베이스 에 accountAdmin01 사용자를 생성합니다.

use products
db.createUser( { user: "accountAdmin01",
                 pwd: passwordPrompt(),  // Or  "<cleartext password>"
                 customData: { employeeId: 12345 },
                 roles: [ { role: "clusterAdmin", db: "admin" },
                          { role: "readAnyDatabase", db: "admin" },
                          "readWrite"] },
               { w: "majority" , wtimeout: 5000 } )

이 작업은 accountAdmin01 에 다음과 같은 역할을 부여합니다.

• admin 데이터베이스의 clusterAdmin 및 readAnyDatabase 역할.

• products 데이터베이스의 readWrite 역할.

use products
db.createUser(
   {
     user: "accountUser",
     pwd: passwordPrompt(),  // Or  "<cleartext password>"
     roles: [ "readWrite", "dbAdmin" ]
   }
)

use admin
db.createUser(
   {
     user: "reportsUser",
     pwd: passwordPrompt(),  // Or  "<cleartext password>"
     roles: [ ]
   }
)

use admin
db.createUser(
   {
     user: "appAdmin",
     pwd: passwordPrompt(),   // Or  "<cleartext password>"
     roles:
       [
         { role: "readWrite", db: "config" },
         "clusterAdmin"
       ]
   }
)

use admin
db.createUser(
   {
     user: "restricted",
     pwd: passwordPrompt(),      // Or  "<cleartext password>"
     roles: [ { role: "readWrite", db: "reporting" } ],
     authenticationRestrictions: [ {
        clientSource: ["192.0.2.0"],
        serverAddress: ["198.51.100.0"]
     } ]
   }
)

use reporting
db.createUser(
   {
     user: "reportUser256",
     pwd: passwordPrompt(),   // Or  "<cleartext password>"
     roles: [ { role: "readWrite", db: "reporting" } ],
     mechanisms: [ "SCRAM-SHA-256" ]
   }
)