Using Plugins

Overview#

Plugins are imported by calling the respective registration functions from the github.com/corazawaf/coraza/v3/experimental/plugins package:

• plugins.RegisterOperator(...)
• plugins.RegisterAction(...)
• plugins.RegisterBodyProcessor(...)
• plugins.RegisterTransformation(...)

Most plugins register themselves automatically via Go’s init() function. You just need to import them with a blank identifier:

package main

import (
    "github.com/corazawaf/coraza/v3"
    _ "github.com/someorg/my-awesome-plugin"
)

Available Official Plugins#

coraza-geoip#

Adds MaxMind GeoIP2 database support to Coraza, enabling geo-based rules.

import _ "github.com/corazawaf/coraza-geoip"

Repository: github.com/corazawaf/coraza-geoip

coraza-coreruleset#

Embeds the OWASP Core Rule Set for use with Coraza without manual file management.

import "github.com/corazawaf/coraza-coreruleset"

Repository: github.com/corazawaf/coraza-coreruleset

See the Core Ruleset tutorial for usage details.