vercel-firewall

Configure Vercel WAF rules, IP blocks, rate limits, and DDoS protections via CLI.

Updated Jul 31, 2026
One-click install
npx skills add https://github.com/AarnavBaddam/skills --skill vercel-firewall-aarnavbaddam
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vercel-firewall
Source: https://github.com/AarnavBaddam/skills/tree/main/vercel-firewall
Command: npx skills add https://github.com/AarnavBaddam/skills --skill vercel-firewall-aarnavbaddam

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Securing a Vercel project against attacks and abuse requires navigating custom WAF rules, IP blocking, rate limiting, and emergency attack response, and a single misconfigured rule can block real users or break production traffic. ## Core Features & Use Cases - Custom WAF Rules: Create, edit, reorder, and stage firewall rules with conditions on paths, headers, geo, JA4 fingerprints, and actions like deny, challenge, log, bypass, and rate_limit. - IP Blocking & System Bypass: Block abusive IPs or CIDRs and exempt trusted networks from all firewall checks, with staged drafts and publish workflows. - Attack Response & Rate Limiting: Guide Attack Mode activation, DDoS mitigation controls, and per-endpoint rate limit rules with a staged log-first rollout. - Use Case: When an API endpoint is being hammered by abusive clients, stage a rate_limit rule in log mode, review firewall metrics, then tighten and enforce it in production without touching legitimate traffic. ## Quick Start Ask the assistant to add a Vercel firewall rule that rate limits the /api path to 100 requests per minute per IP, staged as a draft 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 the rate_limit action, setting --rate-limit-window, --rate-limit-requests, and --rate-limit-keys. Start with --rate-limit-action log and a generous limit, then tighten after reviewing traffic in the dashboard.

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 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 blocked by DDoS mitigations or WAF denies, challenges, and rate limits. Usage is only incurred for requests served before mitigation kicked in or not classified as an attack.

Why can't an AI agent run vercel firewall rules add --ai or attack-mode?

The --ai and interactive wizard modes are TTY-only and blocked for agents and scripts, so use --condition flags or --json instead. Attack Mode and system-mitigations pause require explicit interactive confirmation and must be run by the user directly.

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.

How do I safely roll out a new Vercel WAF rule without blocking real users?

Stage the rule with --action log first, review matches in the firewall traffic dashboard filtered by rule ID, then enforce deny or challenge in preview before production. This staged rollout catches over-matching on shared JA4 fingerprints or user agents before real users are affected.