🔒 Patterns: OWASP CRS and Bad Bot Detection for Web Servers

Automate the scraping of OWASP Core Rule Set (CRS) patterns and convert them into Apache, Nginx, Traefik, and HAProxy WAF configurations.
Additionally, Bad Bot/User-Agent detection is integrated to block malicious web crawlers and scrapers.

🚀 Protect your servers against SQL Injection (SQLi), XSS, RCE, LFI, and malicious bots – with automated daily updates.

---

📌 Project Highlights

• 🛡️ OWASP CRS Protection – Leverages OWASP Core Rule Set for web application firewall (WAF) defense.
• 🤖 Bad Bot Blocking – Blocks known malicious bots using public bot lists.
• ⚙️ Multi-Web Server Support – Generates WAF configs for Apache, Nginx, Traefik, and HAProxy.
• 🔄 Automatic Updates – GitHub Actions fetch new rules daily and push updated configs.
• 📦 Pre-Generated Configurations – Download ready-to-use WAF configurations from GitHub Releases.
• 🧩 Scalable and Modular – Easily extendable to support other web servers or load balancers.

---

🌐 Supported Web Servers

• 🔵 Nginx
• 🟠 Apache (ModSecurity)
• 🟣 Traefik
• 🔴 HAProxy

Note

If you are using Caddy, check the caddy-waf project.

---

📂 Project Structure

patterns/
├── waf_patterns/           # 🔧 Generated WAF config files
│   ├── nginx/              # Nginx WAF configs
│   ├── apache/             # Apache WAF configs (ModSecurity)
│   ├── traefik/            # Traefik WAF configs
│   └── haproxy/            # HAProxy WAF configs
│── import_apache_waf.py
│── import_haproxy_waf.py
│── import_nginx_waf.py
│── import_traefik_waf.py
├── owasp.py                # 🕵️ OWASP scraper (fetch CRS rules)
├── owasp2nginx.py          # 🔄 Convert OWASP JSON to Nginx WAF configs
├── owasp2apache.py         # 🔄 Convert OWASP JSON to Apache ModSecurity configs
├── owasp2haproxy.py        # 🔄 Convert OWASP JSON to HAProxy WAF configs
├── badbots.py              # 🤖 Generate WAF configs to block bad bots
├── requirements.txt        # 📄 Required dependencies
└── .github/workflows/      # 🤖 GitHub Actions for automation
    └── update_patterns.yml

---

🛠️ How It Works

🔹 1. Scraping OWASP Rules

• owasp.py scrapes the latest OWASP CRS patterns from GitHub.
• Extracts SQLi, XSS, RCE, LFI patterns from OWASP CRS .conf files.

🔹 2. Generating WAF Configs for Each Platform

• owasp2nginx.py – Generates Nginx WAF configurations.
• owasp2apache.py – Outputs Apache ModSecurity rules.
• owasp2traefik.py – Creates Traefik WAF rules.
• owasp2haproxy.py – Builds HAProxy ACL files.

🔹 3. Bad Bot/User-Agent Detection

• badbots.py fetches public bot lists and generates bot-blocking configs.
• Supports fallback lists to ensure reliable detection.

---

⚙️ Installation

Option 1: Download Pre-Generated Configurations

You can download the latest pre-generated WAF configurations directly from the GitHub Releases page.

1. Go to the Releases section.
2. Download the zip file for your web server (e.g., nginx_waf.zip, apache_waf.zip).
3. Extract the files and follow the integration instructions below.

Option 2: Build from Source

If you prefer to generate the configurations yourself:

1. Clone the Repository:

git clone https://github.com/fabriziosalmi/patterns.git  
cd patterns

2. Install Dependencies:

pip install -r requirements.txt

3. Run Manually (Optional):

python owasp.py
python owasp2nginx.py
python owasp2apache.py
python owasp2haproxy.py
python owasp2traefik.py
python badbots.py

---

🚀 Usage (Web Server Integration)

🔹 1. Nginx WAF Integration

1. Download the nginx_waf.zip file from the Releases page.
2. Extract the files to your Nginx configuration directory.
3. Include the generated .conf files in your Nginx configuration:

   include /path/to/waf_patterns/nginx/*.conf;
   

🔹 2. Apache WAF Integration

1. Download the apache_waf.zip file from the Releases page.
2. Extract the files to your Apache configuration directory.
3. Include the generated .conf files in your Apache configuration:

   Include /path/to/waf_patterns/apache/*.conf
   

🔹 3. Traefik WAF Integration

1. Download the traefik_waf.zip file from the Releases page.
2. Extract the files and use the middleware.toml file in your Traefik configuration.

🔹 4. HAProxy WAF Integration

1. Download the haproxy_waf.zip file from the Releases page.
2. Extract the files and include the waf.acl file in your HAProxy configuration.

---

🔧 Example Output (Bot Blocker – Nginx)

map $http_user_agent $bad_bot {
    "~*AhrefsBot" 1;
    "~*SemrushBot" 1;
    "~*MJ12bot" 1;
    default 0;
}
if ($bad_bot) {
    return 403;
}

---

🤖 Automation (GitHub Workflow)

• 🕛 Daily Updates – GitHub Actions fetch the latest OWASP CRS rules every day.
• 🔄 Auto Deployment – Pushes new .conf files directly to waf_patterns/.
• 📦 Release Automation – Automatically creates a new release with pre-generated configurations.
• 🎯 Manual Trigger – Updates can also be triggered manually.

---

🤝 Contributing

1. Fork the repository.
2. Create a feature branch (feature/new-patterns).
3. Commit and push changes.
4. Open a Pull Request.

---

📄 License

This project is licensed under the MIT License.
See the LICENSE file for details.

---

📞 Need Help?

• Issues? Open a ticket in the Issues Tab.

---

🌐 Resources

• OWASP CRS
• Apache ModSecurity
• Nginx
• Traefik
• HaProxy