The MongoDB Connection Manager contains the following five pages to connect to your MongoDB server.

  • Servers
  • Authentication
  • SSL
  • SSH
  • Advanced

Servers Page

The Servers page on the MongoDB Connection Manager allows you to specify server addresses of your MongoDB deployment. You can add and remove server addresses as needed.

MongoDB Connection Manager - Servers Page

Host

The Host represents the Server containing your MongoDB server.

Port

The Port to your MongoDB server.

Authentication Page

The Authentication page allows you to specify how to authenticate to your MongoDB deployment.

MongoDB Connection Manager - Authentication Page

Authentication Mode

There are five different ways to authenticate:

  • None - MongoDB deployment does not require authentication
  • Basic - MongoDB deployment uses a simple username and password for authentication
  • X509 - MongoDB uses TLS\SSL (certificate) authentication
  • Kerberos - MongoDB uses a Kerberos service for authentication. (enterprise only)
  • LDAP - MongoDB uses LDAP proxy authentication. (enterprise only)
Username

The username used for Basic, Kerberos, or LDAP authentication

Password

The password used for Basic, Kerberos, or LDAP authentication

Authentication Database

The MongoDB database to use for Basic authentication. By default is 'admin'

SSL Page

The SSL page allows you to configure TLS\SSL related settings.

MongoDB Connection Manager - SSL Page

Use SSL

Specifies if SSL is enabled. By default SSL is disabled.

Server Certificate

This allows you to specify what server certificates to trust. There are three modes:

  • Accept All Server Certificates
  • Use CA File
  • Accept server certificates trusted by the operating system

The second option (Use CA File) allows you to specify the Client Authority and will validate server certificates against that.

Client Certificate

Provide the path and passphrase to the PFX file to use for authentication.

Note The MongoDB client uses a PEM file, however, the driver we use only supports PFX files so you will have to use OpenSSL to convert your PEM file to a PFX file.

Allow Invalid Hostnames

Enable only for development/testing purposes. Production MongoDB deployments should not require this option.

SSH Page

The SSL page allows you to configure TLS\SSL related settings.

MongoDB Connection Manager - SSH Page

Use SSH Tunnel

Specifies if SSH tunneling is enabled. This is disabled by default.

Host

The host address of the SSH server to tunnel through

Port

The port number of the SSH server to tunnel through

Authentication Method

Select one of two options:

  • Password - uses password to authenticate to SSH server
  • Key - uses key file to authenticate to SSH server
Path to Key File

Represents the path to the key file to use for Key authentication

Username

The username of the SSH user to authenticate with

Password

Represents the SSH user's password when using Password authentication. Represents the passphrase to the key file when using Key authentication.

Advanced Page

This page contains all possible settings for a MongoDB connection. The description for a selected property will be at the bottom of this page. For more details visit the MongoDB Documentation.

MongoDB Connection Manager - Advanced Page