文档首页/ 文档数据库服务 DDS/ 常见问题/ 数据库权限/ 用户管理/ 更新用户
更新时间：2024-04-29 GMT+08:00
查看PDF
分享

更新用户

db.updateUser(username, update, writeConcern）

  • 命令中参数username为要更新的用户名。
  • update为文档类型，包含用户替换数据的文档。
  • writeConcern为可选参数， 更新操作的write concern级别。
db.updateUser(
   "<username>",
   {
     customData : { <any information> },
     roles : [
       { role: "<role>", db: "<database>" } | "<role>",
       ...
     ],
     pwd: passwordPrompt(),      // Or  "<cleartext password>"
     authenticationRestrictions: [
        {
          clientSource: ["<IP>" | "<CIDR range>", ...],
          serverAddress: ["<IP>", | "<CIDR range>", ...]
        },
        ...
     ],
     mechanisms: [ "<SCRAM-SHA-1|SCRAM-SHA-256>", ... ],
     passwordDigestor: "<server|client>"
   },
   writeConcern: { <write concern> }
)
表1 update参数说明

字段

类型

说明

customData

文档

可选。任意信息

roles

数组

可选。授予用户的角色。 roles数组的更新将覆盖以前的数组的值。

pwd

string

可选。用户密码

authenticationRestrictions

数组

可选。服务器对用户实施的身份验证限制，用于指定该角色可接入的IP地址或者IP地址段。

mechanisms

数组

可选的。指定用于创建SCRAM用户凭据的特定SCRAM机制。当前只包含SCRAM-SHA-1 和SCRAM-SHA-256。

passwordDigestor

string

可选的。指示是在server端还是client端验证密码，默认是server

示例

  • 更新用户信息

    products数据库中的用户appClient01，其信息如下：

    {
	"_id" : "products.appClient01",
	"token" : NumberLong("8424642624807814713"),
	"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"
	]
}

    下面操作会替换用户的自定义数据和角色数据：

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

    products数据库中的用户appClient01，经过更新后信息如下：

    {
	"_id" : "products.appClient01",
	"token" : NumberLong("8424642624807814713"),
	"user" : "appClient01",
	"db" : "products",
	"customData" : {
		"employeeId" : "0x3039"
	},
	"roles" : [
		{
			"role" : "read",
			"db" : "assets"
		}
	],
	"mechanisms" : [
		"SCRAM-SHA-1",
		"SCRAM-SHA-256"
	]
}
  • 更新用户以仅使用SCRAM-SHA-256凭证

    reporting数据库中的用户reportUser256，其信息如下：

    {
	"_id" : "reporting.reportUser256",
	"token" : NumberLong("2827251846225877395"),
	"user" : "reportUser256",
	"db" : "reporting",
	"roles" : [ ],
	"mechanisms" : [
		"SCRAM-SHA-1",
		"SCRAM-SHA-256"
	]
}

    以下操作会将当前同时拥有 SCRAM-SHA-256 和 SCRAM-SHA-1 全权证书的用户更新为只拥有 SCRAM-SHA-256 全权证书的用户。

    • 如果密码未与mechanisms一起指定，则只能将mechanisms更新为用户当前SCRAM机制的子集。
    • 如果密码与mechanisms一起指定，则可以指定任何受支持的SCRAM机制。
    • 对于SCRAM-SHA-256，passwordDigestor必须是默认值 "server"。
    db.updateUser(
   "reportUser256",
   {
     mechanisms: [ "SCRAM-SHA-256" ]
   }
)

    reporting数据库中的用户reportUser256，经过更新后信息如下：

    {
	"_id" : "reporting.reportUser256",
	"token" : NumberLong("2827251846225877395"),
	"user" : "reportUser256",
	"db" : "reporting",
	"roles" : [ ],
	"mechanisms" : [
		"SCRAM-SHA-256"
	]
}
父主题： 用户管理