MongoDB V2 Connector > Connections for MongoDB V2 > Connect to MongoDB

Connect to MongoDB

Let's configure the MongoDB V2 connection properties to connect to MongoDB.

Before you begin

Before you configure a MongoDB V2 connection, ensure that you have a MongoDB user account with admin privileges. You also need to copy the host name of the primary node in MongoDB and keep it handy for your connection configuration.

Connection details

The following table describes the basic connection properties:

Property	Description
Connection Name	Name of the connection. Each connection name must be unique within the organization. Connection names can contain alphanumeric characters, spaces, and the following special characters: _ . + -, Maximum length is 255 characters.
Description	Description of the connection. Maximum length is 4000 characters.
Type	MongoDB V2
Runtime Environment	Name of the runtime environment where you want to run tasks. Select a Secure Agent or a serverless runtime environment¹.
Host	Node name or IP address of the primary shard in the MongoDB cluster.
Service Record Lookup Enabled	Allows the connector to query the DNS to discover all the available MongoDB servers in the MongoDB cluster. You can enable this property when the host name is associated with a DNS SRV record. With this property enabled, you do not need to specify a port, as the DNS record provides all the required details. If you don't enable this property, manually specify the host name and port for the MongoDB server in your connection properties.
Port	MongoDB server port number. Default is 27017.
¹ Applies only to mappings in advanced mode.

Authentication types

You can configure username and password and X.509 authentication types to access MongoDB.

Select the required authentication type and then configure the authentication-specific parameters.

Username and password authentication

Username and password authentication is the default type which requires at a minimum your MongoDB account user name and password to connect to MongoDB.

The following table describes the basic connection properties for username and password authentication:

Property	Description
User Name	User name to access the MongoDB server.
Password	Password corresponding to the user name to access the MongoDB server.
Database Name	Name of the MongoDB database that you want to connect to.
Additional Properties	Optional properties that you can configure to read data from or write data to MongoDB. For information about the additional properties that you can configure, see Additional connection properties. To specify more than one property, separate the key-value pairs with an ampersand. You can specify the properties in the following format: propertyName1=<value1>&propertyName2=<value2>

X.509 authentication

X.509 authentication requires your SSL keystore file path and SSL keystore file password to use X.509 certificate to connect to the MongoDB server.

The following table describes the basic connection properties for X.509 authentication:

Property	Description
SSL KeyStore File Path	The absolute path of the keystore file in the Secure Agent machine that contains the keys and certificates required to establish a secure communication. Ensure that you download the certificates and place them in the Secure Agent machine before you specify this parameter. For the serverless runtime environment, specify the following certificate path in the serverless agent directory: /home/cldagnt/SystemAgent/serverless/configurations/ssl_store/<keystore_filename> For more information, see Configure SSL for the serverless runtime environment.
SSL KeyStore Password	The password for the keystore file required for secure communication.
Database Name	Name of the MongoDB database that you want to connect to.
Additional Properties	Optional properties that you can configure to read data from or write data to MongoDB. For information about the additional properties that you can configure, see Additional connection properties. To specify more than one property, separate the key-value pairs with an ampersand. You can specify the properties in the following format: propertyName1=<value1>&propertyName2=<value2>

Related links