Create a MongoDB connection

  • Release version: Zurich
  • Updated July 31, 2025
  • 1 minute to read
  • Establish a zero copy connection to a MongoDB database in Workflow Data Fabric Hub.

    Before you begin

    Role required: df_connection_admin

    About this task

    Work with your data source admin to create a connection to MongoDB. For additional information about connecting, refer to the MongoDB connector documentation.

    Note:
    This connector was developed by the open-source community and made available through the ServiceNow AI Platform for general use. Functionality can vary and might not cover all use cases supported by primary connectors.

    Procedure

    1. Navigate to the available community connectors in Workflow Data Fabric Hub in one of the following ways:
      • Navigate to All > Workflow Data Fabric Hub > Available connectors > Community connectors.
      • Navigate to Admin > Workflow Data Fabric Hub > Available connectors > Community connectors.
    2. Find the MongoDB connector and select Connect.
    3. On the form, fill in the fields.
      Table 1. New MongoDB Connection form
      Field Description
      Name and description
      Connection label Unique name for this connection. This helps in identifying the connection within your system.
      Connection name System-generated name based on the Connection label. This field cannot be modified once the connection is established.
      Short description Description of the connection explaining what it is about.
      Connection attributes
      Connection URL URL to establish the connection. For example:

      mongodb://<host>:<port>/database_name?ssl=true&authSource=external&authMechanism=MONGODB-X509

    4. Configure secure authentication by providing truststore information.
      OptionDescription
      Upload truststore file
      1. Select Attach TrustStore file.
      2. Browse and select the truststore file.
      Enter truststore contents manually Copy and paste the contents of the keystore file.
    5. Configure secure authentication by providing keystore information.
      OptionDescription
      Upload keystore file
      1. Select Attach KeyStore file.
      2. Browse and select the keystore file.
      Enter keystore contents manually Copy and paste the contents of the keystore file.
    6. Enter the truststore password.
    7. Enter the keystore password.
    8. Select Connect.

    Result

    A test connection is made to the external data source, verifying that the connection details are correct and the data source is accessible.

    What to do next

    If the connection succeeds, configure data steward access on the Access Control tab. See Manage access to an established connection using roles.

    If the connection fails, verify the connection details with your data source administrator and try again.