system.users Colección en implementaciones autogestionadas

system.users Esquema

Los documentos en la colección system.users tienen el siguiente esquema:

{
  _id: <system defined id>,
  userId : <system assigned UUID>,
  user: "<name>",
  db: "<database>",
  credentials: { <authentication credentials> },
  roles: [
           { role: "<role name>", db: "<database>" },
           ...
         ],
  customData: <custom information>,
  authenticationRestrictions : [ <documents> ]
 }

Cada documento system.users tiene los siguientes campos:

admin.system.users.userId

Un identificador único para el usuario asignado al usuario al momento de su creación.

admin.system.users.user

El nombre de usuario. Un usuario existe en el contexto de una sola base de datos lógica (ver admin.system.users.db) pero puede tener acceso en otras bases de datos a través de los roles especificados en el arreglo roles.

admin.system.users.db

La base de datos de autenticación asociada al usuario. Los privilegios del usuario no se limitan necesariamente a esta base de datos. El usuario puede tener privilegios en bases de datos adicionales mediante la roles matriz.

admin.system.users.credentials

Información de autenticación del usuario. Para los usuarios con credenciales de autenticación almacenadas externamente, como los usuarios que usan Kerberos o certificados X.509 para autenticación, el documento system.users para ese usuario no contiene el campo credentials. Para las credenciales de usuario SCRAM, la información incluye el mecanismo, el recuento de iteraciones y los parámetros de autenticación.

Tip

• scramSHA256IterationCount

• scramIterationCount

admin.system.users.roles

Un arreglo de roles otorgados al usuario. El arreglo contiene tanto roles integrados como rol definido por el usuario.

Un documento de rol tiene la siguiente sintaxis:

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

Un documento de rol contiene los siguientes campos:

admin.system.users.roles[n].role

El nombre de un rol. Un rol puede ser un rol integrado proporcionado por MongoDB o un rol personalizado definido por el usuario.

admin.system.users.roles[n].db

El nombre de la base de datos donde se define el rol.

Al especificar un rol mediante los comandos de administración de roles o de administración de usuarios, puede especificar solo el nombre del rol (por"readWrite" ejemplo,) si el rol existe en la base de datos en la que se ejecuta el comando.

admin.system.users.customData

Información personalizada opcional sobre el usuario.

admin.system.users.authenticationRestrictions

Un arreglo de restricciones de autenticación que el servidor aplica al usuario. El arreglo contiene una lista de direcciones IP y rangos CIDR desde donde se permite que el usuario se conecte al servidor o desde donde el servidor puede aceptar usuarios.

Ejemplo

Considera el siguiente documento en la colección system.users:

{
   "_id" : "home.Kari",
   "userId" : UUID("ec1eced7-055a-4ca8-8737-60dd02c52793"),
   "user" : "Kari",
   "db" : "home",
   "credentials" : {
      "SCRAM-SHA-1" : {
         "iterationCount" : 10000,
         "salt" : "S/xM2yXFosynbCu4GzFDgQ==",
         "storedKey" : "Ist4cgpEd1vTbnRnQLdobgmOsBA=",
         "serverKey" : "e/0DyzS6GPboAA2YNBkGYm87+cg="
      },
      "SCRAM-SHA-256" : {
         "iterationCount" : 15000,
         "salt" : "p1G+fZadAeYAbECN8F/6TMzXGYWBaZ3DtWM0ig==",
         "storedKey" : "LEgLOqZQmkGhd0owm/+6V7VdJUYJcXBhPUvi9z+GBfk=",
         "serverKey" : "JKfnkVv9iXwxyc8JaapKVwLPy6SfnmB8gMb1Pr15T+s="
      }
   },
   "authenticationRestrictions" : [
      { "clientSource" : [ "69.89.31.226" ], "serverAddress" : [ "172.16.254.1" ] }
   ],
   "customData" : {
      "zipCode" : "64157"
   },
   "roles" : [
      {
         "role" : "read",
         "db" : "home"
      },
      {
         "role" : "readWrite",
         "db" : "test"
      }
   ]
}

El documento muestra que la base de datos de autenticación de un usuario Kari es la base de datos home. Kari tiene el rol read en la base de datos home, el rol readWrite en la base de datos test.