vercel-firewall

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

Updated Aug 21, 2025
One-click install
npx skills add https://github.com/Adithiya-S/AI-Study-Companion --skill vercel-firewall-adithiya-s
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vercel-firewall
Source: https://github.com/Adithiya-S/AI-Study-Companion/tree/main/.agents/skills/vercel-firewall
Command: npx skills add https://github.com/Adithiya-S/AI-Study-Companion --skill vercel-firewall-adithiya-s

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Configuring and operating the Vercel Firewall (WAF custom rules, IP blocking, rate limiting, Attack Mode) involves many CLI subcommands, staged draft publishing, and risky production changes that can block real users if misconfigured. This Skill provides expert guidance and exact command patterns to manage platform-level security safely. ## Core Features & Use Cases - Custom WAF Rules: Create, edit, reorder, and inspect rules with conditions (path, geo, user agent, JA4 fingerprints) and actions (deny, challenge, log, bypass, rate_limit) using flags or JSON. - Staged Rollout Workflow: Follows a log-first, preview-block, then production-block rollout so new rules never take down legitimate traffic. - Rate Limiting & IP Management: Configure per-IP or per-JA4 rate limits, block IPs/CIDRs, and set system bypass rules for trusted networks. - Use Case: Your API is being hammered by abusive clients. Use this Skill to stage a rate_limit rule on /api with log mode, review hits in the Firewall dashboard, then tighten and publish to production. ## Quick Start Ask the assistant to add a Vercel Firewall rule that rate limits /api 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 --action rate_limit, --rate-limit-window, --rate-limit-requests, and --rate-limit-keys ip. Start with --rate-limit-action log and a generous limit, review dashboard traffic, then tighten and publish.

How do I block an IP address on Vercel?

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

Does Vercel DDoS protection require configuration?

No, automatic DDoS mitigation is enabled for every project on every plan including Hobby, covering L3, L4, and L7 attacks. Vercel does not bill for traffic blocked by DDoS mitigations or WAF rules.

Why did my Vercel Firewall rule block real users?

User-agent substrings and JA4 fingerprints are shared across many legitimate clients, so loose conditions over-match. Roll out rules in stages: log first, block in preview, then production, verifying dashboard traffic between steps.

Can AI agents run all vercel firewall commands?

No. The AI and interactive wizard modes of rules add are TTY-only, and attack-mode enable plus system-mitigations pause require interactive user confirmation due to severity. Agents should use --condition flags or --json for rule creation.