---
title: "ezgh waf rules add"
description: "Add a rule to a WAF."
---

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

# ezgh waf rules add

{/* Generated by ezgh-cli's internal/tools/clidocs from the ezgh command tree. Don't edit: change the command's help in ezgh-cli and regenerate. */}

```sh
ezgh waf rules add <waf> --name n --action allow|block|log|rate-limit [conditions…] [--position p] [flags]
```

Add a rule of your own to a WAF, last or at `--position` (1 is first). Rules run top to bottom, before the managed rule sets, and the first that allows or blocks a request decides it. A rule's conditions all have to match:

```text
--ip-set c       the client's address is in one of these IPv4 or IPv6 CIDRs; repeat for more
--asn n          the client's network is one of these AS numbers; repeat for more
--country cc     the client's country is one of these (ISO 3166-1 alpha-2); repeat for more
--regex t=v      target t matches the regular expression v (no backreferences or lookaround)
--contains t=v   target t contains v
--equals t=v     target t is v
```

A target is path, query, method, header:&lt;name&gt;, cookie:&lt;name&gt;, or body, the first 16 KB of a request body. Text matches ignore case. `--rule-file` gives the whole rule as JSON instead, for negated or case-sensitive conditions.

`--action` allow lets the request through and skips the managed rule sets; block answers 403; log records it and goes on; rate-limit counts the requests it matches per client address, and blocks a client over `--rate-limit` per `--window` seconds (60, 300 or 600) until it's back under. `--mode` log on a rate-limit rule records instead of blocking (Log only).

Part of [`ezgh waf rules`](/cli/reference/waf-rules).

## Examples

```sh
ezgh waf rules add waf_k2m9x0a7qpe4 --name office --action allow --ip-set 203.0.113.0/24
ezgh waf rules add waf_k2m9x0a7qpe4 --name admin --action block --regex 'path=^/admin' --position 1
ezgh waf rules add waf_k2m9x0a7qpe4 --name login --action rate-limit --rate-limit 20 --window 60 --equals path=/login --equals method=POST
ezgh waf rules add waf_k2m9x0a7qpe4 --rule-file rule.json
```

## Flags

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--action` | string |  | allow, block, log or rate-limit |
| `--asn` | string, repeatable |  | match a client network with this AS number; repeat for more |
| `--contains` | string, repeatable |  | match a target that contains a value, target=value; repeat for more conditions |
| `--country` | string, repeatable |  | match a client in this country (ISO 3166-1 alpha-2); repeat for more |
| `--equals` | string, repeatable |  | match a target that is a value, target=value; repeat for more conditions |
| `--ip-set` | string, repeatable |  | match a client address in this IPv4 or IPv6 CIDR; repeat for more |
| `--mode` | string |  | a rate-limit rule's mode: block, or log to record and not block (default block) |
| `--name` | string |  | its name, unique in the WAF: 1 to 64 lowercase letters, digits and dashes |
| `--position` | int |  | where it goes, 1 for first (default last) |
| `--rate-limit` | int |  | a rate-limit rule's requests per client per window, 1 to 100000 |
| `--regex` | string, repeatable |  | match target=regex; repeat for more conditions |
| `--rule-file` | string |  | the rule as JSON (one entry of `ezgh waf get -o json`'s rules), - for stdin |
| `--window` | int | `60` | a rate-limit rule's window in seconds: 60, 300 or 600 |

This command also takes the [global flags](/cli/reference#global-flags).

Source: https://docs.ezghcloud.com/cli/reference/waf-rules-add/index.mdx
