Skip to main content
Theย Cloudflare integrationย enables AirMDR to authenticate with Cloudflare and access account- or zone-level configuration and security context required for alert enrichment, investigation, and workflow automation. Depending on the use case, AirMDR may use either aย legacy Global API Keyย with the account email, or a scopedย API Tokenย with specific permissions. Cloudflare recommends usingย API tokens whenever possibleย because they are more secure and more narrowly scoped than Global API Keys.
  • Access to a Cloudflare account with administrative privileges.
  • At least one domain (zone) added to your Cloudflare account.
  • Access to the requiredย accountย andย zone.
  • Permission to create:
    • API Tokens, or
    • Access legacy Global API Key
  • Secure storage for the generated credentials
Cloudflare supportsย two authentication methodsย for AirMDR integration:
  • Uses:
    • Cloudflareย account email
    • Global API Key
    • Account ID
  • Providesย full account-level access
  • Should only be used if API Token is not feasible
    Uses:
    • Cloudflareย account email
    • Global API Key
    • Account ID
  • Providesย full account-level access
  • Should only be used if API Token is not feasible

Required Parameters

Useย API Token method wherever possibleย for better security and control.

๐Ÿ”‘ Cloudflare Integration Guide

This guide outlines the process of retrieving key credentials from your Cloudflare dashboard for integration with external tools and APIs. Method 1: Generate API Token (Recommended) Method 2: Generate Global API Key (Legacy)

Method 1 - Generate API Token Setup steps

To generate an API Token in the Cloudflare Platform for integrating with AirMDR, follow these steps:
1

Sign In to Cloudflare

  1. Go to Cloudflare dashboard.
  2. Enter your login credentials and sign in.
2

Create API Token

  1. Click yourย profile iconย (top-right).
  2. Navigate toย My Profile โ†’ API Tokens.
  3. Click Create Token.
  4. Choose
    • Predefined template
      (OR)
    • Custom Token
  5. Configure:
    • Token Name
    • Permissions (Zone / Account level)
    • Resources (specific zones or all zones)
  6. Clickย Continue to summary โ†’ Create Token
    Token will only be visible once

    Copy and securely save the secret API Token in your preferred password manager or secure storage solution.
3

Retrieve Cloudflare Account ID

  1. From the main dashboard, select any of your active domains.
  2. In the left-hand sidebar, scroll down and click Overview (if not already selected).
  3. In the right-side panel (under โ€œAPIโ€ section), locate your Account ID.
  4. Click Copy to save it.
4

Retrieve Cloudflare Zone ID (Optional)

  1. From the Overview tab of your selected domain (zone).
  2. Scroll down to the section titled API or Zone ID.
  3. Locate the Zone ID and click Copy.
    The Zone ID uniquely identifies your domain within Cloudflare.
    Email the API Token, Cloudflare Account ID and Cloudflare Zone ID to AirMDR
    or
    Self configure Cloudflare in the AirMDR Integrations Dashboard.

Method 2: Generate Global API Key (Legacy) Setup steps

To generate an Global API key in the Cloudflare Platform for integrating with AirMDR, follow these steps:
1

Sign In to Cloudflare

  1. Go to Cloudflare dashboard.
  2. Enter your login credentials and sign in.
2

Retrieve Your Authentication Email

Your authentication email is the email address you use to log into Cloudflare.

It will appear in the top-right corner of the dashboard once youโ€™re logged in.
This email is used along with your API key when authenticating API requests.
  1. Log in to the Cloudflare dashboard.
  2. Click yourย profile iconย in the top-right corner.
  3. Open yourย profile settings.
  4. Note the email address associated with the account.
    Use only this value as theย Authentication Emailย when AirMDR requires legacy Global API Key authentication
3

Retrieve the Global API Key (Authentication API Key)

  1. From the dashboard, click your profile icon in the top-right corner.
  2. Select My Profile โ†’ Go to the API Tokens tab.
  3. Under API Keysย section, locate Global API Key and click View.
  4. Enter your password to confirm.
  5. Click Copy to store the key securely.
    The Global API Key grants full account access.
    Copy and securely save the secret API key in your preferred password manager or secure storage solution. Use the Global API Key only if your AirMDR integration specifically requires the legacy authentication model.
4

Retrieve Cloudflare Account ID

  1. From the main dashboard, select any of your active domains.
  2. In the left-hand sidebar, scroll down and click Overview (if not already selected).
  3. In the right-side panel (under โ€œAPIโ€ section), locate your Account ID.
  4. Click Copy to save it.
5

Retrieve Cloudflare Zone ID (Optional)

  1. From the Overview tab of your selected domain (zone).
  2. Scroll down to the section titled API or Zone ID.
  3. Locate the Zone ID and click Copy.
    The Zone ID uniquely identifies your domain within Cloudflare.
    Email the Global API key, Authentication Email, Cloudflare Account ID, and Cloudflare Zone ID to AirMDR
    or
    Self configure Cloudflare in the AirMDR Integrations Dashboard.

Credential Path Reference

Test Cloudflare Authentication

  • YOUR_ACCOUNT_ID with your actual Cloudflare Account ID
  • YOUR_EMAIL@example.com with your Cloudflare account email
  • YOUR_GLOBAL_API_KEY with your Global API Key.
  • YOUR_API_TOKEN with your actual Cloudflare API Token

Configure Cloudflare in the AirMDR Integrations Dashboard

  1. Navigate to AirMDR, provide the credentials, and click Login
  2. Navigate to the AirMDR Integrations Dashboard in the left navigation pane and select Integrations.
  3. Use the search option, enter the keyword โ€œCloudflareโ€, select the Connections tab, and click Add New Connection.
  4. Enter an unique name to the Instance (e.g., your org name-Cloudflare) and brief Description to easily identify the user connection by AirMDR.
  5. Enter the generated Authentication API Key (Global API Key), and retrieved Authentication Email, Cloudflare Account ID, Cloudflare Zone ID and Expiry (optional) in the Authentication Details field params, and click Save.

Skills Provided by this Integration with required Permissions

Blocking traffic by country using an IP Access rule requires a Cloudflare Enterprise plan.
To view the details of Input Parameters and Output for the respective skills

Additional Information

DosDonโ€™ts
You can integrate Cloudflare with AirMDR using:Recommended:
  • API Token + Account ID + Zone ID
Alternative:
  • Email + Global API Key + Account ID + Zone ID