db.getUser()

Definición

db.getUser(username, args)

Devuelve información de usuario para un usuario especificado. Ejecute este método en la base de datos del usuario. Si el usuario no existe en la base de datos, db.getUser() devuelve null.

El método db.getUser() tiene los siguientes parámetros:

db.getUser( "<username>", {
   showCredentials: <Boolean>,
   showPrivileges: <Boolean>,
   showAuthenticationRestrictions: <Boolean>,
   filter: <document>
} )

Parameter	Tipo	Descripción
username	string	El nombre de usuario para el cual recuperar información.
args	Documento	Opcional. Un documento que especifica argumentos adicionales.

El documento args admite los siguientes campos:

Campo	Tipo	Descripción
showCredentials	booleano	opcional. Configura el campo como verdadero para mostrar el hash de la contraseña del usuario. Por defecto, este campo es false.
showPrivileges	booleano	opcional. Configura el campo en verdadero para mostrar el conjunto completo de privilegios del usuario, incluyendo información ampliada para los roles heredados. Por defecto, este campo es false. Si se visualizan todos los usuarios, no es posible especificar este campo.
showAuthenticationRestrictions	booleano	opcional. Establecer el campo en verdadero para mostrar las restricciones de autenticación del usuario. Por defecto, este campo es false. Si se visualizan todos los usuarios, no es posible especificar este campo.
filter	Documento	opcional. Un documento que especifica $match condiciones de etapa para devolver información de los usuarios que coinciden con las condiciones del filtro.

db.getUser() encapsula el comando usersInfo: <username>.

Para detalles sobre la producción, vea usersInfo.

Compatibilidad

Este método está disponible en implementaciones alojadas en los siguientes entornos:

• MongoDB Enterprise: La versión basada en suscripción y autogestionada de MongoDB

• MongoDB Community: La versión de MongoDB con código fuente disponible, de uso gratuito y autogestionada.

Acceso requerido

Para ver la información de otro usuario, debe tener la acción viewUser en la base de datos de otro usuario.

Los usuarios pueden ver su propia información.

Ejemplo

Las siguientes operaciones devuelven información sobre un usuario de ejemplo appClient en una base de datos accounts:

use accounts
db.getUser("appClient")

Ejemplo de salida:

{
   _id: 'accounts.appClient',
   userId: UUID("1c2fc1bf-c4dc-4a22-8b04-3971349ce0dc"),
   user: 'appClient',
   db: 'accounts',
   roles: [],
   mechanisms: [ 'SCRAM-SHA-1', 'SCRAM-SHA-256' ]
}