Documentation ¶
Index ¶
Constants ¶
This section is empty.
Variables ¶
View Source
var ( DefaultSchemas = []string{ "http://", "https://", } ExtensionSchemas = []string{ "chrome-extension://", "safari-extension://", "moz-extension://", "ms-browser-extension://", } FileSchemas = []string{ "file://", } WebSocketSchemas = []string{ "ws://", "wss://", } )
Functions ¶
func Default ¶
func Default() gin.HandlerFunc
Default returns the location middleware with default configuration.
func New ¶
func New(config Config) gin.HandlerFunc
New returns the location middleware with user-defined custom configuration.
Types ¶
type Config ¶
type Config struct { AllowAllOrigins bool `yaml:"allowAllOrigins"` // 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 `yaml:"allowOrigins"` // AllowOriginFunc is a custom function to validate the origin. It take the origin // as argument and returns true if allowed or false otherwise. If this option is // set, the content of AllowOrigins is ignored. AllowOriginFunc func(origin string) bool // AllowMethods is a list of methods the client is allowed to use with // cross-domain requests. Default value is simple methods (GET and POST) AllowMethods []string `yaml:"allowMethods"` // AllowHeaders is list of non simple headers the client is allowed to use with // cross-domain requests. AllowHeaders []string `yaml:"allowHeaders"` // AllowCredentials indicates whether the request can include user credentials like // cookies, HTTP authentication or client side SSL certificates. AllowCredentials bool `yaml:"allowCredentials"` // ExposedHeaders indicates which headers are safe to expose to the API of a CORS // API specification ExposeHeaders []string `yaml:"exposeHeaders"` // MaxAge indicates how long (in seconds) the results of a preflight request // can be cached MaxAge time.Duration `yaml:"maxAge"` // Allows to add origins like http://some-domain/*, https://api.* or http://some.*.subdomain.com AllowWildcard bool `yaml:"allowWildcard"` // Allows usage of popular browser extensions schemas AllowBrowserExtensions bool `yaml:"allowBrowserExtensions"` // Allows usage of WebSocket protocol AllowWebSockets bool `yaml:"allowWebSockets"` // Allows usage of file:// schema (dangerous!) use it only when you 100% sure it's needed AllowFiles bool `yaml:"allowFiles"` AllowPrivateNetwork bool `yaml:"allowPrivateNetwork"` }
Config represents all available options for the middleware.
func DefaultConfig ¶
func DefaultConfig() Config
DefaultConfig returns a generic default configuration mapped to localhost.
func (*Config) AddAllowHeaders ¶
AddAllowHeaders is allowed to add custom headers
func (*Config) AddAllowMethods ¶
AddAllowMethods is allowed to add custom methods
func (*Config) AddExposeHeaders ¶
AddExposeHeaders is allowed to add custom expose headers
Click to show internal directories.
Click to hide internal directories.