Authenticating and Handling Errors

• How do you authenticate from outside the MongoDB shell?

  .
  
  

  • mongo -u name -p password --authenticationDatabase db-name

• How do you authenticate from inside the MongoDB shell?

  .
  
  

  • use db-name
  • db.auth("name","password")

• How do you authenticate from an application?

  .
  
  

  • Depends on your driver
  • PHP: $client = new MongoClient("mongodb://username:password@localhost/db-name")

• What errors might you see and how can they be resolved?

  .
  
  

  • Insufficient rights to perform an operation:
  • "$err" : "not authorized for query on db-name.system.namespaces"
  • XXX failed:{ "ok" : 0, "errmsg" : "unauthorized" }
  • Did not provide authentication database
  • Error: 18 { code: 18, ok: 0.0, errmsg: "auth fails" }
  • Incorrect credentials in application:
  • Uncaught exception XXX ... "localhost:27017: not authorized for XXX on YYY.ZZZ"

• How do you regain access to a database?

  .
  
  

  • Disable auth in mongod.conf
  • Restart mongod
  • use db-name
  • db.system.users.remove()

• Where can you find more information?

  .
  
  

  • docs.mongodb.org/manual/tutorial/enable-authentication
  • docs.mongodb.org/manual/reference/configuration-options