db.logout()
On this page
db.logout()
Deprecated since version 5.0.
Attempting to use the
db.logout()
method will write an error message to the log once per logout attempt.This method will be removed in a future release.
Ends the current authentication session. This function has no effect if the current session is not authenticated.
Note
If you're not logged in and using authentication,
db.logout()
has no effect.Because MongoDB allows users defined in one database to have privileges on another database, you must call
db.logout()
while using the same database context that you authenticated to.If you authenticated to a database such as
users
or$external
, you must issuedb.logout()
against this database in order to successfully log out.Example
Use the
use <database-name>
helper inmongosh
, or the followingdb.getSiblingDB()
method in an interactivemongosh
session or inmongosh
shell scripts to change thedb
object:db = db.getSiblingDB('<database-name>') When you have set the database context and
db
object, you can use thedb.logout()
to log out of database as in the following operation:db.logout() db.logout()
function provides a wrapper around the database commandlogout
.
Compatibility
This method is available in deployments hosted in the following environments:
MongoDB Atlas: The fully managed service for MongoDB deployments in the cloud
Note
This command is supported in all MongoDB Atlas clusters. For information on all commands, see Unsupported Commands.
MongoDB Enterprise: The subscription-based, self-managed version of MongoDB
MongoDB Community: The source-available, free-to-use, and self-managed version of MongoDB