db.createRole() (mongosh 메서드)

정의

db.createRole(role, writeConcern)

데이터베이스에 역할을 생성합니다. 권한을 명시적으로 나열하거나, 역할이 다른 역할의 권한을 상속받거나, 나열과 상속 둘 다 진행하여 역할에 대한 권한을 지정할 수 있습니다. 이 역할은 메서드를 실행하는 데이터베이스에 적용됩니다.

중요

Mongo쉬 방법

This page documents a mongosh method. This is not the documentation for database commands or language-specific drivers, such as Node.js.

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

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

The db.createRole() method accepts the following arguments:

Parameter	유형	설명
role	문서	역할의 이름과 역할 정의가 포함된 문서입니다.
writeConcern	문서	선택 사항입니다. 작업에 대한 쓰기 고려 수준입니다. 쓰기 고려 사양을 참조하세요.

role 문서의 형식은 다음과 같습니다.

{
  role: "<name>",
  privileges: [
     { resource: { <resource> }, actions: [ "<action>", ... ] },
     ...
  ],
  roles: [
     { role: "<role>", db: "<database>" } | "<role>",
      ...
  ],
  authenticationRestrictions: [
    {
      clientSource: ["<IP>" | "<CIDR range>", ...],
      serverAddress: ["<IP>" | "<CIDR range>", ...]
    },
    ...
  ]
}

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

필드	유형	설명
role	문자열	새 역할의 이름입니다.
privileges	배열	역할에 부여할 권한입니다. 권한은 리소스와 허용된 작업으로 구성됩니다. 권한의 구문은 privileges 배열을 참조하세요. privileges 필드를 포함시켜야 합니다. 권한을 지정하지 않으려면 빈 배열을 사용하세요.
roles	배열	이 역할에게 권한을 상속해 주는 역할의 배열입니다. roles 필드를 포함시켜야 합니다. 상속의 출처가 될 역할을 지정하지 않으려면 빈 배열을 사용하세요.
authenticationRestrictions	배열	선택 사항. 서버가 이 역할에 대해 시행하는 인증 제한입니다. 이 역할을 부여받은 사용자에게 연결이 허용되거나 연결할 수 있는 IP 주소 및 CIDR 범위의 목록을 지정합니다.

"readWrite"

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

호환성

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

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

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

행동

privileges: [
     {
     resource: { db: 'products', collection: 'coll1' },
     actions: [ 'bypassDocumentValidation' ]
     },
     {
     resource: { db: 'products', collection: 'coll2' },
     actions: [ 'bypassDocumentValidation' ]
     }
]

privileges: [
     {
     resource: { db: 'products', collection: '' },
     actions: [ 'bypassDocumentValidation' ]
     }
]

필요한 액세스 권한

데이터베이스에서 역할을 생성하려면 다음 항목이 있어야 합니다.

• 해당 데이터베이스 리소스에 대한 createRole 작업

• 해당 데이터베이스에 대한 grantRole 작업이 있으면 새 역할의 권한은 물론 상속의 출처가 될 역할까지 지정할 수 있습니다.

기본 제공 역할인 userAdmin 및 userAdminAnyDatabase은(는) 각자의 리소스에 대해 createRole 작업 및 grantRole 작업을 제공합니다.

authenticationRestrictions이(가) 지정된 역할을 생성하려면 이 역할이 생성되는 데이터베이스 리소스에 대한 setAuthenticationRestriction 작업이 있어야 합니다.

예시

The following db.createRole() method creates the myClusterwideAdmin role on the admin database:

use admin
db.createRole(
   {
     role: "myClusterwideAdmin",
     privileges: [
       { resource: { cluster: true }, actions: [ "addShard" ] },
       { resource: { db: "config", collection: "" }, actions: [ "find", "update", "insert", "remove" ] },
       { resource: { db: "users", collection: "usersCollection" }, actions: [ "update", "insert", "remove" ] },
       { resource: { db: "", collection: "" }, actions: [ "find" ] }
     ],
     roles: [
       { role: "read", db: "admin" }
     ]
   },
   { w: "majority" , wtimeout: 5000 }
)