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 Cloud Accounts
    • 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

NS1

PreviousCloudflareNextPagerDuty

Last updated 1 month ago

Was this helpful?

Overview

Firefly integrates with NS1 to pull in information about your DNS records and zones as "assets". This means in your Firefly Inventory, you'll see NS1 DNS records listed (with their configurations) just like cloud assets. You can then enforce IaC or policies on them as well (for example, ensuring all DNS records follow a naming convention).

Prerequisites

  • An NS1 account with administrative access

  • An NS1 API key with appropriate permissions

  • Access to NS1 API endpoints

  • Ability to manage API keys

Setup Procedure

  1. Log in to your NS1 account

  2. Create an API Key by following the instructions in the

  3. In Firefly, select Settings > Integrations

  4. Select Add New > NS1

  5. Enter a descriptive name in the Nickname field

  6. Copy and paste your API key into the API Key field

  7. Select Next

Configuration Details

  • Firefly scans every 8 hours by default for SaaS data

  • Your NS1 DNS records list will stay updated automatically

  • You can enforce IaC or policies on your NS1 assets

  • Supports monitoring of:

    • DNS records

    • DNS zones

    • Record configurations

    • Zone settings

Best Practices

  1. Use a dedicated API key for Firefly integration

  2. Regularly rotate API keys for security

  3. Monitor API key usage in NS1

  4. Keep track of which NS1 assets are being monitored

  5. Review and update policies as needed

  6. Maintain proper access controls in NS1

  7. Ensure API key has minimum required permissions

Troubleshooting

  1. For API key issues:

    • Verify API key permissions

    • Check if the key has expired

    • Ensure the key has the correct access level

    • Review NS1 API key documentation

  2. For asset discovery issues:

    • Verify the integration is active in Firefly

    • Check if the API key has access to the required resources

    • Review Firefly integration logs

    • Verify NS1 zone configurations

  3. For policy enforcement issues:

    • Verify the asset types are supported

    • Check policy configuration

    • Review Firefly policy logs

    • Ensure NS1 resources are properly tagged

NS1 API Key Management Guide