filter_on_field

README

Filter on Field

Allows for filtering Traefik Requests based on parameters that are passed in to the request matching a particular regular expression.

Configuration Examples

Docker

label:
- traefik.http.middlewares.<middlewareName>.filter-on-field.fieldName='<fieldName>'
- traefik.http.middlewares.<middlewareName>.filter-on-field.disallowedContent='<disallowedRegex1>,<disallowedRegex2>'
- traefik.http.middlewares.<middlewareName>.filter-on-field.responseMessage="<Response Message>"

File (YAML)

http:
  routers:
    <routerName>:
      service: <serviceName>
      middlewares:
      - <middlewareName>
  middlewares:
    <middlewareName>:
      filter-on-field:
        fieldName: <fieldName>
        disallowedContent:
        - <disallowedRegex1>
        - <disallowedRegex2>
        responseMessage: <Response Message>

Parameter Precedence

Parameters are approached in the following order:

1. PUT or POST Form Fields
2. GET Query String Fields.

⚠ If the same field exists in bothe a URL Query String and a Form Request, only the Form Request Field will be evaluated

Disallowing Use Of A Parameter

middleware:
  filter-all-requests-with-disallowed-field:
    filter-on-field:
        fieldName: disallowedField
        disallowedContent:
        # Regex that matches everything...
        - .*

Documentation

Overview

This is the filter_on_field plugin. It contains the code that implements the Traefik interfaces, and filters requests based on the parameters passed in the configuration, allowing all values except those that match the disallowed content.

Index

• func New(ctx *Config, next http.Handler, name string) (http.Handler, error)
• type Config
• type Error
• type FilterOnField
  • func (f *FilterOnField) ServeHTTP(rw http.ResponseWriter, req *http.Request)

Functions

func New

func New(ctx *Config, next http.Handler, name string) (http.Handler, error)

Create a new instance of the filter. This is called by Traefik when the plugin is loaded and returns a new instance of the filter. It takes a configuration struct, the next handler in the chain, and the name of the filter.

Types

type Config

type Config struct {
	// contains filtered or unexported fields
}

A configuration struct for the filter. This is populated from the Traefik configuration, regardless of whether it's used via the dynamic configuration or the static configuration.

type Error

type Error struct {
	// contains filtered or unexported fields
}

An error type that can be returned by the filter

type FilterOnField

type FilterOnField struct {
	// contains filtered or unexported fields
}

The Filter On Field Struct that implements all of the Traefik interfaces in order to be used as a Traefik middleware plugin.

func (*FilterOnField) ServeHTTP

func (f *FilterOnField) ServeHTTP(rw http.ResponseWriter, req *http.Request)

The ServeHTTP method is called by Traefik when a request is received. It takes a response writer and a request. When the checks pass, it calls the next handler in the chain. When the checks fail, it returns an error response.