# MongoDB Provider

## MONGODB Configuration Process.

#### Welcome to Pier Cloud!

Pier Cloud is our centralized platform for managing cloud data and services. Our focus is to ensure that access to resources is secure, convenient, and efficient. This document is designed to guide you through setting up MONGODB.

Below, you will find a detailed process that explains each step clearly and concisely.

### In the MONGODB environment

1. To start the configuration, we need to access the MongoDB portal and create an API Key that will be inserted in the Platform configuration. Click on settings (on the gear) as illustrated in the image below.

<figure><img src="https://1687673077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ9sinLUl52lDK1vg6b8g%2Fuploads%2FBMO9O3FisFCsC9of6b9b%2FCaptura%20de%20Tela%202026-02-18%20a%CC%80s%2015.59.32.png?alt=media&#x26;token=2ef1e8f1-d349-4826-acd8-ca46fd454935" alt="" width="563"><figcaption></figcaption></figure>

2. Here, we need to note down the **Organization ID** (which will be used in the Platform configuration) and make sure that the **Require IP Access List for the Atlas Administration API** option is disabled. If this option is enabled, the Platform will not be able to connect. Then, click on **Access Manager** in the bottom left menu, as shown in the image below.

<figure><img src="https://lh7-rt.googleusercontent.com/slidesz/AGV_vUfZpIs5BCRjLniLSx-CUFDnknNcpK-b5njiLXXcvYwaKRnXDyqlskKng6qyLnXNKTDqRJrA8jknofVdUwph9C4dlnVMeBEeola14pS_CzYZOP1WZK0BRSA0yJw1PVOkSX-hvDz6GHXd9UZIP5k7HB9zKKRRYM41=s2048?key=eDcCql5uUGW4XXGEtanpoA" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1687673077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ9sinLUl52lDK1vg6b8g%2Fuploads%2Fg6zxIfPsU0qa5HfvCS3f%2FCaptura%20de%20Tela%202026-02-18%20a%CC%80s%2016.00.10.png?alt=media&#x26;token=4d5da53c-81d2-4979-b059-697f81c691a0" alt=""><figcaption></figcaption></figure>

3. Here click on **API Keys**, as illustrated in the image below.

<figure><img src="https://1687673077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ9sinLUl52lDK1vg6b8g%2Fuploads%2Fvka2HSUd5n6d9Qxb39cs%2FCaptura%20de%20Tela%202026-02-18%20a%CC%80s%2016.00.27.png?alt=media&#x26;token=50ce076a-63dd-438e-a806-85afb5cfb10e" alt=""><figcaption></figcaption></figure>

4. Here click on **Create API key**.

<figure><img src="https://1687673077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ9sinLUl52lDK1vg6b8g%2Fuploads%2FGI2mJft5HocjjPUEdlN8%2FCaptura%20de%20Tela%202026-02-18%20a%CC%80s%2016.00.42.png?alt=media&#x26;token=e56af6d7-7135-463c-8964-a28b371f72fe" alt=""><figcaption></figcaption></figure>

5. In this step, in the **Description** field, enter the name of the API, in the **Organization Permissions** field, select **Organization Billing Viewer** and **Organization Read Only**, as illustrated in the image below.

<figure><img src="https://lh7-rt.googleusercontent.com/slidesz/AGV_vUc20zoULIk_qTzH5vXtEKNF53cqI9a63PXZbmIrir_c_CvIyM30iw_ZpOc8J48-uMDMsqxrwORgvrkXzdcEJQD2mnGxWb2LOtU3WR0lqJ2Pr2vNXH2Rq9bKTimuDyNUpm2EV8U-l_ei5ApmjTdu77IXCKWWwrOB=s2048?key=eDcCql5uUGW4XXGEtanpoA" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://1687673077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ9sinLUl52lDK1vg6b8g%2Fuploads%2F31RauhoKiMfgr7ZuXnZG%2FCaptura%20de%20Tela%202026-02-18%20a%CC%80s%2016.00.53.png?alt=media&#x26;token=aa35e678-4fb1-4bb4-9ab8-8e80cdd38d22" alt=""><figcaption></figcaption></figure>

6. Here click on **Next**.

<figure><img src="https://1687673077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ9sinLUl52lDK1vg6b8g%2Fuploads%2FpITPSRIsXEGdA5tVQcNI%2FCaptura%20de%20Tela%202026-02-18%20a%CC%80s%2016.01.08.png?alt=media&#x26;token=f4dabc75-f0b0-4e6e-94c5-61e29324f41b" alt=""><figcaption></figcaption></figure>

7. Done! The **API Key** has been successfully created. Now, copy and paste the **key** into a notepad to use it later in the Platform configuration.

<figure><img src="https://1687673077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ9sinLUl52lDK1vg6b8g%2Fuploads%2FRJK6pB2yV94xg6gIcFmL%2FCaptura%20de%20Tela%202026-02-18%20a%CC%80s%2016.01.20.png?alt=media&#x26;token=1b5b5f2c-8480-480f-8034-4bd997d145ec" alt=""><figcaption></figcaption></figure>

8. Here, we have validated the creation of the API Key. With the necessary information noted down, we now need to configure it on the Platform.

<figure><img src="https://1687673077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ9sinLUl52lDK1vg6b8g%2Fuploads%2FmgokM12jtt01w6eUVlLY%2FCaptura%20de%20Tela%202026-02-18%20a%CC%80s%2016.01.37.png?alt=media&#x26;token=0ab01547-e80f-479e-88aa-819149b92c87" alt=""><figcaption></figcaption></figure>

### On the Pier Cloud Platform

1. On the Platform home page, click on the user icon located in the upper right corner. Then, select the **Settings** option, as illustrated in the image below.

<figure><img src="https://1687673077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ9sinLUl52lDK1vg6b8g%2Fuploads%2FCHGnCUyHOqrLdvbEFWZr%2Fimage.png?alt=media&#x26;token=7da4de41-e9f5-4322-842b-1e68047488bf" alt=""><figcaption></figcaption></figure>

2. In the bottom left menu, select the **Secrets** option.

<figure><img src="https://1687673077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ9sinLUl52lDK1vg6b8g%2Fuploads%2FGLbm2kUrDdDKphKvAh2d%2Fimage.png?alt=media&#x26;token=407e5267-2ed9-482e-a359-9067777ffbbe" alt=""><figcaption></figcaption></figure>

3. In the top right corner click on **+ Add** to create a Secret.

<figure><img src="https://1687673077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ9sinLUl52lDK1vg6b8g%2Fuploads%2F4sDegaYhorABYh7F4Gs5%2Fimage.png?alt=media&#x26;token=a83bf623-a464-4717-b251-2cb2164d5879" alt=""><figcaption></figcaption></figure>

4. In the **Name** field, enter a Name to identify the Secret. In **Type**, select Digest Auth (authentication type in MongoDB). In the User field, enter the Public Key (information obtained on step 10), and in the **Password** field, add the Private Key (information also obtained on step 10). Finally, click **Save** to create the Secret, as illustrated in the image below.

<figure><img src="https://1687673077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ9sinLUl52lDK1vg6b8g%2Fuploads%2FEF3KwmEqLYxFYzqO2U87%2Fimage.png?alt=media&#x26;token=4c76bf7d-f76f-4b15-89a1-603ac1229973" alt="" width="353"><figcaption></figcaption></figure>

5. The Secret has been successfully created! Now, proceed by clicking on **Data Connectors** in the bottom left menu,  and then click on **+ Add**, in the top right corner, to create the Data connector, as illustrated in the image below.

<figure><img src="https://1687673077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ9sinLUl52lDK1vg6b8g%2Fuploads%2FjV8NQLRWpuIOjp0VftNq%2Fimage.png?alt=media&#x26;token=09fbd52b-e5df-4d80-9d23-d3692211179b" alt=""><figcaption></figcaption></figure>

7. In the **Data Connector** field, select **MongoDB Atlas**. In "**Data Connector Identifier Nam**e", enter a name to identify the data connector. In the "**Select the secret for this data connector**" field, choose the **Secret** created in the previous step. In the "**Organization ID**" field, enter the ID obtained in slide 5. Finally, click **Save** to create the Data Connector, as illustrated in the image below.

<figure><img src="https://1687673077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ9sinLUl52lDK1vg6b8g%2Fuploads%2F0orpTg002afEn4OQyv6t%2Fimage.png?alt=media&#x26;token=8b4696fc-113b-4adf-b863-3c092ce0cb00" alt=""><figcaption></figcaption></figure>

8. That's it! The Data Connector has been successfully created and the MongoDB integration has been successfully configured.

<figure><img src="https://1687673077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ9sinLUl52lDK1vg6b8g%2Fuploads%2Fww5J7wrKBKYbHO4YUWFe%2Fimage.png?alt=media&#x26;token=bb07e7bc-d984-4f2b-a7db-17054ae2a75f" alt=""><figcaption></figcaption></figure>
