关于 bkend-auth
介绍 bkend.ai 身份验证与安全机制,涵盖登录方式、令牌处理、访问策略和会话管理。说明如何借助 MCP 文档搜索指导基于 REST 的身份验证实现。
主要功能
- 01邮箱、社交账号和魔法链接登录
- 02JWT 访问令牌与刷新令牌
- 03密码重置与账户操作
- 04RBAC 与行级安全
- 05按设备管理会话
适用场景
- 01实现注册与登录流程
- 02添加社交账号或魔法链接验证
- 03应用角色和行级访问策略
- 04查看并撤销用户会话
MCP 相关
bkend MCP 没有专用身份验证工具。该指南通过 search_docs 查找身份验证说明和示例,为生成 REST API 代码提供参考。
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ ww-w-ai/ bkit-claude-code --skill bkend-auth安装后在 Claude Code 中输入/bkend-auth确认已加载。
详细介绍
bkend.ai 身份验证与安全指南
身份验证方法
| 方法 | 描述 |
|---|---|
| 邮箱 + 密码 | 使用邮箱和密码注册与登录 |
| 社交登录(Google) | OAuth 2.0 社交登录 |
| 社交登录(GitHub) | OAuth 2.0 社交登录 |
| 魔法链接 | 通过邮件链接登录(无需密码) |
JWT 令牌结构
- 访问令牌:有效期为 1 小时
- 刷新令牌:有效期为 7 天
- 自动刷新:
POST /v1/auth/refresh
密码策略
8 个及以上字符,包含大写字母 + 小写字母 + 数字 + 特殊字符
MCP 身份验证工作流
bkend MCP 没有专用的身份验证工具。请使用以下工作流:
- 搜索文档:使用查询词“email signup”或“social login”调用
search_docs - 获取示例:使用查询词“auth code examples”调用
search_docs - 生成代码:AI 根据搜索结果生成 REST API 代码
可搜索的身份验证文档
| 文档 ID | 内容 |
|---|---|
3_howto_implement_auth | 注册、登录和令牌管理指南 |
6_code_examples_auth | 邮箱、社交登录和魔法链接代码示例 |
关键模式
User: "Add social login"
→ search_docs(query: "social login implementation")
→ Returns auth guide with REST API patterns
→ AI generates social login code
REST 身份验证 API(核心端点)
如需查看完整端点列表,请调用 search_docs 或查阅 Live Reference。
| 方法 | 端点 | 描述 |
|---|---|---|
| POST | /v1/auth/email/signup | 注册 |
| POST | /v1/auth/email/signin | 登录 |
| GET | /v1/auth/me | 当前用户 |
| POST | /v1/auth/refresh | 刷新令牌 |
| POST | /v1/auth/signout | 退出登录 |
| GET/POST | /v1/auth/:provider/callback | 社交登录回调 |
| POST | /v1/auth/password/reset/request | 请求重置密码 |
| POST | /v1/auth/password/reset/confirm | 确认重置密码 |
| POST | /v1/auth/password/change | 修改密码 |
| GET | /v1/auth/sessions | 列出会话 |
| DELETE | /v1/auth/sessions/:sessionId | 移除会话 |
| DELETE | /v1/auth/withdraw | 删除账户 |
其他端点(MFA、邀请、用户管理):请调用 search_docs 或查阅 Live Reference。
RBAC(基于角色的访问控制)
| 分组 | 描述 | 范围 |
|---|---|---|
| admin | 完整的增删改查权限 | 所有数据 |
| user | 已通过身份验证的用户 | 完整读取权限、仅可写入自己的数据 |
| self | 仅限所有者 | 基于 createdBy |
| guest | 未通过身份验证的用户 | 只读(通常) |
RLS(行级安全)
- 按表进行行级访问控制
- 4 级策略:admin/user/self/guest
- 基于 createdBy 字段自动筛选
会话管理
- 按设备跟踪会话
GET /v1/auth/sessions- 列出会话DELETE /v1/auth/sessions/:sessionId- 移除会话
官方文档(Live Reference)
如需获取最新的身份验证文档,请使用 WebFetch:
- 身份验证概览:https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/en/authentication/01-overview.md
- MCP 身份验证指南:https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/en/mcp/06-auth-tools.md
- 安全:https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/en/security/01-overview.md
- 完整目录:https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/SUMMARY.md
评论
支持 Markdown