Cloudflare Security Insights
Beta Feature
This input is currently in beta. If you run into any issues, please reach out to product@monad.com.
Ingests security insights and issues from Cloudflare's Security Center. This input collects information about compliance violations, exposed infrastructure, insecure configurations, weak authentication methods, and email security issues discovered within your Cloudflare account.
Sync Type: Full Synchronisation
Requirements
- A Cloudflare account with access to Security Center (available on all plans)
- An API Token with the
Account:ReadorSecurity Center:Readpermission - Your Cloudflare Account ID
- For API access to Security Insights: Free, Pro, and Business plans have limited API access (100 requests/month); Enterprise plans have higher quotas (2,500 requests/month)
Creating an API Token
- Log in to your Cloudflare dashboard
- Navigate to My Profile > API Tokens
- Click Create Token
- Use the Create Custom Token option
- Configure the token:
- Token name: Give it a descriptive name (e.g., "Monad Security Insights")
- Permissions: Add
Account>Account Settings>Read(or more granularSecurity Centerpermission if available) - Account Resources: Select the specific account(s) or "All accounts"
- Click Continue to summary and then Create Token
- Copy the token value (you won't be able to see it again)
Finding Your Account ID
- Log in to your Cloudflare dashboard
- Select the account you want to monitor
- The Account ID is displayed in the right sidebar on the overview page
- Alternatively, find it in the URL:
https://dash.cloudflare.com/{account_id}/...
Details
- State Management: Fetches the complete inventory of security insights on each run. Every run collects all insights again, including ones that have not changed since the previous run.
- API Endpoint:
GET /accounts/{account_id}/security-center/insights - Pagination: Page-based pagination with up to 1000 records per page
- Filtering: Supports optional filtering by severity level (Low, Moderate, High, Critical) and issue type (compliance_violation, email_security, exposed_infrastructure, insecure_configuration, weak_authentication)
- Rate Limits: Plan-dependent quotas apply. Each run pages through all insights, so on plans with a monthly request allowance an hourly schedule can use it up. Use a less frequent cron schedule if needed.
Configuration
Settings
| Setting | Type | Required | Default | Description |
|---|---|---|---|---|
account_id | string | Yes | - | Your Cloudflare account ID |
cron | string (cron) | Yes | 0 * * * * | Cron string for scheduling the ingest of your input. eg: 0 0 * * * - Daily at midnight, or */15 * * * * - Every 15 minutes. Defaults to an hour. |
severity | array of string | No | - | Filter to include only specific severity levels. If empty, all severities are included. Allowed values: low, moderate, high, critical. |
exclude_severity | array of string | No | - | Filter to exclude specific severity levels. Applied after the include filter. Allowed values: low, moderate, high, critical. |
issue_type | array of string | No | - | Filter to include only specific issue types. If empty, all types are included. Allowed values: compliance_violation, email_security, exposed_infrastructure, insecure_configuration, weak_authentication. |
exclude_issue_type | array of string | No | - | Filter to exclude specific issue types. Applied after the include filter. Allowed values: compliance_violation, email_security, exposed_infrastructure, insecure_configuration, weak_authentication. |
use_synthetic_data | bool | No | false | Generate synthetic data for testing, instead of connecting to a real data source. Defaults to an hourly cron schedule for cron-based inputs. |
rate_limit | object | No | - | Maximum outbound source-API request rate. A blank or zero value falls back to the connector's default rate-limiting behavior. Maximum 4 requests per second. See API Rate Limiting for the field format. |
Secrets
| Secret | Type | Required | Description |
|---|---|---|---|
api_token | secret | Yes | Your Cloudflare API token with Account |
Rate Limits
| Plan | Limit | Window | Notes |
|---|---|---|---|
| Free / Pro / Business | 100 | requests per month | Limited API access to Security Insights |
| Enterprise | 2,500 | requests per month | Higher quota for enterprise customers |
Headers: Authorization: Bearer {api_token}
Source: Cloudflare Security Center API Documentation
Troubleshooting
Common Issues
Issue: API returned success=false with authentication error
Cause: The API token is invalid, expired, or lacks the required permissions.
Solution: Verify your API token is correct and has the necessary permissions. Create a new token with Account:Read or Security Center:Read permissions if needed.
Issue: Account ID is required validation error
Cause: The Account ID field was left empty.
Solution: Enter your Cloudflare Account ID in the settings. You can find this in your Cloudflare dashboard.
Issue: Rate limit exceeded (429 error) Cause: Your plan's monthly API request quota has been reached or you're making too many requests too quickly. Solution: Check your plan's rate limit quota. For plans with limited access, consider reducing sync frequency or filtering to specific issue types. Upgrade to Enterprise for higher quotas.
Issue: No data returned despite having security issues Cause: All discovered issues may have been dismissed, or your filters are too restrictive. Solution: Verify your severity and issue_type filters are not excluding the data you expect. Check the Security Center dashboard to confirm issues exist.
Issue: API access not available for plan Cause: Your plan does not have API access to Security Insights endpoint, or the feature is not yet enabled on your account. Solution: Verify the Security Center API is available for your plan. Contact Cloudflare support if you believe this is an error.
Related Articles
- Cloudflare Security Center API Documentation
- Cloudflare Security Center Guide
- Cloudflare Security Insights Overview
- Cloudflare API Tokens
Sample Record
Code
Community transforms
The Monad Transforms Repository has ready-made transforms for this input. Import one into your organization, then add it to a pipeline after this input.
| Format | Transform |
|---|---|
| OCSF v1.9.0 | Cloudflare Security Insights to OCSF v1.9.0 |
| ECS v9.5.0 | Cloudflare Security Insights to ECS v9.5.0 |
| CEF | Cloudflare Security Insights to CEF |
CEF transforms emit an intermediate record; add the CEF Serializer transform after one to produce the CEF:0 string.