Golang模块化Web认证系统插件库Authboss的使用

Authboss是一个模块化的Web认证系统，它提供了多种常见的认证和授权功能模块，可以根据需要启用或禁用特定模块。

快速入门

安装Authboss

# 获取最新版本（v3+必须使用Go模块）
go get -u github.com/aarondl/authboss/v3

基本配置示例

package main

import (
	"net/http"

	"github.com/aarondl/authboss/v3"
	"github.com/aarondl/authboss/v3/defaults"
)

func main() {
	// 创建Authboss实例
	ab := authboss.New()

	// 配置存储实现（需要自行实现）
	ab.Config.Storage.Server = myDatabaseImplementation
	ab.Config.Storage.SessionState = mySessionImplementation
	ab.Config.Storage.CookieState = myCookieImplementation

	// 配置基本路径
	ab.Config.Paths.Mount = "/authboss"
	ab.Config.Paths.RootURL = "https://www.example.com/"

	// 使用默认的核心实现
	defaults.SetCore(&ab.Config, false, false)

	// 初始化Authboss
	if err := ab.Init(); err != nil {
		panic(err)
	}

	// 挂载路由（示例中使用chi路由器）
	mux.Mount("/authboss", http.StripPrefix("/authboss", ab.Config.Core.Router))
}

核心概念

模块系统

Authboss由多个独立模块组成，可以根据需要导入：

用户认证示例

// 启用认证模块
import _ "github.com/aarondl/authboss/v3/auth"

// 用户模型需要实现AuthableUser接口
type User struct {
	ID       string
	Email    string
	Password string
}

func (u *User) GetPID() string {
	return u.Email
}

func (u *User) PutPID(pid string) {
	u.Email = pid
}

func (u *User) GetPassword() string {
	return u.Password
}

func (u *User) PutPassword(password string) {
	u.Password = password
}

密码重置示例

// 启用密码重置模块
import _ "github.com/aarondl/authboss/v3/recover"

// 用户模型需要实现RecoverableUser接口
type User struct {
	// ...其他字段
	RecoverToken    string
	RecoverExpires  time.Time
}

func (u *User) GetRecoverToken() string {
	return u.RecoverToken
}

func (u *User) PutRecoverToken(token string) {
	u.RecoverToken = token
}

func (u *User) GetRecoverExpires() time.Time {
	return u.RecoverExpires
}

func (u *User) PutRecoverExpires(exp time.Time) {
	u.RecoverExpires = exp
}

中间件

Authboss提供了一些必要的中间件：

// 加载客户端状态中间件（必需）
mux.Use(ab.LoadClientStateMiddleware)

// 认证中间件（保护路由）
mux.Use(authboss.Middleware(ab))

// Remember me中间件
mux.Use(remember.Middleware(ab))

完整示例

以下是一个更完整的示例，包含用户注册、登录和密码重置功能：

package main

import (
	"net/http"

	"github.com/aarondl/authboss/v3"
	"github.com/aarondl/authboss/v3/defaults"
	_ "github.com/aarondl/authboss/v3/auth"
	_ "github.com/aarondl/authboss/v3/register"
	_ "github.com/aarondl/authboss/v3/recover"
)

// User模型实现必要的接口
type User struct {
	ID             string
	Email          string
	Password       string
	Confirmed      bool
	ConfirmToken   string
	RecoverToken   string
	RecoverExpires time.Time
}

func main() {
	ab := authboss.New()
	
	// 配置存储实现（简化示例，实际需要完整实现）
	ab.Config.Storage.Server = &MemStorer{}
	ab.Config.Storage.SessionState = &SessionStorer{}
	ab.Config.Storage.CookieState = &CookieStorer{}
	
	ab.Config.Paths.Mount = "/auth"
	ab.Config.Paths.RootURL = "http://localhost:8080"
	
	// 使用默认实现
	defaults.SetCore(&ab.Config, false, false)
	
	// 初始化
	if err := ab.Init(); err != nil {
		panic(err)
	}
	
	// 设置路由器
	mux := http.NewServeMux()
	mux.Handle("/auth/", http.StripPrefix("/auth", ab.Config.Core.Router))
	
	// 添加中间件
	handler := ab.LoadClientStateMiddleware(mux)
	
	// 启动服务器
	http.ListenAndServe(":8080", handler)
}

// 存储实现示例（简化版）
type MemStorer struct {
	users map[string]*User
}

func (m *MemStorer) Save(ctx context.Context, user authboss.User) error {
	u := user.(*User)
	m.users[u.Email] = u
	return nil
}

func (m *MemStorer) Load(ctx context.Context, key string) (authboss.User, error) {
	u, ok := m.users[key]
	if !ok {
		return nil, authboss.ErrUserNotFound
	}
	return u, nil
}

注意事项

1. CSRF保护：Authboss不处理CSRF保护，需要自行添加中间件
2. 请求限流：Authboss不处理暴力破解防护，需要自行实现
3. 会话安全：确保会话存储是安全的，特别是使用remember me功能时

Authboss提供了灵活且模块化的认证解决方案，可以根据项目需求选择启用特定功能模块。更多详细信息和完整实现示例，请参考官方文档和示例项目。