feat: add control plane authentication baseline
This commit is contained in:
1 parent
a4c93ff1a7
commit
0d10e2d124
21 files changed
+1403
-18
No files matched your search
@@ -0,0 +1,36 @@
|
||||
# MOYI Control Plane
|
||||
|
||||
D3 的身份与权限服务,负责邀请码注册、登录会话、用户角色、管理员接口和认证审计。它与 Otari 分离,前端不直接持有 Otari Master Key 或供应商密钥。
|
||||
|
||||
## 本地开发
|
||||
|
||||
\`\`\`powershell
|
||||
cd control-plane
|
||||
Copy-Item .env.example .env
|
||||
pnpm install
|
||||
pnpm migrate
|
||||
pnpm seed:admin
|
||||
pnpm dev
|
||||
\`\`\`
|
||||
|
||||
默认监听 \`http://127.0.0.1:8787\`。没有设置 \`DATABASE_URL\` 时,服务可以使用内存仓库启动,用于接口联调;正式开发和测试应使用 PostgreSQL。
|
||||
|
||||
## 接口
|
||||
|
||||
- \`POST /api/auth/register\`:邀请码注册,账号支持邮箱或手机号。
|
||||
- \`POST /api/auth/login\`:账号密码登录,返回 HttpOnly 会话 Cookie。
|
||||
- \`GET /api/auth/me\`:读取当前会话用户。
|
||||
- \`POST /api/auth/logout\`:撤销当前会话。
|
||||
- \`GET /api/admin/users\`:管理员用户列表。
|
||||
- \`GET|POST /api/admin/invitations\`:管理员查看或生成邀请码。
|
||||
- \`POST /api/admin/invitations/:id/revoke\`:停用邀请码。
|
||||
- \`GET /api/admin/audit\`:管理员查看认证审计。
|
||||
|
||||
第一版暂不实现短信/邮件真实验证码;注册页面保留验证码入口但不以它作为后端注册条件,邀请码、邮箱/手机号和账号密码是当前有效的注册条件。
|
||||
|
||||
## 安全约束
|
||||
|
||||
- 数据库仅保存密码哈希、邀请码摘要和会话摘要,不保存明文密码、明文邀请码或会话 Token。
|
||||
- 生产环境必须设置随机的 \`AUTH_PASSWORD_PEPPER\`、强管理员密码和 HTTPS。
|
||||
- 管理员接口由 Control Plane 服务端角色校验保护,隐藏前端菜单不构成权限控制。
|
||||
- 迁移文件只创建认证相关表,额度、模型和 Key 表在后续 D4 节点加入。
|
||||
Reference in new issue
Block a user