bearerware

Package bearerware provides a library and middleware to make using JSON Web Tokens in gRPC and HTTP requests more convenient. Middleware functions and examples for popular routers are in the midleware directory.

This project was inspire by auth0/go-jwt-middleware.

Requires go1.7 or newer.

For more info see the example files and the GoDoc page.

-- import "github.com/ckaznocha/go-JWTBearerware"

Usage

func JWTFromContext

func JWTFromContext(
	ctx context.Context,
	keyFunc jwt.Keyfunc,
	signingMethod jwt.SigningMethod,
) (*jwt.Token, error)

JWTFromContext deprecated use JWTFromIncomingContext

func JWTFromHeader

func JWTFromHeader(
	r *http.Request,
	keyFunc jwt.Keyfunc,
	signingMethod jwt.SigningMethod,
) (*jwt.Token, error)

JWTFromHeader extracts a valid JWT from an http.Request or returns and error

func JWTFromIncomingContext

func JWTFromIncomingContext(
	ctx context.Context,
	keyFunc jwt.Keyfunc,
	signingMethod jwt.SigningMethod,
) (*jwt.Token, error)

JWTFromIncomingContext extracts a valid JWT from a context.Contexts or returns and error

func NewJWTAccessFromJWT

func NewJWTAccessFromJWT(jsonKey string) (credentials.PerRPCCredentials, error)

NewJWTAccessFromJWT creates a JWT credentials.PerRPCCredentials for use in gRPC requests.

func WriteAuthError

func WriteAuthError(w http.ResponseWriter, err error)

WriteAuthError is a convenience function for setting the WWW-Authenticate header and sending an http.Error()

type JWTContexter

type JWTContexter interface {
	WriteJWT(*http.Request, *jwt.Token)
	ReadJWT(*http.Request) (*jwt.Token, bool)
	DeleteJWT(*http.Request)
}

JWTContexter provides and interface for safe access to a shared map to get a jwt for the current request scope when using net/http.

func NewJWTContext

func NewJWTContext() JWTContexter

NewJWTContext creates a new JWTContexter