kevin
f2493da03e
- 封禁规则：达到失败阈值记为一次触发，前 3 次只计数不封禁； 第 4 次起封禁并按档位递增：30分钟（ban_duration_min）→ 3小时 → 3个月 → 半年（上限）；封禁过期后保留记录作为升档依据， 成功登录或管理员解封清零 - BanEntry 新增 BanCount（累计触发次数），每 IP 一条记录 upsert， 不再重复建行；RecordAuthFailure 统一 Web/LDAP/SMTP/IMAP/POP3 五处封禁逻辑，原因带档位（如"第1次封禁：登录失败次数过多 （第4次触发，失败5次）"） - 黑名单页修复：列表仅显示已封禁或曾封禁记录（原因/到期时间必填）， 新增封禁次数列与封禁中/已过期状态徽章，移除清理过期按钮 - 用户封禁页显示第 N 次封禁档位；新增档位升级与列表过滤单测
357 lines
11 KiB
Go
357 lines
11 KiB
Go
package handlers
|
||
|
||
import (
|
||
"crypto/rand"
|
||
"crypto/subtle"
|
||
"encoding/hex"
|
||
"fmt"
|
||
"log"
|
||
"net/http"
|
||
"time"
|
||
|
||
"mail_go/config"
|
||
"mail_go/internal/auth"
|
||
"mail_go/internal/store"
|
||
|
||
"github.com/gin-contrib/sessions"
|
||
"github.com/gin-gonic/gin"
|
||
)
|
||
|
||
// AuthHandler handles authentication-related routes (login, logout, LDAP, OAuth2).
|
||
type AuthHandler struct {
|
||
stores *store.Stores
|
||
authCfg config.AuthConfig
|
||
banCfg config.BanConfig
|
||
}
|
||
|
||
// NewAuthHandler creates a new AuthHandler with the given stores, auth config, and ban config.
|
||
func NewAuthHandler(stores *store.Stores, authCfg config.AuthConfig, banCfg config.BanConfig) *AuthHandler {
|
||
return &AuthHandler{stores: stores, authCfg: authCfg, banCfg: banCfg}
|
||
}
|
||
|
||
// ShowLogin renders the login page.
|
||
func (h *AuthHandler) ShowLogin(c *gin.Context) {
|
||
// If already logged in, redirect to inbox
|
||
session := sessions.Default(c)
|
||
if session.Get("userID") != nil {
|
||
c.Redirect(302, "/inbox")
|
||
return
|
||
}
|
||
c.HTML(200, "login", gin.H{
|
||
"error": "",
|
||
"oauth2Enabled": h.authCfg.OAuth2Enabled,
|
||
"ldapEnabled": h.authCfg.LDAPEnabled,
|
||
"oauth2Provider": h.authCfg.OAuth2Provider,
|
||
})
|
||
}
|
||
|
||
// DoLogin processes the login form submission.
|
||
// It authenticates the user with email and password, sets session data
|
||
// on success, or re-renders the login page with an error on failure.
|
||
func (h *AuthHandler) DoLogin(c *gin.Context) {
|
||
ip := c.ClientIP()
|
||
|
||
// Check if IP is banned
|
||
banned, entry := h.stores.Bans.IsBanned(ip)
|
||
if banned {
|
||
c.HTML(http.StatusForbidden, "banned", gin.H{"entry": entry})
|
||
return
|
||
}
|
||
|
||
email := c.PostForm("email")
|
||
password := c.PostForm("password")
|
||
|
||
if email == "" || password == "" {
|
||
c.HTML(200, "login", gin.H{
|
||
"error": "请输入邮箱和密码",
|
||
"oauth2Enabled": h.authCfg.OAuth2Enabled,
|
||
"ldapEnabled": h.authCfg.LDAPEnabled,
|
||
"oauth2Provider": h.authCfg.OAuth2Provider,
|
||
})
|
||
return
|
||
}
|
||
|
||
user, err := h.stores.Users.Authenticate(email, password)
|
||
if err != nil {
|
||
banned, failCount := h.stores.RecordAuthFailure(ip, h.banCfg.MaxFailAttempts, h.banCfg.BanDurationMin, "登录失败次数过多")
|
||
if banned {
|
||
entry, _ := h.stores.Bans.GetByIP(ip)
|
||
c.HTML(http.StatusForbidden, "banned", gin.H{"entry": entry})
|
||
return
|
||
}
|
||
|
||
remaining := h.banCfg.MaxFailAttempts - failCount
|
||
c.HTML(200, "login", gin.H{
|
||
"error": fmt.Sprintf("用户名或密码错误，还剩 %d 次尝试机会", remaining),
|
||
"oauth2Enabled": h.authCfg.OAuth2Enabled,
|
||
"ldapEnabled": h.authCfg.LDAPEnabled,
|
||
"oauth2Provider": h.authCfg.OAuth2Provider,
|
||
})
|
||
return
|
||
}
|
||
|
||
// Login successful: reset fail count
|
||
h.stores.Bans.ResetFail(ip)
|
||
|
||
// Set session values（先清空旧会话状态，防止残留值；记录登录时间
|
||
// 供中间件做绝对过期与滑动续期）
|
||
session := sessions.Default(c)
|
||
session.Clear()
|
||
session.Set("userID", user.ID)
|
||
session.Set("userEmail", user.Username+"@"+user.Domain.Name)
|
||
session.Set("isAdmin", user.IsAdmin)
|
||
session.Set("loginAt", time.Now().Unix())
|
||
if err := session.Save(); err != nil {
|
||
c.HTML(200, "login", gin.H{
|
||
"error": "会话保存失败，请重试",
|
||
"oauth2Enabled": h.authCfg.OAuth2Enabled,
|
||
"ldapEnabled": h.authCfg.LDAPEnabled,
|
||
"oauth2Provider": h.authCfg.OAuth2Provider,
|
||
})
|
||
return
|
||
}
|
||
|
||
c.Redirect(302, "/inbox")
|
||
}
|
||
|
||
// LDAPLogin handles LDAP authentication form submission.
|
||
func (h *AuthHandler) LDAPLogin(c *gin.Context) {
|
||
ip := c.ClientIP()
|
||
|
||
// Check if IP is banned
|
||
banned, entry := h.stores.Bans.IsBanned(ip)
|
||
if banned {
|
||
c.HTML(http.StatusForbidden, "banned", gin.H{"entry": entry})
|
||
return
|
||
}
|
||
|
||
username := c.PostForm("username")
|
||
password := c.PostForm("password")
|
||
|
||
if username == "" || password == "" {
|
||
c.HTML(200, "login", gin.H{
|
||
"error": "请输入LDAP用户名和密码",
|
||
"oauth2Enabled": h.authCfg.OAuth2Enabled,
|
||
"ldapEnabled": h.authCfg.LDAPEnabled,
|
||
"oauth2Provider": h.authCfg.OAuth2Provider,
|
||
})
|
||
return
|
||
}
|
||
|
||
provider := auth.NewLDAPProvider(h.authCfg)
|
||
email, err := provider.Authenticate(map[string]string{
|
||
"username": username,
|
||
"password": password,
|
||
})
|
||
if err != nil {
|
||
log.Printf("LDAP 认证失败: %v", err)
|
||
|
||
banned, failCount := h.stores.RecordAuthFailure(ip, h.banCfg.MaxFailAttempts, h.banCfg.BanDurationMin, "LDAP 登录失败次数过多")
|
||
if banned {
|
||
entry, _ := h.stores.Bans.GetByIP(ip)
|
||
c.HTML(http.StatusForbidden, "banned", gin.H{"entry": entry})
|
||
return
|
||
}
|
||
|
||
remaining := h.banCfg.MaxFailAttempts - failCount
|
||
c.HTML(200, "login", gin.H{
|
||
"error": fmt.Sprintf("LDAP 认证失败，还剩 %d 次尝试机会", remaining),
|
||
"oauth2Enabled": h.authCfg.OAuth2Enabled,
|
||
"ldapEnabled": h.authCfg.LDAPEnabled,
|
||
"oauth2Provider": h.authCfg.OAuth2Provider,
|
||
})
|
||
return
|
||
}
|
||
|
||
// Look up or auto-create user by email
|
||
user, err := h.stores.Users.GetByEmail(email)
|
||
if err != nil {
|
||
c.HTML(200, "login", gin.H{
|
||
"error": "LDAP 账号未接入本系统，请联系管理员",
|
||
"oauth2Enabled": h.authCfg.OAuth2Enabled,
|
||
"ldapEnabled": h.authCfg.LDAPEnabled,
|
||
"oauth2Provider": h.authCfg.OAuth2Provider,
|
||
})
|
||
return
|
||
}
|
||
|
||
if !user.IsActive {
|
||
c.HTML(200, "login", gin.H{
|
||
"error": "用户已被禁用",
|
||
"oauth2Enabled": h.authCfg.OAuth2Enabled,
|
||
"ldapEnabled": h.authCfg.LDAPEnabled,
|
||
"oauth2Provider": h.authCfg.OAuth2Provider,
|
||
})
|
||
return
|
||
}
|
||
|
||
// Login successful: reset fail count
|
||
h.stores.Bans.ResetFail(ip)
|
||
|
||
// Set session values（先清空旧会话状态，防止残留值；记录登录时间
|
||
// 供中间件做绝对过期与滑动续期）
|
||
session := sessions.Default(c)
|
||
session.Clear()
|
||
session.Set("userID", user.ID)
|
||
session.Set("userEmail", user.Username+"@"+user.Domain.Name)
|
||
session.Set("isAdmin", user.IsAdmin)
|
||
session.Set("loginAt", time.Now().Unix())
|
||
if err := session.Save(); err != nil {
|
||
c.HTML(200, "login", gin.H{
|
||
"error": "会话保存失败，请重试",
|
||
"oauth2Enabled": h.authCfg.OAuth2Enabled,
|
||
"ldapEnabled": h.authCfg.LDAPEnabled,
|
||
"oauth2Provider": h.authCfg.OAuth2Provider,
|
||
})
|
||
return
|
||
}
|
||
|
||
c.Redirect(302, "/inbox")
|
||
}
|
||
|
||
// OAuth2 state cookie 配置。state 用于防止登录 CSRF / 授权码注入：
|
||
// 发起授权时下发随机值，回调时必须原样带回。
|
||
//
|
||
// 注意 state 不能放进主会话 cookie：主会话是 SameSite=Strict，
|
||
// OAuth2 回调是从 IdP 发起的跨站顶级导航，浏览器不会携带 Strict
|
||
// cookie，因此使用独立的短期 SameSite=Lax cookie。
|
||
const (
|
||
oauth2StateCookie = "mail_go_oauth2_state"
|
||
oauth2StateMaxAge = 600 // 秒，10 分钟内完成授权流程
|
||
oauth2StateRandLen = 16 // 随机字节数（hex 编码后 32 字符）
|
||
)
|
||
|
||
// randomOAuth2State generates a hex-encoded cryptographically random state.
|
||
func randomOAuth2State() (string, error) {
|
||
buf := make([]byte, oauth2StateRandLen)
|
||
if _, err := rand.Read(buf); err != nil {
|
||
return "", fmt.Errorf("生成 OAuth2 state 失败: %w", err)
|
||
}
|
||
return hex.EncodeToString(buf), nil
|
||
}
|
||
|
||
// oauth2LoginVars 是登录模板所需的公共变量。
|
||
func (h *AuthHandler) oauth2LoginVars() gin.H {
|
||
return gin.H{
|
||
"oauth2Enabled": h.authCfg.OAuth2Enabled,
|
||
"ldapEnabled": h.authCfg.LDAPEnabled,
|
||
"oauth2Provider": h.authCfg.OAuth2Provider,
|
||
}
|
||
}
|
||
|
||
// OAuth2Start redirects to the OAuth2 provider's authorization page.
|
||
func (h *AuthHandler) OAuth2Start(c *gin.Context) {
|
||
if !h.authCfg.OAuth2Enabled {
|
||
c.String(http.StatusBadRequest, "OAuth2 未启用")
|
||
return
|
||
}
|
||
|
||
provider := auth.NewOAuth2Provider(h.authCfg)
|
||
state, err := randomOAuth2State()
|
||
if err != nil {
|
||
log.Printf("生成 OAuth2 state 失败: %v", err)
|
||
c.String(http.StatusInternalServerError, "OAuth2 登录暂不可用，请稍后重试")
|
||
return
|
||
}
|
||
c.SetCookie(oauth2StateCookie, state, oauth2StateMaxAge, "/auth/oauth2", "", true, true)
|
||
c.Redirect(http.StatusFound, provider.GetAuthURL(state))
|
||
}
|
||
|
||
// OAuth2Callback handles the OAuth2 provider's callback after user authorization.
|
||
func (h *AuthHandler) OAuth2Callback(c *gin.Context) {
|
||
if !h.authCfg.OAuth2Enabled {
|
||
c.String(http.StatusBadRequest, "OAuth2 未启用")
|
||
return
|
||
}
|
||
|
||
// 校验 state：必须与发起授权时下发的随机值一致（常量时间比较）。
|
||
// 缺失或不匹配视为登录 CSRF / 授权码注入，直接拒绝。
|
||
cookieState, cookieErr := c.Cookie(oauth2StateCookie)
|
||
reqState := c.Query("state")
|
||
if cookieErr != nil || reqState == "" ||
|
||
subtle.ConstantTimeCompare([]byte(cookieState), []byte(reqState)) != 1 {
|
||
c.HTML(http.StatusForbidden, "login", func() gin.H {
|
||
v := h.oauth2LoginVars()
|
||
v["error"] = "OAuth2 state 校验失败，请重新发起登录"
|
||
return v
|
||
}())
|
||
return
|
||
}
|
||
// state 一次性使用：无论后续成败都立即失效
|
||
c.SetCookie(oauth2StateCookie, "", -1, "/auth/oauth2", "", true, true)
|
||
|
||
code := c.Query("code")
|
||
if code == "" {
|
||
c.HTML(200, "login", gin.H{
|
||
"error": "OAuth2 授权码缺失",
|
||
"oauth2Enabled": h.authCfg.OAuth2Enabled,
|
||
"ldapEnabled": h.authCfg.LDAPEnabled,
|
||
"oauth2Provider": h.authCfg.OAuth2Provider,
|
||
})
|
||
return
|
||
}
|
||
|
||
provider := auth.NewOAuth2Provider(h.authCfg)
|
||
email, err := provider.HandleCallback(code)
|
||
if err != nil {
|
||
log.Printf("OAuth2 回调失败: %v", err)
|
||
c.HTML(200, "login", gin.H{
|
||
"error": "OAuth2 认证失败，请重试或联系管理员",
|
||
"oauth2Enabled": h.authCfg.OAuth2Enabled,
|
||
"ldapEnabled": h.authCfg.LDAPEnabled,
|
||
"oauth2Provider": h.authCfg.OAuth2Provider,
|
||
})
|
||
return
|
||
}
|
||
|
||
// Look up user by email
|
||
user, err := h.stores.Users.GetByEmail(email)
|
||
if err != nil {
|
||
c.HTML(200, "login", gin.H{
|
||
"error": "OAuth2 账号未接入本系统，请联系管理员",
|
||
"oauth2Enabled": h.authCfg.OAuth2Enabled,
|
||
"ldapEnabled": h.authCfg.LDAPEnabled,
|
||
"oauth2Provider": h.authCfg.OAuth2Provider,
|
||
})
|
||
return
|
||
}
|
||
|
||
if !user.IsActive {
|
||
c.HTML(200, "login", gin.H{
|
||
"error": "用户已被禁用",
|
||
"oauth2Enabled": h.authCfg.OAuth2Enabled,
|
||
"ldapEnabled": h.authCfg.LDAPEnabled,
|
||
"oauth2Provider": h.authCfg.OAuth2Provider,
|
||
})
|
||
return
|
||
}
|
||
|
||
// Set session values（先清空旧会话状态，防止残留值；记录登录时间
|
||
// 供中间件做绝对过期与滑动续期）
|
||
session := sessions.Default(c)
|
||
session.Clear()
|
||
session.Set("userID", user.ID)
|
||
session.Set("userEmail", user.Username+"@"+user.Domain.Name)
|
||
session.Set("isAdmin", user.IsAdmin)
|
||
session.Set("loginAt", time.Now().Unix())
|
||
if err := session.Save(); err != nil {
|
||
c.HTML(200, "login", gin.H{
|
||
"error": "会话保存失败，请重试",
|
||
"oauth2Enabled": h.authCfg.OAuth2Enabled,
|
||
"ldapEnabled": h.authCfg.LDAPEnabled,
|
||
"oauth2Provider": h.authCfg.OAuth2Provider,
|
||
})
|
||
return
|
||
}
|
||
|
||
c.Redirect(302, "/inbox")
|
||
}
|
||
|
||
// DoLogout clears the session and redirects to the login page.
|
||
func (h *AuthHandler) DoLogout(c *gin.Context) {
|
||
session := sessions.Default(c)
|
||
session.Clear()
|
||
session.Save()
|
||
c.Redirect(302, "/login")
|
||
}
|