Docs Menu
Docs Home
/
MongoDB Manual
/ / /

db.getUser()

On this page

  • Definition
  • Required Access
  • Example
db.getUser(username, args)

Returns user information for a specified user. Run this method on the user's database. If the user doesn't exist in the database, db.getUser() returns null.

The db.getUser() method has the following parameters:

db.getUser( "<username>", {
showCredentials: <Boolean>,
showPrivileges: <Boolean>,
showAuthenticationRestrictions: <Boolean>,
filter: <document>
} )
Parameter
Type
Description
username
string
The name of the user for which to retrieve information.
args
document
Optional. A document specifying additional arguments.

The args document supports the following fields:

Field
Type
Description
showCredentials
boolean
Optional. Set the field to true to display the user's password hash. By default, this field is false.
showPrivileges
boolean
Optional. Set the field to true to show the user's full set of privileges, including expanded information for the inherited roles. By default, this field is false. If viewing all users, you cannot specify this field.
showAuthenticationRestrictions
boolean
Optional. Set the field to true to show the user's authentication restrictions. By default, this field is false. If viewing all users, you cannot specify this field.
filter
document
Optional. A document that specifies $match stage conditions to return information for users that match the filter conditions.

db.getUser() wraps the usersInfo: <username> command.

For details on output, see usersInfo.

To view another user's information, you must have the viewUser action on the other user's database.

Users can view their own information.

The following operations return information about an example appClient user in an accounts database:

use accounts
db.getUser("appClient")

Example output:

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