Docs Menu
Docs Home
MongoDB Manual
/ / /


On this page

  • Compatibility
  • Behavior

Authenticates using the x.509 authentication mechanism. When using mongosh, use the db.auth() helper as follows:


You can use the passwordPrompt() method in conjunction with various user authentication/management methods/commands to prompt for the password instead of specifying the password directly in the method/command call. However, you can still specify the password directly as you would with earlier versions of the mongo shell.

db.auth( "username", passwordPrompt() )

In earlier versions, to use the db.auth() method, specify the password:

db.auth( "username", "password" )



This command is available in deployments hosted in the following environments:

  • MongoDB Atlas: The fully managed service for MongoDB deployments in the cloud


This command is not supported in M0, M2, and M5 clusters. For more information, see Unsupported Commands.

Starting in MongoDB 4.2, if the client that issued authenticate disconnects before the operation completes, MongoDB marks authenticate for termination using killOp.

← Authentication Commands
logout →