middleware

Documentation

Index

• Variables
• func AllowedPathPrefixes(c *gin.Context, prefixes ...string) bool
• func AuthWithConfig(config AuthConfig) gin.HandlerFunc
• func CORSWithConfig(cfg CORSConfig) gin.HandlerFunc
• func CasbinWithConfig(config CasbinConfig) gin.HandlerFunc
• func CopyBody() gin.HandlerFunc
• func CopyBodyWithConfig(config CopyBodyConfig) gin.HandlerFunc
• func Cors() gin.HandlerFunc
• func Empty() gin.HandlerFunc
• func Logger() gin.HandlerFunc
• func LoggerWithConfig(config LoggerConfig) gin.HandlerFunc
• func SkippedPathPrefixes(c *gin.Context, prefixes ...string) bool
• func StaticWithConfig(config StaticConfig) gin.HandlerFunc
• func Trace() gin.HandlerFunc
• func TraceWithConfig(config TraceConfig) gin.HandlerFunc
• type AuthConfig
• type CORSConfig
• type CasbinConfig
• type CopyBodyConfig
• type LoggerConfig
• type StaticConfig
• type TraceConfig

Variables

var DefaultCopyBodyConfig = CopyBodyConfig{
	MaxContentLen: 32 << 20,
}

var DefaultLoggerConfig = LoggerConfig{
	MaxOutputRequestBodyLen:  1024 * 1024,
	MaxOutputResponseBodyLen: 1024 * 1024,
}

var DefaultTraceConfig = TraceConfig{
	RequestHeaderKey: "X-Request-Id",
	ResponseTraceKey: "X-Trace-Id",
}

var ErrCasbinDenied = errors.Unauthorized("com.casbin.denied", "Permission denied")

Functions

func AllowedPathPrefixes

func AllowedPathPrefixes(c *gin.Context, prefixes ...string) bool

func AuthWithConfig

func AuthWithConfig(config AuthConfig) gin.HandlerFunc

func CORSWithConfig

func CORSWithConfig(cfg CORSConfig) gin.HandlerFunc

func CasbinWithConfig

func CasbinWithConfig(config CasbinConfig) gin.HandlerFunc

func CopyBody

func CopyBody() gin.HandlerFunc

func CopyBodyWithConfig

func CopyBodyWithConfig(config CopyBodyConfig) gin.HandlerFunc

func Cors

func Cors() gin.HandlerFunc

func Empty

func Empty() gin.HandlerFunc

func Logger

func Logger() gin.HandlerFunc

Logger Record detailed request logs for quick troubleshooting.

func LoggerWithConfig

func LoggerWithConfig(config LoggerConfig) gin.HandlerFunc

func SkippedPathPrefixes

func SkippedPathPrefixes(c *gin.Context, prefixes ...string) bool

func StaticWithConfig

func StaticWithConfig(config StaticConfig) gin.HandlerFunc

func Trace

func Trace() gin.HandlerFunc

func TraceWithConfig

func TraceWithConfig(config TraceConfig) gin.HandlerFunc

Types

type AuthConfig

type AuthConfig struct {
	AllowedPathPrefixes []string
	SkippedPathPrefixes []string
	RootID              string
	Skipper             func(c *gin.Context) bool
	ParseUserID         func(c *gin.Context) (string, error)
}

type CORSConfig

type CORSConfig struct {
	Enable          bool
	AllowAllOrigins bool
	// AllowOrigins is a list of origins a cross-domain request can be executed from.
	// If the special "*" value is present in the list, all origins will be allowed.
	// Default value is []
	AllowOrigins []string
	// AllowMethods is a list of methods the client is allowed to use with
	// cross-domain requests. Default value is simple methods (GET, POST, PUT, PATCH, DELETE, HEAD, and OPTIONS)
	AllowMethods []string
	// AllowHeaders is list of non simple headers the client is allowed to use with
	// cross-domain requests.
	AllowHeaders []string
	// AllowCredentials indicates whether the request can include user credentials like
	// cookies, HTTP authentication or client side SSL certificates.
	AllowCredentials bool
	// ExposeHeaders indicates which headers are safe to expose to the API of a CORS
	// API specification
	ExposeHeaders []string
	// MaxAge indicates how long (with second-precision) the results of a preflight request
	// can be cached
	MaxAge int
	// Allows to add origins like http://some-domain/*, https://api.* or http://some.*.subdomain.com
	AllowWildcard bool
	// Allows usage of popular browser extensions schemas
	AllowBrowserExtensions bool
	// Allows usage of WebSocket protocol
	AllowWebSockets bool
	// Allows usage of file:// schema (dangerous!) use it only when you 100% sure it's needed
	AllowFiles bool
}

type CasbinConfig

type CasbinConfig struct {
	AllowedPathPrefixes []string
	SkippedPathPrefixes []string
	Skipper             func(c *gin.Context) bool
	GetEnforcer         func(c *gin.Context) *casbin.Enforcer
	GetSubjects         func(c *gin.Context) []string
}

type CopyBodyConfig

type CopyBodyConfig struct {
	AllowedPathPrefixes []string
	SkippedPathPrefixes []string
	MaxContentLen       int64
}

type LoggerConfig

type LoggerConfig struct {
	AllowedPathPrefixes      []string
	SkippedPathPrefixes      []string
	MaxOutputRequestBodyLen  int
	MaxOutputResponseBodyLen int
}

type StaticConfig

type StaticConfig struct {
	SkippedPathPrefixes []string
	Root                string
}

type TraceConfig

type TraceConfig struct {
	AllowedPathPrefixes []string
	SkippedPathPrefixes []string
	RequestHeaderKey    string
	ResponseTraceKey    string
}