> ## 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

> Conecte o Cloudflare WAF ao Myrmex com um token de API — crie o token e adicione a integração.

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

Conecte o **Cloudflare WAF** para que o Myrmex possa revisar suas regras personalizadas de zona, rate limiting, managed rulesets, IP Lists e Security Events — e, com aprovação, ajudar você a gerenciá-los. O Myrmex acessa a **API da Cloudflare** através de um [Collector](/pt/documentation/agent-endpoint-security/collector-mode) na sua rede, consultando-a em tempo real.

## O Que o Myrmex Pode Fazer

<CardGroup cols={2}>
  <Card title="Regras e rate limiting" icon="shield-halved">
    Revise as regras personalizadas de zona e o rate limiting, e proponha ajustes.
  </Card>

  <Card title="Managed rulesets" icon="layer-group">
    Inspecione os managed rulesets implantados e sua configuração.
  </Card>

  <Card title="IP Lists" icon="list">
    Revise as IP Lists de conta usadas em suas regras.
  </Card>

  <Card title="Security Events" icon="magnifying-glass">
    Consulte os Security Events durante as investigações, em tempo real.
  </Card>
</CardGroup>

## Antes de Começar

* Um **Collector** que consiga acessar a API da Cloudflare (`https://api.cloudflare.com`) por HTTPS. Consulte [Implantando o agente](/pt/documentation/agent-endpoint-security/installation).
* Seu **Cloudflare Zone ID** (para regras e eventos do WAF de zona) e **Account ID** (para IP Lists e managed rulesets).
* Permissão para criar um **token de API**.

## Passo 1 — Criar o Token de API na Cloudflare

A credencial de que o Myrmex precisa é um **token de API**, usado como um token Bearer, com permissões de WAF.

<Steps>
  <Step title="Abra os API Tokens">
    No painel da Cloudflare, vá para **My Profile → API Tokens → Create Token** e inicie um token personalizado.
  </Step>

  <Step title="Conceda permissões de WAF">
    Adicione **Zone → Zone WAF** e **Zone → Firewall Services** (para regras personalizadas, rate limiting e Security Events), além de permissões de nível de conta para **IP Lists** e **managed rulesets** — somente leitura para análise, edição para permitir mudanças.
  </Step>

  <Step title="Crie e copie o token">
    Conclua a criação do token e **copie-o agora** — ele é exibido apenas uma vez.
  </Step>

  <Step title="Encontre seu Zone ID e Account ID">
    O **Zone ID** aparece na página de visão geral da zona; o **Account ID** aparece na página inicial da sua conta.
  </Step>
</Steps>

<Tip>
  Prefira o privilégio mínimo: conceda primeiro permissões somente leitura e adicione escopos de edição apenas quando quiser que os agentes apliquem mudanças.
</Tip>

## Passo 2 — Adicionar a Integração no Myrmex

No **Directory**, escolha **Add Integration → Cloudflare WAF** e preencha:

| Field           | Descrição                                                                                                 |
| --------------- | --------------------------------------------------------------------------------------------------------- |
| **Name**        | Um nome único para esta instância do Cloudflare WAF.                                                      |
| **Description** | Nota opcional para identificar a zona ou a conta.                                                         |
| **API Token**   | O token de API da Cloudflare (Bearer) do Passo 1.                                                         |
| **Account ID**  | Seu account ID da Cloudflare (para operações de WAF com escopo de conta: listas, managed rulesets).       |
| **Zone ID**     | Seu zone ID da Cloudflare (obrigatório para regras e eventos do WAF de zona).                             |
| **API URL**     | A URL base da API da Cloudflare (padrão `https://api.cloudflare.com/client/v4`).                          |
| **Collector**   | O [Collector](/pt/documentation/agent-endpoint-security/collector-mode) que acessará a API da Cloudflare. |
| **Auth Type**   | Método de autenticação (predefinido como `bearer` — não altere).                                          |

## Conectar

Clique em **Connect** para validar o token e concluir. O Cloudflare WAF então aparece em **Environment → Integrations**, e você pode começar a perguntar sobre ele ao [Hydra](/pt/documentation/multi-agent-system/integration-specialist-agent) no Workspace.

<Note>
  Seu token de API é armazenado com segurança e resolvido no lado do servidor — ele nunca passa pela IA, e o Myrmex consulta a Cloudflare sob demanda em vez de armazenar seus dados.
</Note>
