azolfagharj/apisix-coraza repository overview

🛡️ APISIX + Coraza WASM Integration Docker Image

This image combines Apache APISIX⁠ with the Coraza Proxy-WASM plugin⁠ for enhanced Web Application Firewall (WAF) support via WASM.

🔧 Normally, APISIX doesn't include the Coraza WASM plugin by default due to permissions and runtime integration complexities.
To simplify the process, this Docker image includes the Coraza plugin at build time, making it easier to use out of the box.

⁠🚀 How to use

By default, the container behaves just like the official APISIX image.
However, to enable the WAF plugin, you must add the following section to your config.yaml file:

wasm:
  plugins:
    - name: coraza-filter
      priority: 7999
      file: /usr/local/apisix/proxywasm/coraza-proxy-wasm.wasm

For more details and advanced usage:
🔗 Apache APISIX GitHub⁠
🔗 Coraza Proxy-WASM GitHub⁠

⁠🏷️ Version Tag Format

Docker image tags follow this format:

apisix-coraza:aX.X.X-cY.Y.Y

• aX.X.X: Refers to the version of Apache APISIX
• cY.Y.Y: Refers to the version of the Coraza Proxy-WASM plugin

📌 For example:

apisix-coraza:a3.12.0-c0.5.0

means:

• APISIX version: 3.12.0
• Coraza Proxy-WASM version: 0.5.0

📄 Licensing Notice
This image includes software licensed under the Apache License 2.0:

• Apache APISIX⁠
• Coraza Proxy-WASM⁠

You may redistribute and use this image under the terms of the Apache License 2.0.