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

# Cloudflare WAF

> Collega il Cloudflare WAF a Myrmex con un token API: crea il token e aggiungi l'integrazione.

import { Note, Steps, Step, CardGroup, Card, Tip } from '@mintlify/components';

Collega il **Cloudflare WAF** affinché Myrmex possa esaminare le regole personalizzate della zona, il rate limiting, i ruleset gestiti, le IP Lists e i Security Events e, previa approvazione, aiutarti a gestirli. Myrmex raggiunge l'**API di Cloudflare** attraverso un [Collector](/it/documentation/agent-endpoint-security/collector-mode) sulla tua rete, interrogandola in tempo reale.

## Cosa può fare Myrmex

<CardGroup cols={2}>
  <Card title="Regole e rate limiting" icon="shield-halved">
    Esamina le regole personalizzate della zona e il rate limiting e proponi modifiche.
  </Card>

  <Card title="Ruleset gestiti" icon="layer-group">
    Ispeziona i ruleset gestiti distribuiti e la loro configurazione.
  </Card>

  <Card title="IP Lists" icon="list">
    Esamina le IP Lists dell'account utilizzate nelle tue regole.
  </Card>

  <Card title="Security Events" icon="magnifying-glass">
    Interroga i Security Events durante le indagini, in tempo reale.
  </Card>
</CardGroup>

## Prima di iniziare

* Un **Collector** in grado di raggiungere l'API di Cloudflare (`https://api.cloudflare.com`) su HTTPS. Consulta [Distribuzione dell'agente](/it/documentation/agent-endpoint-security/installation).
* Il tuo **Cloudflare Zone ID** (per le regole e gli eventi WAF della zona) e l'**Account ID** (per le IP Lists e i ruleset gestiti).
* L'autorizzazione a creare un **token API**.

## Passaggio 1 — Crea il token API in Cloudflare

La credenziale di cui Myrmex ha bisogno è un **token API**, usato come token Bearer, con autorizzazioni WAF.

<Steps>
  <Step title="Apri API Tokens">
    Nella dashboard di Cloudflare, vai su **My Profile → API Tokens → Create Token** e avvia un token personalizzato.
  </Step>

  <Step title="Concedi le autorizzazioni WAF">
    Aggiungi **Zone → Zone WAF** e **Zone → Firewall Services** (per regole personalizzate, rate limiting e Security Events), oltre alle autorizzazioni a livello di account per **IP Lists** e **managed rulesets**: sola lettura per l'analisi, modifica per consentire le modifiche.
  </Step>

  <Step title="Crea e copia il token">
    Completa la creazione del token e **copialo subito**: viene mostrato una sola volta.
  </Step>

  <Step title="Trova il tuo Zone ID e Account ID">
    Lo **Zone ID** si trova nella pagina di panoramica della zona; l'**Account ID** si trova nella pagina iniziale del tuo account.
  </Step>
</Steps>

<Tip>
  Preferisci il privilegio minimo: concedi prima le autorizzazioni di sola lettura e aggiungi gli ambiti di modifica solo quando vuoi che gli agenti applichino modifiche.
</Tip>

## Passaggio 2 — Aggiungi l'integrazione in Myrmex

Dal **Directory**, scegli **Add Integration → Cloudflare WAF**, quindi compila:

| Field           | Descrizione                                                                                                   |
| --------------- | ------------------------------------------------------------------------------------------------------------- |
| **Name**        | Un nome univoco per questa istanza di Cloudflare WAF.                                                         |
| **Description** | Nota opzionale per identificare la zona o l'account.                                                          |
| **API Token**   | Il token API di Cloudflare (Bearer) del Passaggio 1.                                                          |
| **Account ID**  | Il tuo Cloudflare account ID (per le operazioni WAF con ambito di account: liste, ruleset gestiti).           |
| **Zone ID**     | Il tuo Cloudflare zone ID (richiesto per le regole e gli eventi WAF della zona).                              |
| **API URL**     | L'URL base dell'API di Cloudflare (predefinito `https://api.cloudflare.com/client/v4`).                       |
| **Collector**   | Il [Collector](/it/documentation/agent-endpoint-security/collector-mode) che raggiungerà l'API di Cloudflare. |
| **Auth Type**   | Metodo di autenticazione (preimpostato su `bearer` — non modificare).                                         |

## Connetti

Fai clic su **Connect** per convalidare il token e completare. Il Cloudflare WAF comparirà quindi in **Environment → Integrations** e potrai iniziare a chiedere informazioni a [Hydra](/it/documentation/multi-agent-system/integration-specialist-agent) nel Workspace.

<Note>
  Il tuo token API viene memorizzato in modo sicuro e risolto lato server: non passa mai attraverso l'IA e Myrmex interroga Cloudflare su richiesta anziché memorizzarne i dati.
</Note>
