jwtvalid

README

Module jwt_valid

{
    "pem_keypath": "",
    "secret": "",
    "has_claim": "" "",
}

Description

---

An HTTP middleware module that validates a JWT using the given query parameter access_token or Authorization header.

It will skip validation if the current HTTP request is an OPTIONS call

Validation can be performed using a given secret OR a public key provided in a PEM formatted file

Field List

---

pem_keypath

Path to PEM formatted public key file

secret

A text string containing a secret

has_claim

Optional additional validation to ensure given claims contain given values

Expressed as [name] [value] pairs

This field can repeat

Example

---

jwt_valid {
  secret "MyBigSecret"
  has_claim foo bar
  has_claim hello world
}

Build Instructions

The Makefile is used for all build operations. The file envfile is used for local environment customisations.

Please refer to https://caddyserver.com/docs/extending-caddy for details of configuring your environment and the use of xcaddy.

---

The current version of Caddy Server specified in the envfile is 2.2.1

---

Documentation

Index

• type JwtValid
  • func (JwtValid) CaddyModule() caddy.ModuleInfo
  • func (jtv *JwtValid) Provision(ctx caddy.Context) error
  • func (jtv JwtValid) ServeHTTP(resp http.ResponseWriter, req *http.Request, next caddyhttp.Handler) error
• type Validator
  • func NewValidator(pemFilePath string, secret string, hasClaims *map[string]string, ...) *Validator
  • func (v Validator) Valid(token string) (bool, error)

Types

type JwtValid

type JwtValid struct {
	KeyPath string            `json:"pemkeypath,omitempty"`
	Secret  string            `json:"secret,omitempty"`
	Claims  map[string]string `json:"hasclaims,omitempty"`
	// contains filtered or unexported fields
}

func (JwtValid) CaddyModule

func (JwtValid) CaddyModule() caddy.ModuleInfo

func (*JwtValid) Provision

func (jtv *JwtValid) Provision(ctx caddy.Context) error

func (JwtValid) ServeHTTP

func (jtv JwtValid) ServeHTTP(resp http.ResponseWriter, req *http.Request, next caddyhttp.Handler) error

type Validator

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

func NewValidator

func NewValidator(pemFilePath string, secret string, hasClaims *map[string]string, logger *zap.Logger) *Validator

func (Validator) Valid

func (v Validator) Valid(token string) (bool, error)