MongoDB (Atlas Mongo)

MongoDB Integration Guide

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.	View users in the organization. View projects in the organization. View project settings. View groups in the organization. View group settings.
Organization Owner	Grants root access to the organization, including: Project Owner access to all projects in the organization, which grants database access, even if added to a project with a non-Owner role. Privileges to administer organization settings. Privileges to add/remove/edit Atlas users and database users within the organization. Privileges to delete the organization. All the privileges granted by the other organization roles combined.	View organization settings.

Follow these steps to create API Keys

1. Login into "https://cloud.mongodb.com"

2. Click on the gear icon (⚙️) 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"

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").

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.