Overview:
This guide provides a step-by-step process of integrating MongoDB Atlas with Axiom Security.
Prerequisites:
In order to complete this integration you will need the following:
Axiom Tenant admin access
MongoDB Atlas admin rights
Project Owner Rights
Quick Summary:
Configure API Key with organization read-only permission
Provide Token with Project level access
Onboard the API key details in Axiom Web Application
Full Steps:
MongoDB Atlas side.
In MongoDB Atlas administration console perform the following steps to create an integration token:
Enter organization settings by clicking the settings wheel:
Here you will see the Organization ID:
Under Access Manager menu item, click the API Keys tab, and then click the Create API Key button:
Put any description you like, then choose the Organization Read Only permission, then click Next:
Now save the Public Key and Private Key. Note that the only chance to copy the private key, is in this window:
Now go to Projects menu item, and select your desired project in the table, then click the 3 dots button and select Project Settings:
Here you can see the Project ID:
Click the Access Manager menu item, then the API Keys tab, and then click the Invite to Project button:
In the textbox drop-down, select your newly created token:
💡 Note: Please make sure to copy and set aside the following info:
Public Key
Private Key
Organization ID
Project ID
Then select the Project Owner permission and click Invite to Project:
💡 Very Important - If you have IP Access List requirement enabled, please follow additional steps below.
Adding Axiom IP Addresses to MongoDB Atlas Access List
Under “Organization” —> “Settings” left side menu, please check if the optional “Require IP Access List for the Atlas Administration API” is enabled.
If it is enabled, on the left side menu enter “Access Manager” and under “API Access List” please click on “Add Access List Entry” button.
Inside, add the first Axiom IP address and click on the “Save” button. Repeat the procedure again for the second Axiom IP.
💡 Axiom IP Addresses
3.120.212.105 18.184.175.29
Axiom side:
In Axiom Security web application, on the left side navigation menu click on “Integrations”.
This will take you to the main integrations screen.
In the “Resource” section, find the MongoDB Atlas Icon and click on the “+Add” button.
You will be redirected to the MongoDB Atlas integration details screen.
Now, input the details you have set aside during the MongoDB side section.
In the “Name” field choose a meaningful name like “Production_Mongo_Atlas1”.
Click on the “Integrate” button.
After completion:
On the left side navigation menu, click on “Home”. There you should be able to see the newly added MongoDB Atlas section.