> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cloudflare

## Overview

This guide walks through how to create a Cloudflare connection and the permissions it requires to be used in Blink's Automated Case Management, across **Ingestion** and **Enrichment** workflows (WAF security events and network/zone context).

> [!NOTE]
>
> Cloudflare access is controlled by **API token permission groups** scoped to the relevant account and zone(s), rather than OAuth scopes. The permissions you need depend on which ingestion method you use. See [Required Permissions](#required-permissions).

***

## Creating a Connection

> [card] [Cloudflare Connection Guide](https://docs.blinkops.com/docs/integrations/cloudflare.md)
>
> Follow this guide to create a Cloudflare connection

***

## Required Permissions

Cloudflare access is controlled by API token permission groups. The permissions you need depend on which method the content uses:

| Method | Plan required | Permission | Access | Needed for | Role / token |
| - | - | - | - | - | - |
| Ingestion (Webhook) | Business plan or higher (Security Events Alert notifications aren't available on Free or Pro) | Notifications | `Read, Write` | Creating the Notification policy that delivers WAF events to the webhook | Account Administrator or Super Administrator role, or an API token scoped to Notifications Read/Write |
| Ingestion (Polling) | No specific plan required | Account Analytics | `Read` | Reading WAF events via the GraphQL Analytics API on a schedule, scoped to the target zone(s) | API token with the **Account → Account Analytics → Read** permission group, scoped to the target zone(s) under Zone Resources |
| Enrichment | No specific plan required | Zone | `Read` | Reading zone configuration and details | API token scoped to the relevant zone(s) |
| Enrichment | No specific plan required | Account | `Read` | Reading account-level context (e.g. Zero Trust account) | API token scoped to the relevant account |

> [accordion] Which stage of Alert Processing need this connection?
>
> | Source | Requires this connection? | Notes |
> | - | - | - |
> | Ingestion | ✓Yes | WAF security events via Webhook (Notifications) or Polling (Account Analytics) |
> | Enrichment | ✓ Yes | Zone / account context lookups (read permission groups) |
> | Response | ✗ No | Not applicable |

***
