How to Connect to MongoDb

Connect to an MongoDB Server

Read first the Connection dialog page to understand the dialog fields( host, port, user, etc. ), SSH tunnel, etc. For a detailed list of MongoDb features read this page.

DbSchema can connect to MongoDb using the native MongoDb Java URI, by choosing 'Manually Edit JDBC URL'. Without this option you can entering the host, port, etc. and DbSchema will compose the JDBC URL.

Tip DbSchema features for MongoDb are explained here.

Connect Using MongoDb Native URI

You can connect using the Java URI as in MongoDb documentation. In the DbSchema Connection Dialog choose 'Manual Edit JDBC URL'. You may connect to multiple hosts and use custom parameters. The connection parameters are described in the MongoDB documentation.
Custom URL

Connect to MongoDb Atlas Cloud

In the Atlas console choose 'Connect Cluster' to find the Java URI connection string. There choose 'Connect using Application' and 'Java' latest version. Copy the URL in the DbSchema 'Manual Configure JDBC URL' filed. This is the same procedure as in the chapter above.
MongoDB Atlas Console

Connect Using the Dialog Fields

In the connection dialog you can enter the host, port, user and password ( by default not required ). From the Driver combo you can choose between connecting without authentication and with authentication.

The connection without authentication is the default one, unless you or an admin have set authentication on the server.


How to connect to MongoDB

SSL/TSL & Further Connection Parameters

To add additional connectivity parameters and SSL/TLS, please press 'Manually Edit JDBC URL' and add parameters like in the MongoDB Java Driver Documentation. Use '&' as separator. The main parameters you can use:

  • Use DNS seed list connection string with mongodb+srv Example: mongodb+srv://server.example.com/
  • ssl=true/false - to enable disable TLS/SSL
  • tlsCertificateKeyFile Specifies the location of a local .pem file that contains either the client's TLS/SSL X.509 certificate or the client's TLS/SSL certificate and key
  • tlsCertificateKeyFilePassword Specifies the password to de-crypt the tlsCertificateKeyFile.
  • tlsCAFile Specifies the location of a local .pem file that contains the root certificate chain from the Certificate Authority. This file is used to validate the certificate presented by the mongod/mongos instance.
  • tlsAllowInvalidCertificates Bypasses validation of the certificates presented by the mongod/mongos instance
  • tlsAllowInvalidHostnames Disables hostname validation of the certificate presented by the mongod/mongos instance.
  • tlsInsecure Disables various certificate validations.

JVM System Properties for TLS/SSL

TLS/SSL can be enabled by editing the file DbSchema.vmoptions located in the same folder as DbSchema executable or ./DbSchema.app/Contents/vmoptions.txt on Mac OS, and adding one of the parameters below. A typical application will need to set several JVM system properties to ensure that the client is able to validate the TLS/SSL certificate presented by the server:
  • javax.net.ssl.trustStore: The path to a trust store containing the certificate of the signing authority
  • javax.net.ssl.trustStorePassword: The password to access this trust store
The trust store is typically created with the keytool command line program provided as part of the JDK. For example:
keytool -importcert -trustcacerts -file <path to certificate authority file>
            -keystore <path to trust store> -storepass <password>
A typical application will also need to set several JVM system properties to ensure that the client presents an TLS/SSL certificate to the MongoDB server:
  • javax.net.ssl.keyStore The path to a key store containing the client’s TLS/SSL certificates
  • javax.net.ssl.keyStorePassword The password to access this key store
The key store is typically created with the keytool or the openssl command line program.

The connection without authentication is the default one, unless you or an admin have set authentication on the server.

How to setup authentication in MongoDb server

To setup authentication in MongoDb follow this steps:
  1. Create the user in database:
    use admin
    db.createUser(
      {
        user: "test",
        pwd: "test",
        roles: [ { role: "root", db: "admin" } ]
      }
    );
     
  2. Create a file mongo.config in the MongoDB installation folder. Edit to
    # Basic database configuration
    dbpath = C:\data\db
    bind_ip = 127.0.0.1
    port = 27017
    
    # Security
    auth = true
    
    # Administration & Monitoring
    nohttpinterface = true
            
  3. Start the mongodemon using mongod.exe -f mongo.config. You can text the connection using mongo.exe --port 20571 -u test -p test --host 127.0.0.1 admin .