pac4j provides a security model and engine (specific behaviours). The “security filter” is in charge of protecting url, requesting authentication and optionally authorization.
In some cases, you may want to bypass this “security filter” and this can be done using the matchers parameter which is generally a list of matcher names. A matcher is generally defined in the security configuration.
A matcher can be defined by implementing the
Matcher interface. It has only one method:
boolean matches(WebContext context) to say if the “security filter” must be applied.
A few default matchers are available (but you can of course develop yours):
ExcludedPathMatcherallows you to exclude some paths (defined as a regular expression) from the security checks
HeaderMatcherallows you to check if a given header is
nullor matches a regular expression
HttpMethodMatcherallows you to check if the method of the HTTP request is one of the expected defined methods.