server

README

Gin OAuth 2.0 Server

Using Gin framework implementation OAuth 2.0 services

Quick Start

Download and install

$ go get -u github.com/go-oauth2/gin-server

Create file server.go

package main

import (
	"net/http"

	"github.com/gin-gonic/gin"
	"github.com/go-oauth2/gin-server"
	"gopkg.in/oauth2.v3/manage"
	"gopkg.in/oauth2.v3/store"
)

func main() {
	manager := manage.NewDefaultManager()
	manager.MustTokenStorage(store.NewMemoryTokenStore())
	manager.MapClientStorage(store.NewTestClientStore())

	// Initialize the oauth2 service
	server.InitServer(manager)
	server.SetAllowGetAccessRequest(true)

	g := gin.Default()
	g.GET("/token", server.HandleTokenRequest)
	api := g.Group("/api")
	{
		api.Use(server.TokenAuth(func(c *gin.Context) string {
			return c.Query("access_token")
		}))
		api.GET("/test", func(c *gin.Context) {
			ti, _ := c.Get("Token")
			c.JSON(http.StatusOK, ti)
		})
	}

	g.Run(":9096")
}

Build and run

$ go build server.go
$ ./server

Open in your web browser

The token information

http://localhost:9096/token?grant_type=client_credentials&client_id=1&client_secret=11&scope=read

{
    "access_token": "ZF1M7NKDNWUUX2TCDIMZZG",
    "expires_in": 7200,
    "scope": "read",
    "token_type": "Bearer"
}

The authentication token

http://localhost:9096/api/test?access_token=ZF1M7NKDNWUUX2TCDIMZZG

MIT License

Copyright (c) 2016 Lyric

Documentation

Index

• func HandleAuthorizeRequest(c *gin.Context)
• func HandleTokenRequest(c *gin.Context)
• func InitServer(manager oauth2.Manager)
• func SetAccessTokenExpHandler(handler server.AccessTokenExpHandler)
• func SetAllowGetAccessRequest(allow bool)
• func SetAllowedGrantType(types ...oauth2.GrantType)
• func SetAllowedResponseType(types ...oauth2.ResponseType)
• func SetAuthorizeScopeHandler(handler server.AuthorizeScopeHandler)
• func SetClientAuthorizedHandler(handler server.ClientAuthorizedHandler)
• func SetClientInfoHandler(handler server.ClientInfoHandler)
• func SetClientScopeHandler(handler server.ClientScopeHandler)
• func SetExtensionFieldsHandler(handler server.ExtensionFieldsHandler)
• func SetInternalErrorHandler(handler server.InternalErrorHandler)
• func SetPasswordAuthorizationHandler(handler server.PasswordAuthorizationHandler)
• func SetRefreshingScopeHandler(handler server.RefreshingScopeHandler)
• func SetResponseErrorHandler(handler server.ResponseErrorHandler)
• func SetTokenType(tokenType string)
• func SetUserAuthorizationHandler(handler server.UserAuthorizationHandler)
• func TokenAuth(tokenHandle func(c *gin.Context) string) gin.HandlerFunc

Functions

func HandleAuthorizeRequest

func HandleAuthorizeRequest(c *gin.Context)

HandleAuthorizeRequest the authorization request handling

func HandleTokenRequest

func HandleTokenRequest(c *gin.Context)

HandleTokenRequest token request handling

func InitServer

func InitServer(manager oauth2.Manager)

InitServer Initialize the service

func SetAccessTokenExpHandler

func SetAccessTokenExpHandler(handler server.AccessTokenExpHandler)

SetAccessTokenExpHandler set expiration date for the access token

func SetAllowGetAccessRequest

func SetAllowGetAccessRequest(allow bool)

SetAllowGetAccessRequest to allow GET requests for the token

func SetAllowedGrantType

func SetAllowedGrantType(types ...oauth2.GrantType)

SetAllowedGrantType allow the grant types

func SetAllowedResponseType

func SetAllowedResponseType(types ...oauth2.ResponseType)

SetAllowedResponseType allow the authorization types

func SetAuthorizeScopeHandler

func SetAuthorizeScopeHandler(handler server.AuthorizeScopeHandler)

SetAuthorizeScopeHandler set scope for the access token

func SetClientAuthorizedHandler

func SetClientAuthorizedHandler(handler server.ClientAuthorizedHandler)

SetClientAuthorizedHandler check the client allows to use this authorization grant type

func SetClientInfoHandler

func SetClientInfoHandler(handler server.ClientInfoHandler)

SetClientInfoHandler get client info from request

func SetClientScopeHandler

func SetClientScopeHandler(handler server.ClientScopeHandler)

SetClientScopeHandler check the client allows to use scope

func SetExtensionFieldsHandler

func SetExtensionFieldsHandler(handler server.ExtensionFieldsHandler)

SetExtensionFieldsHandler in response to the access token with the extension of the field

func SetInternalErrorHandler

func SetInternalErrorHandler(handler server.InternalErrorHandler)

SetInternalErrorHandler internal error handling

func SetPasswordAuthorizationHandler

func SetPasswordAuthorizationHandler(handler server.PasswordAuthorizationHandler)

SetPasswordAuthorizationHandler get user id from username and password

func SetRefreshingScopeHandler

func SetRefreshingScopeHandler(handler server.RefreshingScopeHandler)

SetRefreshingScopeHandler check the scope of the refreshing token

func SetResponseErrorHandler

func SetResponseErrorHandler(handler server.ResponseErrorHandler)

SetResponseErrorHandler response error handling

func SetTokenType

func SetTokenType(tokenType string)

SetTokenType token type

func SetUserAuthorizationHandler

func SetUserAuthorizationHandler(handler server.UserAuthorizationHandler)

SetUserAuthorizationHandler get user id from request authorization

func TokenAuth

func TokenAuth(tokenHandle func(c *gin.Context) string) gin.HandlerFunc

TokenAuth Verify the access token of the middleware