# 创建用户
#### 操作须知
- 下面所有操作都对权限要求，默认rwuser用户具备所需权限，如果通过用户自定义用户进行管理，则需要关注是否具备操作权限。
- 使用具备权限的用户（可使用rwuser）连接到数据库实例。
- 通过createUser创建所需的用户，通过设置合适的角色来控制对应用户的权限。其中需要注意的是"passwordDigestor" 参数必须是 "server"，否则命令会执行失败，增加这个约束是为了避免安全隐患。
 
#### 创建用户
**db.createUser(user, writeConcern）**
- 命令中user为必选参数，类型为文档，包含了要创建用户的身份认证和访问信息。
- writeConcern为可选参数，类型为文档，包含了创建操作的write concern级别。
user文档定义了用户，其格式如下:
```
{
  user: "<name>",
  pwd: "<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>"
}
```
表1user参数说明 
| 字段                         | 类型     | 说明                                                                         |
|:---|:---|:---|
| user                       | string | 新用户名称。                                                                     |
| pwd                        | string | 用户密码，如果您在$external数据库上运行db.createUser()以创建将凭据存储在 MongoDB外部的用户，则pwd字段不是必需的。 |
| customData                 | 文档     | 可选的。任何任意信息，该字段可用于存储管理员希望与此特定用户关联的任何数据。例如，这可以是用户的全名或员工ID。                   |
| roles                      | 数组     | 授予用户的角色。可以指定一个空数组\[\]来创建没有角色的用户。                                           |
| authenticationRestrictions | 数组     | 可选的。服务器对创建的用户强制执行的身份验证限制，用于指定该角色可接入的IP地址或者IP地址段。                           |
| mechanisms                 | 数组     | 可选的。指定用于创建SCRAM用户凭据的特定SCRAM机制。当前只包含SCRAM-SHA-1和SCRAM-SHA-256。              |
| passwordDigestor           | string | 可选的。指示是在server端还是client端验证密码，默认是server。                                    |
   
#### 示例
- **创建用户时不同数据库赋予不同角色**
  使用db.createUser()在products数据库中创建accountAdmin01用户。
  ```
  use products
  db.createUser( { user: "accountAdmin01",
                   pwd: "Changeme_123",
                   customData: { employeeId: 12345 },
                   roles: [ { role: "clusterAdmin", db: "admin" },
                            { role: "readAnyDatabase", db: "admin" },
                            "readWrite"] },
                 { w: "majority" , wtimeout: 5000 } )
  ```
  以上操作赋予用户accountAdmin01以下角色：
  - 在admin数据库中角色为clusterAdmin和readAnyDatabase。
  
  - 在products数据库中角色为readWrite。
    
- **创建用户时同一数据库赋予多个角色**
  以下操作创建一个在products数据库中角色为readWrite和dbAdmin的用户，用户名为accountUser。
  ```
  use products
  db.createUser(
     {
       user: "accountUser",
       pwd: "Changeme_123",
       roles: [ "readWrite", "dbAdmin" ]
     }
  )
  ```
  
- **创建用户时不赋予角色**
  以下操作在admin数据库中创建一个用户名为reportsUser的用户，但是没有赋予用户角色。
  ```
  use admin
  db.createUser(
     {
       user: "reportsUser",
       pwd: "Chagneme_123",
       roles: [ ]
     }
  )
  ```
  
- **创建管理员用户并赋予角色**
  下面的操作将在admin 数据库中创建名为appAdmin的用户，并赋予该用户对config数据库的读写访问权限，使用户可以更改分片群集的某些设置，如分片均衡器设置。
  ```
  use admin
  db.createUser(
     {
       user: "appAdmin",
       pwd: "Changeme_123",
       roles:
         [
           { role: "readWrite", db: "config" },
           "clusterAdmin"
         ]
     }
  )
  ```
  
- **创建有身份验证限制的用户**
  以下操作将在管理员数据库中创建一个名为restricted的用户。该用户只能从IP地址192.0.2.0连接到IP地址198.51.100.0时才能进行身份验证。
  ```
  use admin
  db.createUser(
     {
       user: "restricted",
       pwd: "Changeme_123",
       roles: [ { role: "readWrite", db: "reporting" } ],
       authenticationRestrictions: [ {
          clientSource: ["192.0.2.0"],
          serverAddress: ["198.51.100.0"]
       } ]
     }
  )
  ```
  
- **仅使用SCRAM-SHA-256证书创建用户**
  下面的操作将创建一个只有SCRAM-SHA-256凭据的用户。
  ```
  use reporting
  db.createUser(
     {
       user: "reportUser256",
       pwd: "Changeme_123",
       roles: [ { role: "readWrite", db: "reporting" } ],
       mechanisms: [ "SCRAM-SHA-256" ]
     }
  )
  ```
  如果设置了authenticationMechanisms参数，mechanisms字段只能包含authenticationMechanisms参数中指定的值。