No Description

thinkerou 2a8f489b42 remove go1.8&1.9 and support go1.13 5 years ago
examples cf4846e6a6 using dev version 7 years ago
.gitignore dbe5075495 add git ignore file. 8 years ago
.travis.yml 2a8f489b42 remove go1.8&1.9 and support go1.13 5 years ago
LICENSE 14d8c87c42 add MIT License. 8 years ago
README.md df6cfb7ff4 Remove inexistent function from README (#32) 6 years ago
config.go 488de3ec97 Merge pull request #44 from groovili/groovili/allow-domain-wildcard 6 years ago
cors.go bd1331c62c rename Allowed to Allow matching Field names (#51) 5 years ago
cors_test.go bd1331c62c rename Allowed to Allow matching Field names (#51) 5 years ago
go.mod e30a911491 update go mod 5 years ago
go.sum e30a911491 update go mod 5 years ago
utils.go 25b01311da Add convert func to format headers and methods of http 8 years ago

README.md

CORS gin's middleware

Build Status codecov Go Report Card GoDoc

Gin middleware/handler to enable CORS support.

Usage

Start using it

Download and install it:

$ go get github.com/gin-contrib/cors

Import it in your code:

import "github.com/gin-contrib/cors"

Canonical example:

package main

import (
	"time"

	"github.com/gin-contrib/cors"
	"github.com/gin-gonic/gin"
)

func main() {
	router := gin.Default()
	// CORS for https://foo.com and https://github.com origins, allowing:
	// - PUT and PATCH methods
	// - Origin header
	// - Credentials share
	// - Preflight requests cached for 12 hours
	router.Use(cors.New(cors.Config{
		AllowOrigins:     []string{"https://foo.com"},
		AllowMethods:     []string{"PUT", "PATCH"},
		AllowHeaders:     []string{"Origin"},
		ExposeHeaders:    []string{"Content-Length"},
		AllowCredentials: true,
		AllowOriginFunc: func(origin string) bool {
			return origin == "https://github.com"
		},
		MaxAge: 12 * time.Hour,
	}))
	router.Run()
}

Using DefaultConfig as start point

func main() {
	router := gin.Default()
	// - No origin allowed by default
	// - GET,POST, PUT, HEAD methods
	// - Credentials share disabled
	// - Preflight requests cached for 12 hours
	config := cors.DefaultConfig()
	config.AllowOrigins = []string{"http://google.com"}
	// config.AllowOrigins == []string{"http://google.com", "http://facebook.com"}

	router.Use(cors.New(config))
	router.Run()
}

Default() allows all origins

func main() {
	router := gin.Default()
	// same as
	// config := cors.DefaultConfig()
	// config.AllowAllOrigins = true
	// router.Use(cors.New(config))
	router.Use(cors.Default())
	router.Run()
}