Golang基于JWT的多后端认证登录微服务插件loginsrv使用指南

loginsrv是一个轻量级的登录微服务，支持多种后端认证方式并生成JWT令牌。下面我将详细介绍其使用方法和Golang示例代码。

1. loginsrv简介

loginsrv主要特性：

• 支持多种后端认证方式：htpasswd、OSIAM、HTTP基本认证、LDAP、OAuth2等
• 生成JWT令牌
• 轻量级，易于集成
• 支持CORS
• 可配置的JWT过期时间

2. 安装loginsrv

go get github.com/tarent/loginsrv

3. 基本使用示例

3.1 简单启动

loginsrv --jwt-secret mysecret --text-login

3.2 使用htpasswd后端

loginsrv --jwt-secret mysecret --htpasswd /path/to/users.htpasswd

4. Golang集成示例

4.1 直接调用loginsrv

package main

import (
	"log"
	"os"
	"os/exec"
)

func main() {
	cmd := exec.Command("loginsrv",
		"--jwt-secret", "mysecretkey",
		"--backend", "provider=simple",
		"--backend", "provider=htpasswd,file=users.htpasswd",
		"--cookie-domain", "example.com",
		"--cookie-name", "jwt_token",
		"--host", "0.0.0.0",
		"--port", "8080",
	)
	
	cmd.Stdout = os.Stdout
	cmd.Stderr = os.Stderr
	
	if err := cmd.Start(); err != nil {
		log.Fatal(err)
	}
	
	log.Println("Login service started on port 8080")
	
	if err := cmd.Wait(); err != nil {
		log.Fatal(err)
	}
}

4.2 作为中间件使用

package main

import (
	"net/http"
	"os"
	
	"github.com/tarent/loginsrv/login"
)

func main() {
	config := login.DefaultConfig()
	config.JwtSecret = "mysecretkey"
	config.Backends = login.BackendOptions{
		"simple": map[string]string{},
		"htpasswd": map[string]string{
			"file": "users.htpasswd",
		},
	}
	config.Cookie.Domain = "example.com"
	config.Cookie.Name = "jwt_token"
	
	handler, err := login.NewHandler(config)
	if err != nil {
		panic(err)
	}
	
	http.Handle("/login", handler)
	
	// 保护的路由示例
	protected := http.NewServeMux()
	protected.HandleFunc("/api", func(w http.ResponseWriter, r *http.Request) {
		w.Write([]byte("Protected API"))
	})
	
	http.Handle("/api/", handler.Middleware(protected))
	
	port := os.Getenv("PORT")
	if port == "" {
		port = "8080"
	}
	
	http.ListenAndServe(":"+port, nil)
}

5. JWT验证示例

package main

import (
	"fmt"
	"net/http"
	"time"
	
	"github.com/dgrijalva/jwt-go"
)

func verifyJWT(jwtToken, secret string) (bool, error) {
	token, err := jwt.Parse(jwtToken, func(token *jwt.Token) (interface{}, error) {
		if _, ok := token.Method.(*jwt.SigningMethodHMAC); !ok {
			return nil, fmt.Errorf("Unexpected signing method: %v", token.Header["alg"])
		}
		return []byte(secret), nil
	})
	
	if err != nil {
		return false, err
	}
	
	if claims, ok := token.Claims.(jwt.MapClaims); ok && token.Valid {
		fmt.Println("User:", claims["sub"])
		fmt.Println("Expires:", time.Unix(int64(claims["exp"].(float64)), 0))
		return true, nil
	}
	
	return false, nil
}

func protectedHandler(w http.ResponseWriter, r *http.Request) {
	cookie, err := r.Cookie("jwt_token")
	if err != nil {
		http.Error(w, "Unauthorized", http.StatusUnauthorized)
		return
	}
	
	if valid, _ := verifyJWT(cookie.Value, "mysecretkey"); valid {
		w.Write([]byte("Welcome to protected area!"))
	} else {
		http.Error(w, "Unauthorized", http.StatusUnauthorized)
	}
}

func main() {
	http.HandleFunc("/protected", protectedHandler)
	http.ListenAndServe(":8080", nil)
}

6. 多后端配置示例

loginsrv支持同时配置多个认证后端：

loginsrv \
  --jwt-secret mysecret \
  --backend provider=simple,bob=secret \
  --backend provider=htpasswd,file=users.htpasswd \
  --backend provider=ldap,host=ldap.example.com,base=dc=example,dc=com

7. 生产环境建议

1. 使用强JWT密钥
2. 启用HTTPS
3. 设置合理的JWT过期时间
4. 定期轮换JWT密钥
5. 监控登录服务

8. 总结

loginsrv为Golang应用提供了简单易用的JWT认证解决方案，支持多种后端认证方式，可以轻松集成到现有系统中。通过中间件方式使用，可以方便地保护API路由。

以上示例展示了loginsrv的基本用法和Golang集成方式，您可以根据实际需求进行调整和扩展。