Configuring MongoDB Accounts

Configuring MongoDB Accounts

.This page is no longer maintained (May 13, 2026). For the most current information, go to Configuring MongoDB Accounts.


 

Account Configuration

In SnapLogic, you can create accounts either for projects or in shared folders.

To create a MongoDB account: 

  1. Click on the project or shared folder for which you want to create the account. This displays a page that displays all the resources associated with the project or folder.

  2. Click Create > MongoDB, and then choose the MongoDB Account you want to create. 

    • Select MongoDB Account to connect to a single node.

    • Select Replica Set Account to connect to replica sets for operations. For more information on replication in MongoDB, see the Replication page in MongoDB documentation.

  3. Supply a Label for the account.

  4. Supply the necessary information for the appropriate account type:

    • MongoDB Account

    • Replica Set Account

    • MongoDB Dynamic Account

    • Replica Set Dynamic Account

      For detailed guidance on setting up each of these accounts, see the Account Types section below.

  5. Supply additional information on this account in the Notes field of the Info tab.

Account Types

MongoDB Account

 

Label

 

Required. User provided label for the account instance.

Default value: [None]

Use SRV hostname

Select this checkbox to enable SRV connection via the hostname.


Default state: Deselected

Hostname

Required. Specify the MongoDB hostname.

Default value: [None]
Example: ac-xyz80-shared-00-03.abc82h8.mongodb.net

Port

Required. Specify the MongoDB port.

Port number is optional if you select the Use SRV hostname checkbox.


Default value: [None]
Example: 27017

MongoDB JARs

Use this field to configure the MongoDB JARs.

MongoDB JARs

Specify or upload the MongoDB JAR file.


Default value: [None]
Example: mongodb-driver-sync-4.11.0.jar

Database name

 

The database that the MongoDB account is defined in. This is also the default database used for queries. 

Ensure to provide the database name when selecting the TLS/SSL option in the Encryption type property.

Default value: [None]

Username

 

Required. The MongoDB Username.

Default value: [None]

Password

 

Required. The password associated with the MongoDB Username.

Default value: [None]

Authentication type

 

Required. The authentication type that you want to use with this account. The options available are:

  • Default: No authentication

  • LDAP: Username/password retrieved from the configured LDAP server. LDAP Proxy Authentication

  • Plain: The username and password combination provided by your administrator.

  • X.509 (Digital Certificates): Issued by a certificate authority; or self-signed.

    Default value: Default

Encryption type

 

Required. The encryption type for connecting Mongo instance. The options available are None,  TLS/SSL and SSL certs

If None is selected, data is not encrypted.

If TLS/SSL is selected, data is encrypted without certificate validation. Ensure to provide the database name in the Database name property to validate the user against that particular database name.

If SSL certs is Selected, the data is encrypted ensuring the certificate validation.

Default value: None

SSL certs properties

Conditional. Configure the keystore and truststore properties only when the encryption type is selected as "SSL certs". This ensures the validation of the certificate.

Truststore filepath

The location of the trust store file in PKCS#12 format, can be in SLDB or any other unauthenticated endpoint such as https://...


Default value: [None]
Example: shared/cacert_keystore.p12

Truststore password

Truststorepassword to access the truststore file of the server.

Keystore filepath

The location of the key store file in PKCS#12 format, can be in SLDB or any other unauthenticated endpoint such as https://...


Default value: [None]
Example: shared/client_keystore.p12

Keystore file password

Keystore password to access the keystore file of the client. 

Connection properties

Configure the connection properties to specify connection and server selection timeouts.

Connection timeout (seconds)

The number of seconds the Mongo driver waits before aborting a new connection attempt. 
For example, if you set the Connection timeout limit to 30 seconds, and the Snap fails to establish a connection in 30 seconds, the pipeline logs a timeout exception and aborts execution.

A value of 0 seconds specifies an infinite timeout.

Default value: 10

Server Selection timeout (seconds)

The number of seconds the Mongo driver waits to select a server for an operation before aborting the selection. 

For example, if you set the Server Selection timeout to 30 seconds, and the Snap fails to find a server until 30 seconds, the pipeline logs an error and aborts execution.

A value of 0 seconds specifies an infinite timeout.

Default value: 30

MongoDB cursor properties

Use this field set to configure the MongoDB cursor timeout properties. 
This field set contains the Use Cursor Timeout field.

Use Cursor Timeout

Select this checkbox to set a timeout for idle cursors, which means, it enables the server to close a cursor automatically after a period of inactivity.

This option allows you to connect to Atlas Free Tier database and Shared Clusters using the MongoDB accounts. Refer to Atlas Free Tier limitations for more information.

For all the existing Mongo DB accounts, the Use Cursor Timeout check box  is deselected by default.

Default value: Not Selected

Account Encryption

Standard Encryption

If you are using Standard Encryption, the High sensitivity settings under Enhanced Encryption are followed.

 

Enhanced Encryption

If you have the Enhanced Account Encryption feature, the following describes which fields are encrypted for each sensitivity level selected for this account.

Account:

  • High: Password

  • Medium + High: Username, password

  • Low + Medium + High: Username, password, hostname, database name

 

Replica Set Account

 

Label

 

Required. User provided label for the account instance.

Default value: [None]

Replica Set Configuration

 

Required. Hostnames and ports for MongoDB replica set.

Default value: [None]

Hostname

The MongoDB Hostname
Default value: [None]

Port

The MongoDB port.

Default value: [None]

Database name

 

Required. The database that the MongoDB account is defined in. This is also the default database used for queries.

Default value: None

To validate a MongoDB Atlas account, enter the name as admin. Alternatively, to override the actual database name in the Database name property at the Snap settings level.

Username

 

Required. MongoDB Username 

Default value: [None]

Password

 

Required. The password associated with the MongoDB Username.

Default value: [None]

Authentication type

 

Required. The authentication type that you want to use with this account. The options available are:

  • Default: No authentication

  • LDAP: Username/password retrieved from the configured LDAP server. LDAP Proxy Authentication

  • Plain: The username and password combination provided by your administrator.

  • X.509 (Digital Certificates): Issued by a certificate authority; or self-signed.

Default value: Default

Encryption type

 

Required. The encryption type for connecting Mongo instance. The options available are None,  TLS/SSL and SSL certs

If None is selected, data is not encrypted.

If TLS/SSL is selected, data is encrypted without certificate validation.

If SSL certs is Selected, the data is encrypted ensuring the certificate validation.

Default value: None

To validate a MongoDB Atlas account, select TLS/SSL.

SSL certs properties

Conditional. Configure the keystore and truststore properties only when the encryption type is selected as "SSL certs". This ensures the validation of the certificate.

Truststore filepath

The location of the trust store file in PKCS#12 format, can be in SLDB or any other unauthenticated endpoint such as https://...

Example: shared/cacert_keystore.p12
Default value: [None]

Truststore password

Truststorepassword to access the truststore file of the server.

Keystore filepath

The location of the key store file in PKCS#12 format, can be in SLDB or any other unauthenticated endpoint such as https://...

Example: shared/client_keystore.p12
Default value: [None]

Keystore file password

Keystore password to access the keystore file of the client. 

Connection properties

Configure the connection properties to specify connection and server selection timeouts.

Connection timeout (seconds)

The number of seconds the Mongo driver waits before aborting a new connection attempt. 
For example, if you set the Connection timeout limit to 30 seconds, and the Snap fails to establish a connection in 30 seconds, the pipeline logs a timeout exception and aborts execution.

A value of 0 seconds specifies an infinite timeout.

Default value: 10

Server Selection timeout (seconds)

The number of seconds the Mongo driver waits to select a server for an operation before aborting the selection. 

For example, if you set the Server Selection timeout to 30 seconds, and the Snap fails to find a server until 30 seconds, the pipeline logs an error and aborts execution. 

A value of 0 seconds specifies an infinite timeout.

Default value: 30

MongoDB cursor properties

Use this field set to configure the MongoDB cursor timeout properties. 
This field set contains the Use Cursor Timeout field.

Use cursor timeout

Select this checkbox to set a timeout for idle cursors, which means, it enables the server to close a cursor automatically after a period of inactivity.

This option allows you to connect to Atlas Free Tier database and Shared Clusters using the MongoDB accounts. Refer to Atlas Free Tier limitations for more information.

For all the existing Mongo DB accounts, the Use Cursor Timeout check box is deselected by default.

Default value: Not Selected

 

Read preference

Choose an option to define read preference options when querying data. Available options are:

  • Primary

  • Primary preferred

  • Secondary

  • Secondary preferred

  • Nearest

Default value: Primary

 Account Encryption

Standard Encryption

If you are using Standard Encryption, the High sensitivity settings under Enhanced Encryption are followed.

 

Enhanced Encryption

If you have the Enhanced Account Encryption feature, the following describes which fields are encrypted for each sensitivity level selected for this account.

Account:

  • High: Password

  • Medium + High: Username, Password

  • Low + Medium + High: Hostname, Database name, Username, Password

 

 

MongoDB Dynamic Account

Label

 

Required. User provided label for the account instance.

Default value: [None]

Use SRV hostname

Select this checkbox to enable SRV connection via the hostname.


Default state: Deselected

Hostname

Required. Specify the MongoDB hostname.

Default value: [None]
Example: ac-xyz80-shared-00-03.abc82h8.mongodb.net

Port

Required. Specify the MongoDB port.

Port number is optional if you select the Use SRV hostname checkbox.


Default value: [None]
Example: 27017

MongoDB JARs

Use this field to configure the MongoDB JARs.

MongoDB JARs

Specify or upload the MongoDB JAR file.


Default value: [None]
Example: mongodb-driver-sync-4.11.0.jar

Database name

The database that the MongoDB account is defined in. This is also the default database used for queries. 

Ensure to provide the database name when selecting the TLS/SSL option in the Encryption type property.

Default value: [None]

Username

 

Required. MongoDB Username 

Enable the expression property to use a pipeline parameter.

Default value: [None]

Password

 

Required. The password associated with the MongoDB Username

Enable the expression property to use a pipeline parameter.

Default value: [None]

Authentication type

Required. The authentication type that you want to use with this account. The options available are:

  • Default: No authentication

  • LDAP: Username/password retrieved from the configured LDAP server. LDAP Proxy Authentication

  • Plain: The username and password combination provided by your administrator.

  • X.509 (Digital Certificates): Issued by a certificate authority; or self-signed.

Default value: Default

Encryption type

 

Required. The encryption type for connecting Mongo instance. The options available are None,  TLS/SSL and SSL certs

If None is selected, data is not encrypted.

If TLS/SSL is selected, data is encrypted without certificate validation.

If SSL certs is Selected, the data is encrypted ensuring the certificate validation.

Default value: None

SSL certs properties

Conditional. Configure the keystore and truststore properties only when the encryption type is selected as "SSL certs". This ensures the validation of the certificate.

Truststore filepath

The location of the trust store file in PKCS#12 format, can be in SLDB or any other unauthenticated endpoint such as https://...

Example: shared/cacert_keystore.p12
Default value: [None]

Truststore password

Truststorepassword to access the truststore file of the server.

Keystore filepath

The location of the key store file in PKCS#12 format, can be in SLDB or any other unauthenticated endpoint such as https://...

Example: shared/client_keystore.p12
Default value: [None]

Keystore file password

Keystore password to access the keystore file of the client. 

Connection properties

Configure the connection properties to specify connection and server selection timeouts.

Connection timeout (seconds)

The number of seconds the Mongo driver waits before aborting a new connection attempt. 
For example, if you set the Connection timeout limit to 30 seconds, and the Snap fails to establish a connection in 30 seconds, the pipeline logs a timeout exception and aborts execution.

A value of 0 seconds specifies an infinite timeout.

Default value: 10

Server Selection timeout (seconds)

The number of seconds the Mongo driver waits to select a server for an operation before aborting the selection. 

For example, if you set the Server Selection timeout to 30 seconds, and the Snap fails to find a server until 30 seconds, the pipeline logs an error and aborts execution.

A value of 0 seconds specifies an infinite timeout.

Default value: 30

MongoDB cursor properties

Use this field set to configure the MongoDB cursor timeout properties. 
This field set contains the Use Cursor Timeout field.