auth

README

auth使用方法

描述：用户身份认证

安装

go get gitee.com/sparrow614/sparrow_cloud_go

配置前提

需要先配置JWT中间件，详见 JWT Middleware

使用方法

import (
	...
	"gitee.com/sparrow614/sparrow_cloud_go/middleware/jwt"
	"gitee.com/sparrow614/sparrow_cloud_go/middleware/auth"
)

func main() {
    // 初始化iris app
    app := iris.New()
    // 配置jwt中间件
	app.Use(jwt.AutoServe)
    ...
    // /test 接口需要认证才可以进行访问，无token访问直接返回401认证失败
    app.Get("/test", auth.IsAuthenticated, processRequest)
    app.Listen("8081")
}

获取auth User

user := ctx.Values().Get(auth.DefaultUserKey).(auth.User)
fmt.Println(user.ID, user.IsAuthenticated)

获取token中的其他数据

claimInf := ctx.Values().Get(auth.DefaultClaimsKey).(map[string]interface{})
fmt.Println(claimInf["app_id"])

无需auth中间件获取User

当业务接口无需用户token也可以进行访问，需要判断用户是否存在来判断业务逻辑流程
可以使用下列函数
user := auth.CheckUser(ctx)
fmt.Println(user.ID, user.IsAuthenticated)

Documentation

Index

• Constants
• Variables
• func ErrorHandler(ctx iris.Context, err error)
• func IsAuthenticated(ctx iris.Context)
• type User
  • func CheckUser(ctx iris.Context) User

Constants

const DefaultClaimsKey = "payload"

const DefaultUserKey = "user"

DefaultUserKey user

Variables

var (
	// ErrTokenMissing is the error value that it's returned when
	// a token is not found based on the token extractor.
	ErrTokenMissing = errors.New("this api requires authorization token")

	// ErrUserIDMissing is the error value when no user id found in jwt token
	ErrUserIDMissing = errors.New("authorization token missing user id")
)

Functions

func ErrorHandler

func ErrorHandler(ctx iris.Context, err error)

ErrorHandler is the default error handler. Use it to change the behavior for each error.

func IsAuthenticated

func IsAuthenticated(ctx iris.Context)

IsAuthenticated is authentication middleware

Types

type User

type User struct {
	ID              string
	IsAuthenticated bool
}

User is for authentication

func CheckUser

func CheckUser(ctx iris.Context) User

CheckUser is a function to check token contains user id, return a User struct