# MongoDB (Atlas Mongo)

## Introduction 

MongoDB is a source-available cross-platform document-oriented database program. Classified as a NoSQL database program, MongoDB uses JSON-like documents with optional schemas. This guide will walk you through the steps required to integrate MongoDB with Perimeters.

## Available Features

* Misconfiguration Rules
* Identity Rules
* User Inventory
* Shadow Application Rules
* Shadow Application Inventory

## Prerequisites

A MongoDB API Key with the following required privileges.

## Required Privileges

| Organization Role (UI) | Role Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | Role Use                                                                                                                                                                                                               |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Organization Read Only | Provides read-only access to the settings, users, and projects in the organization.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | <p></p><ul><li>View users in the organization.</li><li>View projects in the organization.</li><li>View project settings.</li><li>View groups in the organization.</li><li>View group settings.</li></ul><p></p><p></p> |
| Organization Owner     | <p></p><p>Grants root access to the organization, including:</p><ul><li><a href="https://www.mongodb.com/docs/atlas/reference/user-roles/#mongodb-authrole-Project-Owner"><code>Project Owner</code></a> access to all projects in the organization, which grants database access, even if added to a project with a non-Owner role.</li><li>Privileges to administer organization settings.</li><li>Privileges to add/remove/edit Atlas users and <a href="https://www.mongodb.com/docs/atlas/security-add-mongodb-users/#std-label-mongodb-users">database users</a> within the organization.</li><li>Privileges to delete the organization.</li><li>All the privileges granted by the other organization roles combined.</li></ul> | View organization settings.                                                                                                                                                                                            |

<details>

<summary><strong>Follow these steps to create API Keys</strong></summary>

1. Login into "<https://cloud.mongodb.com>"
2. Click on the gear icon (:gear:) on the navigation bar
3. Click on "Access Manager" on the left panel
4. Click on "Create API Key"
5. Provide a descriptive name in "Description" filed
6. Under "Organization Permissions" Select "Organization ReadOnly" & "Organization Owner" and Click "Next"
7. Copy the Private and Public Keys
8. Under "API Access List" Click "Add Access List Entry"
9. In the "Access List Entry" field add "52.45.176.119" and Click "Save" -> "Done"

</details>

## Onboarding MongoDB (Atlas Mongo) in your Perimeters account

Log in to your Perimeters account and navigate to the "Integrations" section. Select "MongoDB" from the list of available integrations and click on “Add Application”

1. **"Alias" -**\
   Provide a descriptive name for the integration (e.g. "My Mongo Integration").&#x20;
2. **"Namespace" -**\
   Fill in the domain name which you are using Mongo for. For example, if your Mongo domain name is "perimeters.io" you would enter "perimeters.io" in this field.
3. **"Email" -**\
   Input the email address of the Mongo Administrator.
4. **"Private Key" -**\
   Provide the Private Key previously created and click on "Continue"
5. **"Public Key" -**\
   Provide the Public Key previously created and click on "Continue"
6. Click **"Finish"** to complete the onboarding process.

Once you have completed these steps, Google Workspace (G Suite) should be successfully integrated with your Perimeters account.

<br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://support.perimeters.io/perimeters-documentation/connecting-perimeters/integrations-for-security-insights/saas-applications/mongodb-atlas-mongo.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.