SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场bkend-auth

bkend-auth

安全与审计

查看项目

更新于 10-16 02:11

技能介绍

用途

bkend-auth 是面向 bkend.ai 平台的身份认证与安全指南技能，用于指导在 bkend.ai 上实现认证相关功能。它本身不包含专用的认证工具，而是通过文档检索配合 AI 生成代码的方式工作。

主要能力

认证方式

  • 邮箱 + 密码：邮箱/密码注册与登录
  • 社交登录（Google）：OAuth 2.0 社交登录
  • 社交登录（GitHub）：OAuth 2.0 社交登录
  • Magic Link：通过邮件链接登录，无需密码

JWT 令牌结构

  • Access Token：有效期 1 小时
  • Refresh Token：有效期 7 天
  • 自动刷新：POST /v1/auth/refresh

密码策略

  • 至少 8 个字符，需包含大写字母、小写字母、数字和特殊字符

RBAC（基于角色的访问控制）

  • admin：完整 CRUD，作用于全部数据
  • user：已认证用户，可完整读取、仅可写入自己的数据
  • self：仅限所有者，基于 createdBy 字段
  • guest：未认证用户，通常只读

RLS（行级安全）

  • 按表进行行级访问控制
  • 四级策略：admin / user / self / guest
  • 基于 createdBy 字段自动过滤

会话管理

  • 按设备跟踪会话
  • GET /v1/auth/sessions：列出会话
  • DELETE /v1/auth/sessions/:sessionId：移除会话

使用方式

MCP 认证工作流

bkend MCP 没有专用的认证工具，使用以下流程：

  1. 检索文档：使用 search_docs，查询词如 "email signup" 或 "social login"
  2. 获取示例：使用 search_docs，查询词如 "auth code examples"
  3. 生成代码：AI 根据检索结果生成 REST API 代码

典型模式： 用户提出 "Add social login" → search_docs(query: "social login implementation") → 返回包含 REST API 模式的认证指南 → AI 生成社交登录代码

可检索的认证文档

  • 3_howto_implement_auth：注册、登录、令牌管理指南
  • 6_code_examples_auth：邮箱、社交、Magic Link 代码示例

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。

官方文档（Live Reference）

获取最新认证文档可使用 WebFetch：

  • 认证概览：https://raw.githubusercontent.com/ww-w-ai/bkend-docs/main/en/authentication/01-overview.md
  • MCP 认证指南：https://raw.githubusercontent.com/ww-w-ai/bkend-docs/main/en/mcp/06-auth-tools.md
  • 安全：https://raw.githubusercontent.com/ww-w-ai/bkend-docs/main/en/security/01-overview.md
  • 完整目录：https://raw.githubusercontent.com/ww-w-ai/bkend-docs/main/SUMMARY.md

适用场景

  • 在 bkend.ai 上实现邮箱注册与登录
  • 接入 Google 或 GitHub 社交登录
  • 实现 Magic Link 免密登录
  • 配置 JWT 令牌刷新与密码策略
  • 设计 RBAC 角色与 RLS 行级权限
  • 管理多设备会话与账号注销

限制

  • 该技能不提供独立的认证工具，需依赖 search_docs 检索文档后由 AI 生成代码
  • 完整端点列表（含 MFA、邀请、用户管理）未在资料中列出，需通过 search_docs 或 Live Reference 获取
  • 资料未提供收费、价格、平台支持范围等信息