system.users Colección en Implementaciones Autogestionadas

system.users Esquema

Los documentos de 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 única base de datos lógica (véase admin.system.users.db) pero puede tener acceso a otras bases de datos a través de roles especificados en la roles matriz.

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 usuarios con credenciales de autenticación almacenadas externamente, como aquellos que usan certificados Kerberos o X.509 para la autenticación, el system.users documento de ese usuario no contiene el campo.credentials Para las credenciales de usuario SCRAM, la información incluye el mecanismo, el número de iteraciones y los parámetros de autenticación.

Tip

• scramSHA256IterationCount

• scramIterationCount

admin.system.users.roles

Una matriz de roles asignados al usuario. Esta matriz contiene tanto roles predefinidos como roles definidos por el usuario.

Un documento de rol tiene la siguiente sintaxis:

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

Un documento de rol tiene 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

Una matriz de restricciones de autenticación que el servidor impone al usuario. Esta matriz contiene una lista de direcciones IP y rangos CIDR desde los cuales el usuario puede conectarse al servidor o desde los cuales el servidor puede aceptar usuarios.

Ejemplo

Considere 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 Kari base de datos de autenticación de un usuario es la home base de datos. Kari tiene el rol en read la home base de datos, el rol en readWrite la test base de datos.