- Security >
- Enable Authentication for an Ops Manager Project >
- Enable Username and Password Authentication for your Ops Manager Project
Enable Username and Password Authentication for your Ops Manager Project¶
On this page
Overview¶
Ops Manager enables you to configure the Authentication Mechanisms that all clients, including the Ops Manager Agents, use to connect to your MongoDB deployments. You can enable multiple authentication mechanisms for each of your projects, but you must choose only one mechanism for the Agents.
MongoDB users can use usernames and passwords to authenticate themselves against a MongoDB database.
MongoDB Version | Default authentication mechanism |
---|---|
MongoDB 4.0 and later | Salted Challenge Response Authentication Mechanism (SCRAM) using
the SHA-1 and SHA-256 hashing algorithms (SCRAM-SHA-1 and
SCRAM-SHA-256 ). |
MongoDB 3.4 to 3.6 | Salted Challenge Response Authentication Mechanism (SCRAM) using
the SHA-1 hashing algorithm (SCRAM-SHA-1 ). |
SCRAM-SHA-1
and SCRAM-SHA-256
¶
SCRAM-SHA-1 (RFC 5802) and SCRAM-SHA-256 (RFC 7677) are IETF standards that define best practice methods for implementation of challenge-response mechanisms for authenticating users with passwords.
SCRAM-SHA-1
and SCRAM-SHA-256
verify supplied user credentials
using the user’s name, password and authentication database. The
authentication database is the database where the user was created.
Considerations¶
This tutorial describes how to enable Username and Password authentication for your Ops Manager MongoDB deployment.
Note
The MongoDB Community version supports Username and Password authentication and x.509 authentication.
Note
If you want to reset Authentication and TLS settings for your project, first unmanage any MongoDB deployments that Ops Manager manages in your project.
Procedure¶
This procedure describes how to configure and enable username and password authentication when using Automation. If Ops Manager does not manage your MongoDB Agents, you must manually configure them to use Usernames and Passwords. To learn how to configure authentication, see Configure MongoDB Agent for Authentication.
Note
If you configure the Ops Manager application to authenticate using SCRAM-SHA-256, you cannot deploy pre-4.0 MongoDB clusters.
Optional: Specify the TLS Settings.¶
TLS is not required for use with Username/Password (MONGODB-CR/SCRAM-SHA-1) or Username/Password (SCRAM-SHA-256) authentication.
Field | Action | ||||
---|---|---|---|---|---|
MongoDB Deployment Transport Layer Security (TLS) | Toggle this slider to ON. | ||||
TLS CA File Path | The TLS Certificate Authority file is a Note The encrypted private key for the Type the file path to the TLS Certificate Authority file on every host running a MongoDB process:
This enables the Click Validate to test that each host in your deployment has a TLS Certificate Authority at the paths you specified. |
||||
Client Certificate Mode | Select if client applications or MongoDB Agents must present a TLS certificate when connecting to a TLS-enabled MongoDB deployments. Each MongoDB deployment checks for certificates from these client hosts when they try to connect. If you choose to require the client TLS certificates, make sure they are valid. Accepted values are:
|
Choose the authentication mechanism.¶
In the MongoDB Deployment Authentication Mechanism section, select Username/Password (MONGODB-CR/SCRAM-SHA-1) or Username/Password (SCRAM-SHA-256).
Configure Username/Password (MONGODB-CR/SCRAM-SHA-1) or Username/Password (SCRAM-SHA-256) for the Agent.¶
You can enable more than one authentication mechanism for your MongoDB deployment, but the Ops Manager Agents can only use one authentication mechanism.
In the MongoDB Agent Connections to Deployment section, select Username/Password (MONGODB-CR/SCRAM-SHA-1) and/or Username/Password (SCRAM-SHA-256).
Ops Manager automatically generates the Agents’ usernames and passwords.
Ops Manager creates users for the agents with the required user roles in the admin database for each existing deployment in Ops Manager. When you add a new deployment, Ops Manager creates the required users in the new deployment.
Click Save Settings.¶
Click Review & Deploy to review your changes.¶
Click Confirm & Deploy to deploy your changes.¶
Otherwise, click Cancel and you can make additional changes.