updateUser

정의

updateUser

명령을 실행하는 데이터베이스에서 사용자 프로필을 업데이트합니다. 필드를 업데이트하면 사용자의 roles 및 authenticationRestrictions 배열에 대한 업데이트를 포함하여 이전 필드의 값이 완전히 바뀝니다 .

경고

roles 배열을 업데이트하면 이전 배열의 값이 완전히 바뀝니다. 사용자의 기존 역할을 모두 바꾸지 않고 역할을 추가하거나 제거하려면 grantRolesToUser 또는 revokeRolesFromUser 명령을 사용합니다.

updateUser 명령은 다음 구문을 사용합니다. 사용자를 업데이트하려면 updateUser 필드와 writeConcern 이외의 다른 필드를 하나 이상 지정해야 합니다.

팁

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

{
  updateUser: "<username>",
  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-mechanism>", ... ],
  digestPassword: <boolean>,
  writeConcern: { <write concern> },
  comment: <any>
}

명령에는 다음과 같은 필드가 있습니다.

"readWrite"

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

행동

필요한 액세스 권한

사용자의 roles 배열을 업데이트하려면 모든 데이터베이스에 대한 revokeRole 조치를 포함하는 액세스 권한이 있어야 합니다.

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

다른 사용자의 pwd 또는 customData 필드를 변경하려면 해당 사용자의 데이터베이스에 changePassword 및 changeCustomData 조치가 각각 있어야 합니다.

자신의 비밀번호와 사용자 지정 데이터를 수정하려면 사용자 데이터베이스에서 각각 changeOwnPassword 및 changeOwnCustomData 조치를 부여할 수 있는 권한이 있어야 합니다.

예제

다음 사용자 정보가 포함된 products 데이터베이스의 사용자 appClient01이(가) 제공됩니다.

{
   "_id" : "products.appClient01",
   "userId" : UUID("c5d88855-3f1e-46cb-9c8b-269bef957986"),
   "user" : "appClient01",
   "db" : "products",
   "customData" : { "empID" : "12345", "badge" : "9156" },
   "roles" : [
       { "role" : "readWrite",
         "db" : "products"
       },
       { "role" : "read",
         "db" : "inventory"
       }
   ],
   "mechanisms" : [
      "SCRAM-SHA-1",
      "SCRAM-SHA-256"
   ]
}

다음 updateUser 명령은 사용자의 customData 및 roles 데이터를 완전히 대체합니다.

use products
db.runCommand( {
   updateUser : "appClient01",
   customData : { employeeId : "0x3039" },
   roles : [ { role : "read", db : "assets" } ]
} )

products 데이터베이스의 사용자 appClient01는 이제 다음과 같은 사용자 정보를 갖습니다.

{
   "_id" : "products.appClient01",
   "userId" : UUID("c5d88855-3f1e-46cb-9c8b-269bef957986"),
   "user" : "appClient01",
   "db" : "products",
   "customData" : { "employeeId" : "0x3039" },
   "roles" : [
       { "role" : "read",
         "db" : "assets"
       }
   ],
   "mechanisms" : [
      "SCRAM-SHA-1",
      "SCRAM-SHA-256"
   ]
}