Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ckaznocha/go-jwtbearerware
A Golang library and middleware for using JSON Web Tokens in gRPC and HTTP projects.
https://github.com/ckaznocha/go-jwtbearerware
go golang grpc http jwt middleware
Last synced: about 1 month ago
JSON representation
A Golang library and middleware for using JSON Web Tokens in gRPC and HTTP projects.
- Host: GitHub
- URL: https://github.com/ckaznocha/go-jwtbearerware
- Owner: ckaznocha
- License: mit
- Created: 2016-03-14T20:05:57.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2017-04-22T03:44:42.000Z (over 7 years ago)
- Last Synced: 2024-06-21T03:11:08.920Z (7 months ago)
- Topics: go, golang, grpc, http, jwt, middleware
- Language: Go
- Size: 17.6 KB
- Stars: 12
- Watchers: 3
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# bearerware
[](https://travis-ci.org/ckaznocha/go-JWTBearerware)
[](https://coveralls.io/github/ckaznocha/go-JWTBearerware?branch=master)
[](http://ckaznocha.mit-license.org)
[](https://godoc.org/github.com/ckaznocha/go-JWTBearerware)
[](https://goreportcard.com/report/ckaznocha/go-JWTBearerware)
Package bearerware provides a library and middleware to make using [JSON Web Tokens](https://jwt.io/) 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](https://github.com/auth0/go-jwt-middleware).
Requires go1.7 or newer.
For more info see the example files and the [GoDoc](https://godoc.org/github.com/ckaznocha/go-JWTBearerware) page.
--
import "github.com/ckaznocha/go-JWTBearerware"
## Usage
#### func JWTFromContext
```go
func JWTFromContext(
ctx context.Context,
keyFunc jwt.Keyfunc,
signingMethod jwt.SigningMethod,
) (*jwt.Token, error)
```
JWTFromContext **deprecated** use `JWTFromIncomingContext`
#### func JWTFromHeader
```go
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
```go
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
```go
func NewJWTAccessFromJWT(jsonKey string) (credentials.PerRPCCredentials, error)
```
NewJWTAccessFromJWT creates a JWT credentials.PerRPCCredentials for use in gRPC requests.
#### func WriteAuthError
```go
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
```go
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
```go
func NewJWTContext() JWTContexter
```
NewJWTContext creates a new JWTContexter