跳转至

安全服务 · 统一认证模块(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。