cao.wangrenbo
630d240dc0
认证： - 图形验证码 GET /auth/captcha（内置 PNG 渲染，零第三方依赖） - 外部用户 OTP 双通道：DB 存储（otp_codes）使邮件与 CLI 共用同一验证码/冷却/失败限速 - 管理员 bcrypt 登录 + 连续失败限速锁定；admin/forgot + admin/reset 邮件重置（SMTP 或日志） - cookie 会话（HttpOnly/SameSite）、me/logout、admin/user 鉴权中间件 用户管理（admin）： - CRUD + disable/enable/extend/delete，对接 system 层真实 useradd/usermod/userdel/passwd - system 层三执行模式：dry-run（默认，安全）/ direct（容器/测试用户）/ sudo（生产 sudoers 白名单） - Exists 系统账号一致性检查；deploy/sudoers.example 白名单模板 - 关键操作接入 append-only 审计 其他： - CLI user otp 改 DB store，与邮件通道真正对齐 - 容器镜像补 shadow（alpine 无 useradd）；Makefile VERSION 0.2.0-m1 - 测试：auth/service 单测 + api httptest 集成 + 容器内真实系统账号端到端验证
96 lines
2.9 KiB
Go
96 lines
2.9 KiB
Go
// Package router 负责路由注册与中间件装配。
|
||
package router
|
||
|
||
import (
|
||
"log/slog"
|
||
"net/http"
|
||
"time"
|
||
|
||
"github.com/gin-gonic/gin"
|
||
|
||
"ws_usernode/internal/api"
|
||
"ws_usernode/internal/auth"
|
||
"ws_usernode/internal/config"
|
||
"ws_usernode/internal/webui"
|
||
)
|
||
|
||
// New 构建根 router：API v1 + 前端静态资源（go:embed）。
|
||
// production 模式启用 gin.ReleaseMode；否则启用调试模式与开发日志。
|
||
func New(cfg *config.Config, h *api.Handler, sessions auth.SessionStore, log *slog.Logger) *gin.Engine {
|
||
if cfg.App.Env == "production" {
|
||
gin.SetMode(gin.ReleaseMode)
|
||
}
|
||
r := gin.New()
|
||
r.Use(gin.Recovery(), requestLogger(log))
|
||
|
||
// 健康检查（不进 /api/v1 前缀，便于负载均衡/探针）
|
||
r.GET("/healthz", h.Health.Healthz)
|
||
|
||
// RESTful API v1
|
||
v1 := r.Group("/api/v1")
|
||
{
|
||
authGrp := v1.Group("/auth")
|
||
{
|
||
authGrp.GET("/captcha", h.Auth.Captcha)
|
||
authGrp.POST("/otp/send", h.Auth.OTPSend)
|
||
authGrp.POST("/otp/login", h.Auth.OTPLogin)
|
||
authGrp.POST("/admin/login", h.Auth.AdminLogin)
|
||
authGrp.POST("/admin/forgot", h.Auth.AdminForgot)
|
||
authGrp.POST("/admin/reset", h.Auth.AdminReset)
|
||
// 需要会话（管理员或外部用户）
|
||
authed := authGrp.Group("", sessionMiddleware(sessions))
|
||
authed.POST("/logout", h.Auth.Logout)
|
||
authed.GET("/me", h.Auth.Me)
|
||
}
|
||
|
||
// 用户管理（admin）
|
||
users := v1.Group("/users", sessionMiddleware(sessions), requireUserType(auth.SessionUserAdmin))
|
||
{
|
||
users.GET("", h.User.List)
|
||
users.POST("", h.User.Create)
|
||
users.GET("/:id", h.User.Get)
|
||
users.PATCH("/:id", h.User.Update)
|
||
users.POST("/:id/disable", h.User.Disable)
|
||
users.POST("/:id/enable", h.User.Enable)
|
||
users.POST("/:id/extend", h.User.Extend)
|
||
users.DELETE("/:id", h.User.Delete)
|
||
}
|
||
|
||
// 后续里程碑
|
||
v1.POST("/approvals", notImplemented("提交申请（M3）"))
|
||
v1.GET("/approvals", notImplemented("申请列表（M3）"))
|
||
v1.POST("/approvals/:id/review", notImplemented("审批（M3）"))
|
||
v1.GET("/audit", notImplemented("审计查询（M4）"))
|
||
v1.GET("/audit/export", notImplemented("审计导出（M4）"))
|
||
v1.GET("/settings", notImplemented("设置（M4）"))
|
||
v1.PUT("/settings", notImplemented("设置（M4）"))
|
||
}
|
||
|
||
// 前端静态资源（go:embed；dev 阶段由 Vite dev server 代理，见 Makefile dev）
|
||
r.NoRoute(gin.WrapH(webui.NewHandler()))
|
||
|
||
return r
|
||
}
|
||
|
||
// notImplemented 返回 501 占位 handler，标注里程碑。
|
||
func notImplemented(what string) gin.HandlerFunc {
|
||
return func(c *gin.Context) {
|
||
c.JSON(http.StatusNotImplemented, gin.H{"error": "接口 " + what + " 尚未实现"})
|
||
}
|
||
}
|
||
|
||
// requestLogger 以 slog 输出结构化请求日志。
|
||
func requestLogger(log *slog.Logger) gin.HandlerFunc {
|
||
return func(c *gin.Context) {
|
||
start := time.Now()
|
||
c.Next()
|
||
log.Info("http",
|
||
"method", c.Request.Method,
|
||
"path", c.Request.URL.Path,
|
||
"status", c.Writer.Status(),
|
||
"ip", c.ClientIP(),
|
||
"latency_ms", time.Since(start).Milliseconds(),
|
||
)
|
||
}
|
||
}
|