MongoDB管理用戶和角色

本教程提供了MongoDB授權模式下的用戶和角色管理示例。學習如何向MongoDB添加新用戶。

創建用戶定義的角色

角色授權用戶訪問MongoDB資源。 MongoDB提供了許多內置的角色，管理員可以使用它們來控制對MongoDB系統的訪問。 但是，如果這些角色無法描述所需的權限集，則可以在特定數據庫中創建新角色。

除了在管理數據庫中創建的角色外，角色只能包含適用於其數據庫的權限，並且只能繼承其數據庫中的其他角色。

在管理數據庫中創建的角色可以包括適用於管理數據庫，其他數據庫或羣集資源的權限，並且可以從其他數據庫中的角色以及管理數據庫繼承。

要創建新角色，可使用db.createRole()方法，指定permissions數組中的權限和roles數組中的繼承角色。

MongoDB使用數據庫名稱和角色名稱的組合來唯一定義角色。 每個角色的範圍限定在創建角色的數據庫中，但MongoDB將所有角色信息存儲在admin數據庫的admin.system.roles集合中。

先決條件

要在數據庫中創建角色，您必須具有：

• 對該數據庫資源的createRole操作。
• 對該數據庫的grantRole操作指定新角色的權限以及指定要繼承的角色。

內置角色 userAdmin 和 userAdminAnyDatabase 在其各自的資源上提供 createRole 和 grantRole 操作。

創建角色來管理當前操作

以下示例創建一個名爲 manageOpRole 的角色，該角色僅提供運行 db.currentOp()和db.killOp()的權限。

第一步：使用相應的權限連接到MongoDB

使用「先決條件」部分指定的權限連接到 mongod 或 mongos 。

以下過程使用在「啓用認證」中創建的用戶：myUserAdmin。

$ mongo --port 27017 -u "myUserAdmin" -p "abc123" --authenticationDatabase "admin"

myUserAdmin具有在管理員以及其他數據庫中創建角色的權限。

第二步：創建一個新角色來管理當前操作

manageOpRole具有對多個數據庫以及羣集資源的權限。 因此，您必須在管理數據庫中創建該角色。

use admin
db.createRole(
   {
     role: "manageOpRole",
     privileges: [
       { resource: { cluster: true }, actions: [ "killop", "inprog" ] },
       { resource: { db: "", collection: "" }, actions: [ "killCursors" ] }
     ],
     roles: []
   }
)

新角色授予殺死/終止任何操作的權限。

警告: 終止運行操作非常小心。只能使用db.killOp()方法或killOp命令終止客戶端發起的操作，並且不會終止內部數據庫操作。

創建角色用來運行 mongostat

以下示例創建一個名爲 mongostatRole 的角色，該角色僅提供運行 mongostat 的權限。

第一步：使用相應的權限連接到MongoDB

使用「先決條件」部分指定的權限連接到　mongod　或　mongos　。

以下過程使用在啓用認證中創建的用戶：myUserAdmin。

$ mongo --port 27017 -u "myUserAdmin" -p "abc123" --authenticationDatabase "admin"

myUserAdmin具有在管理員以及其他數據庫中創建角色的權限。

第二步：創建一個新角色來管理當前的操作

mongostatRole具有作用於羣集資源的權限。 因此，您必須在管理數據庫中創建該角色。

use admin
db.createRole(
   {
     role: "mongostatRole",
     privileges: [
       { resource: { cluster: true }, actions: [ "serverStatus" ] }
     ],
     roles: []
   }
)

修改現有用戶的訪問權限

先決條件

• 必須對數據庫具有grantRole操作才能在該數據庫上授予角色。
• 必須在數據庫上具有revokeRole操作以撤銷該數據庫上的角色。
• 要查看角色的信息，必須明確授予該角色，或必須對該角色的數據庫具有viewRole操作。

執行步驟

第一步：使用相應的權限連接到MongoDB

以具有先決條件部分中指定的權限的用戶身份連接到 mongod 或 mongos 。

以下過程使用在啓用認證中創建的用戶：myUserAdmin。

$ mongo --port 27017 -u "myUserAdmin" -p "abc123" --authenticationDatabase "admin"

第二步：識別用戶的角色和權限

要顯示要修改的用戶的角色和權限，請使用db.getUser()和db.getRole()方法。

例如，要查看在示例中創建的 reportsUser 的角色，執行以下命令：

use reporting
db.getUser("reportsUser")

要顯示在 「accounts」 數據庫上由 readWrite 角色授予用戶的權限，請執行以下操作：

use accounts
db.getRole( "readWrite", { showPrivileges: true } )

第三步：確定授予或撤銷的權限

如果用戶需要額外的權限，則向用戶授予具有所需權限集的角色或角色。 如果此類角色不存在，請使用適當的權限集創建新角色。

撤銷由現有角色提供的特權子集：撤銷原始角色並授予僅包含所需權限的角色。如果角色不存在，您需要創建新角色。

第四步：修改用戶的訪問權限

4.1. 撤銷角色

使用db.revokeRolesFromUser()方法撤銷角色。以下示例操作從account數據庫上刪除用戶reportsUser 的 readWrite 角色：

use reporting
db.revokeRolesFromUser(
    "reportsUser",
    [
      { role: "readWrite", db: "accounts" }
    ]
)

4.2. 授予角色

使用db.grantRolesToUser()方法授予角色。 例如，以下操作授予reportsUser用戶account數據庫上的讀取角色：

use reporting
db.grantRolesToUser(
    "reportsUser",
    [
      { role: "read", db: "accounts" }
    ]
)

對於分片集羣，用戶的更改將在命令運行的 mongos 上即時生效。但是，對於羣集中的其他mongos 實例，用戶緩存可能會等待10分鐘才能刷新。請參閱userCacheInvalidationIntervalSecs。

修改現有用戶的密碼

先決條件

要修改數據庫上另一個用戶的密碼，您必須對該數據庫具有changeAnyPassword操作。

操作步驟：

第一步：使用相應的權限連接到MongoDB

以具有先決條件部分中指定的權限的用戶身份連接到 mongod 或 mongos 。

以下過程使用在啓用認證中創建的用戶：myUserAdmin。

$ mongo --port 27017 -u "myUserAdmin" -p "abc123" --authenticationDatabase "admin"

第二步：更改密碼

將用戶的用戶名和新密碼傳遞給db.changeUserPassword()方法。

以下操作將reporting用戶的密碼更改爲：SOh3TbYhxuLiW8ypJPxmt1oOfL：

db.changeUserPassword("reporting", "SOh3TbYhxuLiW8ypJPxmt1oOfL")

查看用戶的角色

先決條件

要查看其他用戶的信息，您必須對其他用戶的數據庫具有viewUser操作。

用戶可以查看自己的信息。

第一步：使用相應的權限連接到MongoDB

以具有先決條件部分中指定的權限的用戶身份連接到 mongod 或 mongos 。

以下過程使用在啓用認證中創建的用戶：myUserAdmin。

$ mongo --port 27017 -u "myUserAdmin" -p "abc123" --authenticationDatabase "admin"

第二步：查看用戶的角色

使用usersInfo命令或db.getUser()方法顯示用戶信息。

例如，要查看在示例中創建的 reportsUser 的角色，請發出：

use reporting
db.getUser("reportsUser")

在返回的文檔中，roles字段顯示reportsUser的所有角色：

...
"roles" : [
   { "role" : "readWrite", "db" : "accounts" },
   { "role" : "read", "db" : "reporting" },
   { "role" : "read", "db" : "products" },
   { "role" : "read", "db" : "sales" }
]

查看角色的權限

先決條件

要查看角色的信息，您必須明確授予該角色，或必須對該角色的數據庫具有 viewRole 操作。

第一步：使用相應的權限連接到MongoDB

以具有先決條件部分中指定的權限的用戶身份連接到 mongod 或 mongos 。

以下過程使用在啓用認證中創建的用戶：myUserAdmin。

$ mongo --port 27017 -u "myUserAdmin" -p "abc123" --authenticationDatabase "admin"

第二步：查看角色授予的權限

對於給定的角色，請使用db.getRole()方法或rolesInfo命令與showPrivileges選項一起執行：

例如，要查看在product數據庫上由讀取角色授予的權限，請使用以下操作，問題如下：

use products
db.getRole( "read", { showPrivileges: true } )

在返回的文檔中，有兩個數組：privileges和inheritedPrivileges。權限列出了角色指定的權限，並排除了從其他角色繼承的權限。 inheritedPrivileges列出了由此角色授予的所有權限，這兩個角色都是直接指定的並被繼承。 如果該角色不能從其他角色繼承，則兩個字段是相同的。

...
"privileges" : [
  {
    "resource": { "db" : "products", "collection" : "" },
    "actions": [ "collStats","dbHash","dbStats","find","killCursors","planCacheRead" ]
  },
  {
    "resource" : { "db" : "products", "collection" : "system.js" },
    "actions": [ "collStats","dbHash","dbStats","find","killCursors","planCacheRead" ]
  }
],
"inheritedPrivileges" : [
  {
    "resource": { "db" : "products", "collection" : "" },
    "actions": [ "collStats","dbHash","dbStats","find","killCursors","planCacheRead" ]
  },
  {
    "resource" : { "db" : "products", "collection" : "system.js" },
    "actions": [ "collStats","dbHash","dbStats","find","killCursors","planCacheRead" ]
  }
]