middleware

Documentation

Index

• Constants
• func TokenFromContext(ctx context.Context) model.Token
• type Error
  • func (e Error) Description() string
• type ErrorHandler
• type Handler
  • func JWT(eh ErrorHandler, c validator.Config) (Handler, error)

Constants

const (
	//ErrorTokenIsEmpty means that middleware could not find Bearer JWT token in headers
	ErrorTokenIsEmpty = "middleware.token_is_empty"
	//ErrorTokenIsInvalid token validation failed
	ErrorTokenIsInvalid = "middleware.token_is_invalid"
)

const (
	// AuthorizationHeaderKey is a header name for Bearer token.
	AuthorizationHeaderKey = "Authorization"
	// TokenTypeAccess is an access token type.
	TokenTypeAccess = "access"
	// TokenTypeRefresh is a refresh token type.
	TokenTypeRefresh = "refresh"
	// AccessTokenContextKey context key to store and retreive access token
	AccessTokenContextKey = "identifo.token.access"
	// RefreshTokenContextKey context key to store and retreive refresh token
	RefreshTokenContextKey = "identifo.token.refresh"
)

Functions

func TokenFromContext

func TokenFromContext(ctx context.Context) model.Token

TokenFromContext returns token from request context. Or nil if there is no token in context.

Types

type Error

type Error string

Error represents error for middleware

func (Error) Description

func (e Error) Description() string

Description returns description for error

type ErrorHandler

type ErrorHandler interface {
	Error(rw http.ResponseWriter, errorType Error, status int, description string)
}

ErrorHandler interface for handling error from middleware rw - readwriter to write error to (JSON, HTML or other error to the client) errorType - error returned from middleware, you can get description by calling errorType.Description() status - http status code

type Handler

type Handler func(rw http.ResponseWriter, r *http.Request, next http.HandlerFunc)

Handler is a full copy of negroni.HandlerFunc this is the same http.HandlerFunc, it just has one additional parameter 'next' next is a reference to the next handler in the handler chain

func JWT

func JWT(eh ErrorHandler, c validator.Config) (Handler, error)

JWT returns middleware function you can use to handle JWT token auth