JWT是JSON Web Token的缩写,定义了一种简介自暴寒的方法用于通讯双方之间以Json对象的形式安全的传递信息。由于特定的数字签名,因此这些通讯的信息可以被校验和信任。 JWT能够使用HMAC算法或者RSA的公钥私钥对进行签名。git
让咱们进一步的解释下关于JWT的定义:github
JWT由三部分组成,使用.
分隔:golang
因此,JWT最终样式为:XXXXX.XXXXX.XXXXX
web
JWT的头部包含描述该JWT的最基本的信息:token的类型, 如JWT, 以及token使用的加密算法, 如 HMAC SHA256或者RSA.。能够被表示为一个JSON对象:算法
{ "typ": "JWT", "alg": "HS256" }
JWT token的第二部分是payload, Payload包含claims. Claims是一些实体(一般指用户)的状态信息和其余元数据。数据库
{ "iss": "sysu", "iat": 1233458243, "exp": 1448333419, "aud": "sysu-ss", "sub": "sysu-ss", }
iss(issuer 签发者),是否使用是可选的;
iat(issued at签发时间),这里是一个Unix时间戳,是否使用是可选的;
exp(expiration time 过时时间) ,这里是一个Unix时间戳,是否使用是可选的;
aud(audience 接收方 ),是否使用是可选的;
sub(subject 面向的用户),是否使用是可选的;json
关于更多有关Payload字段的介绍,请查看JWT官网安全
要建立签名部分,须要使用通过编码后的头部(header)和负载(payload)以及一个密钥,将header和payload用.
链接起来后,使用header中制定的算法进行签名。
该签名是用户验证JWT的请求发送者以及确保数据信息在传输过程当中的消息是未经篡改的。app
我使用的是jwt-go、negroni web中间件以及mux搭建服务。关于这三个库的使用请自行谷歌。函数
// service/jwt.go var tokens []Token // 做为全局变量存储登陆用户的token,能够存储到数据库中 const TokenName = "SW-TOKEN" const Issuer = "Go-GraphQL-Group" const SecretKey = "StarWars" type Token struct { SW_TOKEN string `json:"SW-TOKEN"` } type jwtCustomClaims struct { jwt.StandardClaims Admin bool `json:"admin"` } func CreateToken(secretKey []byte, issuer string, isAdmin bool) (token Token, err error) { claims := &jwtCustomClaims{ jwt.StandardClaims{ ExpiresAt: int64(time.Now().Add(time.Hour * 1).Unix()), Issuer: issuer, }, isAdmin, } tokenStr, err := jwt.NewWithClaims(jwt.SigningMethodHS256, claims).SignedString(secretKey) token = Token{ tokenStr, } return } func ParseToken(tokenStr string, secretKey []byte) (claims jwt.Claims, err error) { var token *jwt.Token token, err = jwt.Parse(tokenStr, func(*jwt.Token) (interface{}, error) { return secretKey, nil }) claims = token.Claims return }
// main.go func NewServer() *negroni.Negroni { router := mux.NewRouter() initRoutes(router) n := negroni.Classic() // negroni.Classic() 返回带有默认中间件的Negroni实例指针 n.UseHandler(router) // 将router中http.Handler加入到negroni的中间件栈中 return n } func initRoutes(router *mux.Router) { router.HandleFunc("/login", service.LoginHandler).Methods("POST") // 使用中间件进行token认证 router.Use(service.TokenMiddleware) // query服务 router.HandleFunc("/query", handler.GraphQL(GraphQL_Service.NewExecutableSchema(GraphQL_Service.Config{Resolvers: &GraphQL_Service.Resolver{}}))) // 退出路由 router.HandleFunc("/logout", service.LogoutHandler).Methods("POST", "GET") }
func LoginHandler(w http.ResponseWriter, r *http.Request) { err := r.ParseForm() fmt.Println(r.Form.Get("username")) if err != nil { w.WriteHeader(http.StatusForbidden) fmt.Fprint(w, "Error in request") return } // 使用固定的username和password作测试 if strings.ToLower(r.Form.Get("username")) != "admin" || r.Form.Get("password") != "password" { w.WriteHeader(http.StatusForbidden) fmt.Println("Error logging in") fmt.Fprint(w, "Invalid credentials") return } token, err := CreateToken([]byte(SecretKey), Issuer, false) if err != nil { w.WriteHeader(http.StatusInternalServerError) fmt.Fprintln(w, "Error extracting the key") log.Fatal(err) } w.WriteHeader(http.StatusOK) w.Header().Set("Content-Type", "application/json") tokenBytes, err := json.Marshal(token) if err != nil { w.WriteHeader(http.StatusInternalServerError) fmt.Fprintln(w, "Error marshal the token") log.Fatal(err) } tokens = append(tokens, token) w.Write(tokenBytes) }
func TokenMiddleware(next http.Handler) http.Handler { return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { // 不是login的请求须要进行token认证 if r.RequestURI[1:] != "login" { /* // token位于Authorization中,用此方法 token, err := request.ParseFromRequest(r, request.AuthorizationHeaderExtractor, func(token *jwt.Token) (interface{}, error) { return []byte(SecretKey), nil }) */ tokenStr := "" for k, v := range r.Header { if strings.ToUpper(k) == TokenName { tokenStr = v[0] break } } validToken := false for _, token := range tokens { if token.SW_TOKEN == tokenStr { validToken = true } } if validToken { ctx := context.WithValue(r.Context(), TokenName, tokenStr) next.ServeHTTP(w, r.WithContext(ctx)) } else { w.WriteHeader(http.StatusUnauthorized) w.Write([]byte("Unauthorized access to this resource")) //fmt.Fprint(w, "Unauthorized access to this resource") } } else { next.ServeHTTP(w, r) } }) }
func LogoutHandler(w http.ResponseWriter, r *http.Request) { tokenStr := "" for k, v := range r.Header { if strings.ToUpper(k) == TokenName { tokenStr = v[0] break } } for i, token := range tokens { if token.SW_TOKEN == tokenStr { tokens = append(tokens[:i], tokens[i+1:]...) break } } w.Write([]byte("logout")) }
// main.go func main() { port := os.Getenv("PORT") if port == "" { port = defaultPort } server := NewServer() server.Run(":" + port) log.Printf("connect to http://localhost:%s/ for GraphQL playground", port) }
代码源地址:Github