MongoDB Atlas

Overview

MongoDB Atlas integration allows you to connect your MongoDB Atlas clusters to Firefly. This integration enables Firefly to discover and track your MongoDB Atlas assets, including clusters, databases, and configuration details. This integration is particularly useful for tracking database-as-a-service (DBaaS) assets alongside your other infrastructure components.

Prerequisites

• MongoDB Atlas account with administrative access

• Ability to create API keys with Organization Read Only permissions

• Access to MongoDB Atlas API endpoints

• Required credentials:

  • API Public Key

  • API Private Key

  • Project ID

Setup Procedure

1. Log in to your MongoDB Atlas account at https://cloud.mongodb.com/

2. From the left menu, select Access Manager

3. Select your Organization

4. From the top menu, select API Keys > Create API Key

5. Enter a descriptive name for your API key

6. In Organization Permissions, select Organization Read Only and click Next

7. Copy both the Public Key and Private Key

8. In Firefly:

   • Navigate to Settings > Integrations

   • Click Add New > MongoDB Atlas

   • Enter a descriptive name in the Nickname field

   • Paste your Public Key and Private Key

   • Click Next to complete the integration

Configuration Details

• Supports monitoring of:

  • MongoDB Atlas clusters

  • Databases

  • Configuration details

  • Backup settings

  • Network settings

• Regular scanning of MongoDB Atlas assets

• Integration with Firefly's inventory management

• Support for policy enforcement on MongoDB Atlas resources

Best Practices

1. Use dedicated API keys for Firefly integration

2. Regularly rotate API keys for security

3. Monitor API key usage in MongoDB Atlas

4. Keep track of which MongoDB Atlas assets are being monitored

5. Review and update policies as needed

6. Maintain proper access controls in MongoDB Atlas

7. Ensure API keys have minimum required permissions

Troubleshooting

1. For API key issues:

   • Verify API key permissions

   • Check if the keys have expired

   • Ensure the keys have the correct access level

   • Verify Project ID is correct

2. For asset discovery issues:

   • Verify the integration is active in Firefly

   • Check if the API keys have access to the required resources

   • Review Firefly integration logs

   • Verify MongoDB Atlas organization settings

3. For policy enforcement issues:

   • Verify the asset types are supported

   • Check policy configuration

   • Review Firefly policy logs

   • Ensure MongoDB Atlas resources are properly tagged