http

Documentation

Index

• func CanonicalHref(href string) string
• func CreateAuthMiddleware(authInterceptor Interceptor, onUnauthorizedAccessFunc OnUnauthorizedAccessFunc) func(next netHttp.Handler) netHttp.Handler
• func CreateLoggingMiddleware(opts ...LogOpt) func(next http.Handler) http.Handler
• func DefaultCodeToLevel(code int, logger log.Logger) func(args ...interface{})
• func ErrToStatus(err error) int
• func ErrToStatusWithDef(err error, def int) int
• func ParseToken(auth string) (string, error)
• func ToURLString(scheme string, host string, path string) string
• func WantToLog(code int, logger log.Logger) bool
• type AuthArgs
• type Claims
• type ClaimsFunc
  • func MakeClaimsFunc(methods map[string][]AuthArgs) ClaimsFunc
• type DeniedClaims
  • func (c DeniedClaims) Valid() error
• type Interceptor
  • func NewInterceptor(jwksURL string, tls *tls.Config, auths map[string][]AuthArgs, ...) Interceptor
  • func NewInterceptorWithValidator(validator Validator, auths map[string][]AuthArgs, whiteList ...RequestMatcher) Interceptor
• type LogOpt
  • func WithLogger(logger log.Logger) LogOpt
• type OnUnauthorizedAccessFunc
• type RequestMatcher
• type Validator

Functions

func CanonicalHref

func CanonicalHref(href string) string

CanonicalHref always lead by "/"

func CreateAuthMiddleware

func CreateAuthMiddleware(authInterceptor Interceptor, onUnauthorizedAccessFunc OnUnauthorizedAccessFunc) func(next netHttp.Handler) netHttp.Handler

CreateAuthMiddleware creates middleware for authorization

func CreateLoggingMiddleware

func CreateLoggingMiddleware(opts ...LogOpt) func(next http.Handler) http.Handler

func DefaultCodeToLevel

func DefaultCodeToLevel(code int, logger log.Logger) func(args ...interface{})

DefaultCodeToLevel is the default implementation of gRPC return codes and interceptor log level for server side.

func ErrToStatus

func ErrToStatus(err error) int

ErrToStatus converts err to http.Status.

func ErrToStatusWithDef

func ErrToStatusWithDef(err error, def int) int

ErrToStatusWithDef converts err with default http.Status(for unknown conversion) to http.Status.

func ParseToken

func ParseToken(auth string) (string, error)

func ToURLString

func ToURLString(scheme string, host string, path string) string

ToURLString convert scheme, host, path to escaped url.

func WantToLog

func WantToLog(code int, logger log.Logger) bool

DefaultCodeToLevel is the default implementation of gRPC return codes and interceptor log level for server side.

Types

type AuthArgs

type AuthArgs struct {
	URI    *regexp.Regexp
	Scopes []*regexp.Regexp
}

type Claims

type Claims = interface{ Valid() error }

type ClaimsFunc

type ClaimsFunc = func(ctx context.Context, method, uri string) Claims

func MakeClaimsFunc

func MakeClaimsFunc(methods map[string][]AuthArgs) ClaimsFunc

type DeniedClaims

type DeniedClaims struct {
	Err error
}

func (DeniedClaims) Valid

func (c DeniedClaims) Valid() error

type Interceptor

type Interceptor = func(ctx context.Context, method, uri string) (context.Context, error)

func NewInterceptor

func NewInterceptor(jwksURL string, tls *tls.Config, auths map[string][]AuthArgs, whiteList ...RequestMatcher) Interceptor

NewInterceptor authorizes HTTP request.

func NewInterceptorWithValidator

func NewInterceptorWithValidator(validator Validator, auths map[string][]AuthArgs, whiteList ...RequestMatcher) Interceptor

NewInterceptor authorizes HTTP request with validator.

type LogOpt

type LogOpt = func(cfg) cfg

func WithLogger

func WithLogger(logger log.Logger) LogOpt

type OnUnauthorizedAccessFunc

type OnUnauthorizedAccessFunc = func(ctx context.Context, w netHttp.ResponseWriter, r *netHttp.Request, err error)

type RequestMatcher

type RequestMatcher struct {
	Method string
	URI    *regexp.Regexp
}

RequestMatcher allows request without token validation.

type Validator

type Validator interface {
	ParseWithClaims(token string, claims extJwt.Claims) error
}