安全服务 · 统一认证模块(auth-Modules)¶
服务分类:安全服务 —— 对应统一用户管理域与全平台登录
模块定位¶
统一认证授权:为所有前端平台与客户端提供一套账号、一套令牌的 用户体系(统一用户管理),口令散列、JWT 签发验证与角色权限校验。
功能¶
- 统一用户管理:用户 CRUD、启用/停用、重置密码(users);
- 口令散列:PBKDF2-SHA256(
salt$iterations$hash格式,随机盐); - JWT:HS256 签发/验证(
issuer=nfarmsd,leeway=0,TTL 默认 12h; secret 需 ≥16 字符,环境变量JWT_SECRET注入); - 角色体系:白名单 admin / devops / service / auditor;
- 身份链(零信任):客户端 → 网关 JWT 验证 → 注入
X-User-ID/X-User-Roles→ 后端命令级权限校验;未走网关直连默认拒绝。
接口要点¶
POST /auth/login 用户名+密码 → {token, user}
GET/POST /users 用户列表 / 创建(admin)
PUT /users/{id} 更新用户(admin)
DELETE /users/{id} 删除用户(admin)
POST /users/{id}/reset-password 重置密码(admin)
状态与关联¶
- 已实现(nfarmsd v2.3.0 统一用户管理 + JWT);
- 全平台演示账号与角色见各前端平台文档;SSO 账号主数据视图见 online 平台;
- 关联前端:全部站点(console/online/store/hub 登录);客户端:nfvpn/nflive。