db.createUser()

정의

db.createUser(user, writeConcern)

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

중요

Mongo쉬 방법

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

데이터베이스 명령에 대해서는 createUser 명령을 참조하십시오.

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

레거시 mongo 셸 문서는 해당 MongoDB 서버 릴리스 문서를 참조하세요.

Mongo 셸 V4.4

db.createUser() 메서드의 구문은 다음과 같습니다.

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

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

팁

mongo 셸 버전 4.2부터 메서드/명령 호출에 비밀번호를 직접 지정하는 대신 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() 은(는) 사용자의 비밀번호를 묻는 메시지를 표시합니다. 팁 mongo 셸 버전 4.2부터 메서드/명령 호출에 비밀번호를 직접 지정하는 대신 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>" }

행동

필요한 액세스 권한

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

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

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

예제

다음 db.createUser() 작업은 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" ]
   }
)