# How to connect Digibee to MongoDB Atlas using VPN

To establish a connection between the Digibee Integration Platform and [MongoDB Atlas](https://www.mongodb.com/products/platform/atlas-database) using a Virtual Private Network (VPN), you need to contact [Digibee Customer Support](https://docs.digibee.com/documentation/troubleshooting/help-and-faq/support) and provide the following MongoDB Atlas details:

* The **cluster hostname**
* The **three hosts** used for load balancing by the main host

Once the VPN setup is complete, you can integrate MongoDB Atlas with Digibee using the [**MongoDB**](https://app.gitbook.com/s/EKM2LD3uNAckQgy1OUyZ/connectors/structured-data/mongodb) connector.

## **Connecting Digibee to MongoDB Atlas**

{% hint style="info" %}
Steps 1 and 2 should be performed within the MongoDB Atlas platform. Please note that the interface may change over time. If you are unable to follow these steps, please contact our [Support team](https://docs.digibee.com/documentation/troubleshooting/help-and-faq/support) and we will update the documentation accordingly.
{% endhint %}

{% stepper %}
{% step %}

### **Obtain the cluster hostname**

The **cluster hostname** is automatically generated by MongoDB Atlas and is included in the connection string provided by MongoDB.

For example, in the connection string `mongodb+srv://cluster0.71llx.mongodb.net`, the **cluster hostname** is `cluster0.71llx.mongodb.net`.

Follow these steps to find the cluster hostname in Mongo Atlas:

1. In the **MongoDB Atlas** platform, go to the **Deployment** section and click **Database**.
2. On the next page, click **Connect**.
3. Under **Setup connection security**, select **Connect your application**.
4. The following page displays the full connection string. The **cluster hostname** is part of this string and follows a structure like `@cluster0.71llx.mongodb.net`.
5. Copy the hostname and save it for later use.

<figure><img src="https://content.gitbook.com/content/boT4qPJIk6PZotrxlJWL/blobs/lnv46y0VSaGbdC6GHWGT/image3.png" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### **Obtain the three hosts**

In addition to the **cluster hostname**, you need to retrieve the three hosts used for load balancing by the main host.

For example, if the main host is `cluster0.71llx.mongodb.net`, the load-balancing hosts are:

* `cluster0-shard-00-00.71llx.mongodb.net:27017`
* `cluster0-shard-00-01.71llx.mongodb.net:27017`
* `cluster0-shard-00-02.71llx.mongodb.net:27017`

Follow the steps below to find the three hosts:

1. In **MongoDB Atlas**, go to the **Deployment** section and click **Database**.
2. On the next page, click **View Monitoring**.
3. Open the **Metrics** tab.
4. Locate and copy the three hosts listed, then save them for later use.

<figure><img src="https://content.gitbook.com/content/boT4qPJIk6PZotrxlJWL/blobs/RhDfUZ2lsoLOj83XeEmc/image2.png" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### **Provide the collected information to the Support team**

After gathering all the required details, contact the [Digibee Customer Support](https://docs.digibee.com/documentation/troubleshooting/help-and-faq/support) and share the following:

* The **cluster hostname**
* The **three hosts** used for load balancing

Once this information is provided, the Digibee Support team will configure your realm to enable the pipeline to connect to MongoDB Atlas via a VPN connection.
{% endstep %}
{% endstepper %}

## **Using MongoDB Atlas on Digibee**

### **Authenticating Mongo Atlas**

To authenticate MongoDB Atlas on Digibee, you need to provide the **connection string**. By default, MongoDB Atlas includes the **username** and **password** in the connection string, but we recommend removing these credentials and storing them in an [**Account**](https://app.gitbook.com/s/jvO5S91EQURCEhbZOuuZ/platform-administration/settings/accounts) on Digibee for enhanced security.

#### **Saving credentials as an Account on Digibee**

Follow these steps to securely store your MongoDB Atlas credentials:

1. On the **Digibee Integration Platform** home page, click **Settings** in the upper-right corner.
2. Navigate to the **Accounts** page.
3. Create a new Account and configure the following details:
   * **Account name:** Choose a name, such as `account-mongoatlas`.
   * **Account type:** Select **Basic**.
   * **Username and Password:** Enter the credentials from the **Database Access** page in MongoDB Atlas.

By storing credentials this way, you establish a secure connection between the Digibee Integration Platform and MongoDB Atlas via VPN, enabling your pipelines to access the database safely.

### **Connecting the pipeline to the database**

After the VPN configuration is complete, you can connect your pipeline to the database using the [**MongoDB**](https://app.gitbook.com/s/EKM2LD3uNAckQgy1OUyZ/connectors/structured-data/mongodb) connector.

#### **Required information:**

* The **Account** configured with the **Username** and **Password**.
* The **Connection String** (without credentials), for example: `mongodb+srv://cluster0.71llx.mongodb.net/<nomedobanco>`
* The **Database Name** and the **Collection Name**, which can be found in the **Collection** tab on **Data Services** on Mongo Atlas.

Here’s an example of the **MongoDB** connector configuration:

<figure><img src="https://content.gitbook.com/content/boT4qPJIk6PZotrxlJWL/blobs/j0kmo86O1kmyEo5FCrTo/MongoDB%20(En).png" alt=""><figcaption></figcaption></figure>