vercel-firewall

Configure Vercel Firewall rules, IP blocks, rate limits, and attack response via CLI.

Updated Sep 10, 2026
One-click install
npx skills add https://github.com/sharad07072007/paras --skill vercel-firewall-sharad07072007
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vercel-firewall
Source: https://github.com/sharad07072007/paras/tree/main/.agents/plugins/vercel/skills/vercel-firewall
Command: npx skills add https://github.com/sharad07072007/paras --skill vercel-firewall-sharad07072007

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Configuring and operating the Vercel Firewall and WAF through the CLI involves staged drafts, complex condition JSON, and risky production changes; this Skill guides safe rule creation, publishing, and attack response without blocking real users. ## Core Features & Use Cases - Custom WAF Rules: Create, edit, reorder, and stage rules with conditions on path, geo, headers, user agents, and JA3/JA4 fingerprints, with actions like deny, challenge, log, bypass, and rate_limit. - IP Blocks & System Bypass: Block abusive IPs or CIDRs and exempt trusted networks from all firewall checks, with staged publishing for safe rollout. - Attack Response & Rate Limiting: Enable Attack Mode during active attacks, tune rate limits per endpoint, and query firewall metrics via vc metrics for triage. - Use Case: When your API is being hammered by abusive clients, use this Skill to stage a rate-limit rule in log mode, review dashboard traffic, then progressively enforce it in preview and production. ## Quick Start Ask the assistant to add a Vercel Firewall rule that rate limits your /api endpoints to 100 requests per minute per IP and stage it for review.

Frequently Asked Questions about vercel-firewall

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a rate limit rule with the Vercel Firewall CLI?

Use vercel firewall rules add with a path condition and --action rate_limit, setting --rate-limit-window, --rate-limit-requests, and --rate-limit-keys ip. Start with --rate-limit-action log and a generous limit, then tighten after reviewing dashboard traffic.

How do I block an IP address on Vercel?

Run vercel firewall ip-blocks block with the IP or CIDR, optionally scoped to a hostname or annotated with notes. IP blocks are staged as drafts, so run vercel firewall publish --yes to make them live.

Does Vercel charge for traffic blocked by the WAF or DDoS mitigation?

No. Vercel does not bill for requests or bandwidth denied, challenged, or rate-limited by WAF custom rules, managed rulesets, or DDoS mitigations. You only pay for requests served before mitigation kicked in or not classified as an attack.

Why can't an AI agent enable Vercel Attack Mode directly?

Attack Mode requires interactive confirmation and is blocked for agents and scripts due to its severity, since it challenges all unverified visitors. The user must run vercel firewall attack-mode enable themselves in a terminal.

What is the difference between system bypass and a bypass custom rule on Vercel?

System bypass exempts trusted IPs or CIDRs from all firewall checks and takes effect immediately without publishing. A custom rule with the bypass action only skips remaining WAF custom rules and managed rulesets, and is staged as a draft.

When should I avoid blocking by JA4 fingerprint or user agent?

Avoid it when the fingerprint or UA substring could match real users, since a single JA4 is shared across millions of clients and UA tokens like bot or curl match legitimate tools. Stage the rule in log mode first and confirm only attacker traffic matches before blocking.