corsx

Documentation

Index

• Variables
• func ContextualizedMiddleware(provider func(context.Context) (opts cors.Options, enabled bool)) negroni.HandlerFunc
• func HelpMessage() string
• func NormalizeOriginStrings(origins []string) ([]string, error)
• func NormalizeOrigins(origins []url.URL) []string

Variables

var CORSAllowCredentials = true

CORSAllowCredentials default value for allow credentials this is required for cookies to be sent by the browser we always want this since we are using cookies for authentication most of the time

var CORSDefaultAllowedMethods = []string{"GET", "POST", "PUT", "PATCH", "DELETE"}

CORSDefaultAllowedMethods Default allowed methods

var CORSDefaultMaxAge = 5

CORSDefaultMaxAge max age for cache of preflight request result default is 5 seconds https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Max-Age

var CORSRequestHeadersExtended = []string{"Authorization", "X-CSRF-TOKEN"}

CORSRequestHeadersExtended Extended list of request headers these will be concatenated with the safelist

var CORSRequestHeadersSafelist = []string{"Accept", "Content-Type", "Content-Length", "Accept-Language", "Content-Language"}

CORSRequestHeadersSafelist We add the safe list cors accept headers https://developer.mozilla.org/en-US/docs/Glossary/CORS-safelisted_request_header

var CORSResponseHeadersExtended = []string{}

CORSResponseHeadersExtended Extended list of response headers these will be concatenated with the safelist

var CORSResponseHeadersSafelist = []string{"Set-Cookie", "Cache-Control", "Expires", "Last-Modified", "Pragma", "Content-Length", "Content-Language", "Content-Type"}

CORSResponseHeadersSafelist We add the safe list cors expose headers https://developer.mozilla.org/en-US/docs/Glossary/CORS-safelisted_response_header

Functions

func ContextualizedMiddleware

func ContextualizedMiddleware(provider func(context.Context) (opts cors.Options, enabled bool)) negroni.HandlerFunc

ContextualizedMiddleware is a context-aware CORS middleware. It allows hot-reloading CORS configuration using the HTTP request context.

n := negroni.New()
n.UseFunc(ContextualizedMiddleware(func(context.Context) (opts cors.Options, enabled bool) {
  panic("implement me")
})
// ...

func HelpMessage

func HelpMessage() string

HelpMessage returns a string containing information on setting up this CORS middleware.

func NormalizeOriginStrings

func NormalizeOriginStrings(origins []string) ([]string, error)

NormalizeOriginStrings normalizes the CORS origins from string representation

func NormalizeOrigins

func NormalizeOrigins(origins []url.URL) []string

NormalizeOrigins normalizes the CORS origins.