bearerware

A Go library to make using JSON Web Tokens in gRPC and HTTP requests more convenient. Middleware functions and examples for some popular routers are in the midleware directory.

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

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 extracts a valid JWT from a context.Contexts or returns and error

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 NewJWTAccessFromJWT

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

NewJWTAccessFromJWT creates a JWT credentials.Credentials which can be used 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