LogoLogo
  • Welcome to Firefly Documentation
  • Introduction
    • What is Firefly?
    • Who is Firefly for?
    • Why use Firefly?
    • Terminology (Glossary)
  • Key Features
    • Infrastructure-as-Code Automation
    • Cloud Asset Inventory
    • Drift Detection & Remediation
    • Policy-as-Code for Compliance & Governance
    • Cost Visibility & Optimization
    • AI Assistant
    • ChatOps Integration
  • Getting Started
    • Account Setup & Onboarding
    • Connecting Additional Integrations
    • UI Walkthrough & Navigation
    • First Steps in Firefly
  • Detailed Guides
    • Dashboard Overview
    • Cloud Asset Inventory
      • Remediating Drifts
      • Deleting Assets
      • Creating IaC-Ignore Rules
      • Creating Exclude-Drift Rules
    • Policy & Governance
      • Creating Policy-as-Code Governance Rules
      • Remediating Policy Violations
    • Workflows & Guardrails
      • Creating Workflows
      • Creating Guardrail Rules
    • Codification
    • Self-Service
    • IaC Explorer
    • Event Center
    • Backup and Disaster Recovery
    • Notifications
    • User Management
    • SSO Configuration
  • Integrations
    • Integrations Overview
    • Integrating Data Sources
      • AWS
      • Azure
      • Google Cloud
      • Kubernetes
      • Akamai
      • Datadog
      • New Relic
      • Okta
      • GitHub
      • Cloudflare
      • NS1
      • PagerDuty
      • MongoDB Atlas
      • HashiCorp Vault
    • Integrating IaC Remote State
      • Terraform Cloud
      • Google Cloud Storage
      • env0
      • HashiCorp Consul
      • Firefly States Redactor
    • Integrating Version Control
      • GitHub
      • GitLab
      • Azure DevOps
      • CodeCommit
      • Bitbucket
    • Integrating Notifications
      • Slack
      • Microsoft Teams
      • PagerDuty
      • Opsgenie
      • Torq
      • Webex
      • Google Chat
      • Webhook
    • Integrating Project Management
      • Jira
      • ServiceNow
    • Integrating Workflows with CI/CD
    • Integrating Backstage
    • Integrating MCP
  • Use Cases & Best Practices
    • Cloud Governance & Visibility
    • Cost Optimization Strategies
    • Compliance and Security Best Practices
    • Infrastructure Automation & Self-Service
    • Best Practices and Implementation Tips
  • Analytics & Reporting
    • Analytics Dashboard Overview
    • Using Analytics for Improvement
    • Exporting and Sharing Reports
    • Analytics Security and Privacy
  • Code Snippets & Examples
    • Terraform Snippet for an AWS EC2 Instance (Codified via Firefly)
    • Example Rego Policy (OPA) for a Custom Rule
    • GitHub Actions Workflow YAML for Firefly Integration
    • JSON Output Example: Exporting Inventory
  • Troubleshooting & FAQs
    • Common Issues and Solutions
    • FAQs
  • General Information
    • Firefly API
      • Authentication
      • Inventory
      • Codification
      • Workflows
      • Self-Service
      • Policy & Governance
      • IaC Explorer
      • Event Center
      • Backup & Disaster Recovery
      • Notifications
      • Integrations
      • Identity & Access Management
    • Security & Compliance
    • Pricing Tiers & Add-ons
    • Contacting Support
Powered by GitBook
On this page
  • Overview
  • Prerequisites
  • Setup Procedure
  • Configuration Details
  • Best Practices
  • Troubleshooting

Was this helpful?

  1. Integrations
  2. Integrating Data Sources

MongoDB Atlas

PreviousPagerDutyNextHashiCorp Vault

Last updated 2 months ago

Was this helpful?

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

  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

https://cloud.mongodb.com/