认证概览
功能概述
Agentbase 身份认证(Auth)服务为项目(Project)内的终端用户(End Users)提供企业级、全生命周期的账号体系、多样化身份认证提供方(Identity Providers)、多租户团队与角色(Teams & RBAC Roles)、细粒度资源权限表达式(Permission Strings)以及安全的会话管理能力。在构建企业级 AI 智能体、知识中台与业务应用(如示例项目 **企业智能客服与知识中台**,Project ID:enterprise-ai-hub-210)时,Auth 服务不仅承担前端 Web 与移动端用户的注册、登录与多因素认证(MFA),还作为底层数据安全(Databases 行级 ACL、Storage 文件级 ACL、Memory 用户记忆隔离、Messaging 目标投递)的核心身份基座。
在 Agentbase 的双层权限架构中,项目终端用户认证(Project Auth)与控制台组织管理认证(Console Organization Auth)严格物理隔离:
- 控制台管理者(Organization Members):归属于组织(如
Agentbase 企业智能中台,ID:69c6d1aa00062e6bb60),使用owner、admin、developer、editor、billing、analyst六种固定治理角色登录 Console,负责创建项目、配置 AI 网关与管理底层基础设施。 - 项目终端用户(Project Users):归属于具体业务项目(如
enterprise-ai-hub-210),包括客户技术总监张伟(user_zhangwei_001)、高级坐席工程师李娜(user_lina_002)等业务侧真实用户。终端用户通过客户端 SDK(如agentbase-web-sdk@2.10.0)或 HTTP REST API 完成登录,获取受项目级安全策略约束的会话凭证,并按需加入项目内团队(如team_support_opsVIP 客户技术支持组),从而按角色访问业务数据库表customer_tickets或存储桶kb_enterprise_docs。
核心概念与架构
Agentbase Auth 围绕“用户身份生命周期 → 认证凭证签发 → 团队与标签映射 → 资源 ACL 鉴权评估”构建完整的身份安全闭环。下图展示了终端用户从发起认证到访问项目受保护资源的完整架构链路:
flowchart TB
subgraph Client["终端应用与服务端调用方"]
WebApp["Web / 移动端应用<br/>(agentbase-web-sdk@2.10.0)"]
BackendSvc["企业后端服务 / Agent 工作流<br/>(agentbase-node-sdk@2.10.0)"]
end
subgraph AuthProviders["认证方式与身份源 (Project Auth)"]
EmailPass["邮箱密码 / 手机短信验证码"]
MagicOTP["无密码认证<br/>(Magic URL / Email OTP)"]
OAuth2["OAuth2 / Custom OAuth2<br/>(Gitee / GitHub / 企业统一身份)"]
MFA["多因素认证挑战 (MFA)<br/>(TOTP / Email / SMS / 恢复码)"]
end
subgraph Credentials["三类核心认证凭证"]
SessionCookie["Session 会话凭证<br/>(HttpOnly Cookie / Session Secret)"]
UserJWT["短期用户 JWT<br/>(X-Appwrite-JWT, 15分钟有效)"]
ApiKey["服务端 API Key<br/>(X-Appwrite-Key, 按 Scope 授权)"]
end
subgraph IdentityEngine["身份解析与角色计算引擎"]
UserDoc["用户主体 (User)<br/>user_zhangwei_001 / user_lina_002"]
UserLabels["用户标签 (Labels)<br/>label:vip / label:architect"]
TeamMember["团队与成员角色 (Team & Membership)<br/>team:team_support_ops/admin"]
RoleSet["运行时等效角色集 (Effective Roles)<br/>any, users, user:{id}, team:{id}/{role}, label:{name}"]
end
subgraph ProtectedResources["受保护的项目资源 (ACL 强制鉴权)"]
DB["结构化数据库 (Databases)<br/>enterprise_biz_db / customer_tickets"]
Storage["文件存储桶 (Storage)<br/>kb_enterprise_docs / agent_multimedia_bucket"]
Memory["长期记忆与画像 (Memory)<br/>按 user_id 隔离读写"]
end
WebApp --> EmailPass & MagicOTP & OAuth2
EmailPass & MagicOTP & OAuth2 --> MFA
MFA --> SessionCookie
SessionCookie -->|换取短期令牌| UserJWT
BackendSvc --> ApiKey
SessionCookie & UserJWT --> UserDoc
UserDoc --> UserLabels & TeamMember
UserLabels & TeamMember --> RoleSet
RoleSet --> DB & Storage & Memory
ApiKey -->|按 Scopes 跨越或受控访问| DB & Storage & Memory核心概念说明
| 核心概念 | 标识与格式示例 | 技术定义与生命周期说明 |
|---|---|---|
| 用户主体(User) | user_zhangwei_001、user_lina_002 | 项目内的唯一自然人或业务账号实体。包含姓名(name)、唯一邮箱(email)、E.164 格式手机号(phone)、验证状态(emailVerification / phoneVerification)、账户启停状态(status)、偏好键值(prefs)及自定义标签(labels)。 |
| 会话(Session) | Session ID + HTTP Cookie | 用户通过账号密码、OTP、Magic URL 或 OAuth2 登录成功后创建的持久态上下文。会话受项目级 Session length(有效期)与 Sessions limit(单用户最大并发会话数)控制,支持单点踢出或全量注销。 |
| 用户 JWT(JSON Web Token) | X-Appwrite-JWT: eyJhbG... | 由已登录客户端调用 account.createJWT() 签发的短期无状态令牌(固定有效期 15 分钟),专用于前端将当前终端用户身份安全透传给企业自建后端服务或 SQL Proxy 用户态接口,使后端以该终端用户权限执行操作。 |
| 服务端 API Key | X-Appwrite-Key: <APPBASE_API_KEY> | 项目级服务端管理密钥,绑定精细的功能权限域(Scopes,如 users.read、users.write、teams.write、databases.write)。仅限可信后端(如 agentbase-node-sdk@2.10.0)使用,严禁暴露在浏览器前端。 |
| 第三方身份(Identity) | Identity ID + Provider UID | 当用户通过公共 OAuth2(如 GitHub、Google)或自定义 OAuth2(Custom OAuth2,如 Gitee、企业 SSO)登录时,系统将外部身份源的 Subject UID、访问令牌(Access Token)与项目内 User 绑定的关联记录。 |
| 用户标签(Labels) | vip、architect、internal | 由管理员通过 Console 或 Server SDK 为用户打上的纯字母数字属性标签。标签会自动映射为运行时权限角色 label:<name>(如 Role.label('vip')),适合跨团队的扁平化等级授权。 |
| 团队与成员关系(Teams & Memberships) | team_support_ops、team_kb_governance | 项目内面向终端用户的多租户组织单元。用户加入团队后成为成员(Membership),并可被赋予完全自定义的团队内角色(如 owner、admin、support_lead、auditor),用于实现部门级或客户租户级的数据共享。 |
| 消息目标(Targets) | Email / SMS / Push Target | 用户关联的通知触达终点。创建用户并提供邮箱或手机号时会自动生成对应的 Email / SMS Target,供 Messaging 消息服务投递通知、告警与工单状态变更。 |
角色、入口与关联关系
控制台入口与路由
- 主导航路径:登录 Agentbase Console → 选择组织
Agentbase 企业智能中台(69c6d1aa00062e6bb60)→ 进入项目企业智能客服与知识中台(enterprise-ai-hub-210)→ 左侧导航栏 基础设施(Infrastructure) 分组 → 点击 Auth。 - 路由地址:
/console/project-{region}-{project}/auth(默认展示 Users 页签;快捷键命令中心支持按g后按e直达/auth/security安全策略页)。 - 页面二级页签结构:
- Users:终端用户列表、搜索、创建用户与用户六维详情(Overview / Memberships / Identities / Targets / Sessions / Activity)。
- Teams:项目终端用户团队管理、成员邀请与团队自定义角色分配。
- Security:用户注册上限、会话时长、并发会话上限、密码合规策略、MFA 与模拟手机号(Mock phone numbers)配置。
- Templates:自定义平台发往终端用户的 7 类通知与验证邮件模板(需先启用项目级自定义 SMTP)。
- Usage:项目级 Auth 用户数、会话数等近 30 天趋势指标。
- Settings:启用/停用各类登录方式(Email/Password、Phone、Magic URL、Email OTP、Anonymous 等)及配置 OAuth2 / Custom OAuth2 提供方。
- Test:在控制台内直接发起已启用 OAuth2 提供方的授权登录测试(与 Console 管理会话完全隔离)。
组织角色与 API Key Scope 权限矩阵
在 Console 或通过 Server API 操作 Auth 资源时,不同组织成员角色与 API Key Scopes 的权限边界如下:
| 操作域 | 涉及资源与操作 | 所需 API Key Scope | 允许执行的组织角色 | 只读或无权角色 |
|---|---|---|---|---|
| 用户读取 | 查询用户列表、读取用户详情、偏好、标签、会话与成员列表 | users.read | owner, admin, developer, editor, analyst | billing |
| 用户变更 | 创建用户、修改邮箱/手机/密码/标签/偏好、封禁解封、注销会话、删除用户 | users.write | owner, admin, developer, editor | billing, analyst |
| 团队读取 | 查询团队列表、团队详情与成员关系列表 | teams.read | owner, admin, developer, editor, analyst | billing |
| 团队变更 | 创建/重命名/删除团队、邀请或添加团队成员、修改成员角色 | teams.write | owner, admin, developer, editor | billing, analyst |
| 通知目标管理 | 为用户创建、更新或删除 Email / SMS / Push 消息目标 | targets.read / targets.write | owner, admin, developer, editor | billing, analyst |
| Auth 安全策略与 OAuth2 配置 | 修改 Security 安全策略、开启/关闭登录方式、配置 Custom OAuth2 | 项目级管理权限(Console 态) | owner, admin, developer | editor, billing, analyst |
与其他产品模块的关联关系
- 结构化数据库(Databases):数据库表(如
enterprise_biz_db下的customer_tickets)的表级权限与行级安全(Row Security)直接使用 Auth 生成的角色字符串(如user:user_zhangwei_001、team:team_support_ops/admin、label:vip)进行访问控制。 - 文件存储(Storage):存储桶
kb_enterprise_docs和agent_multimedia_bucket通过 Bucket Permissions 与 File Security 识别当前登录的 Auth 用户身份,决定是否允许上传、列出或预览文件。 - 长期记忆(Memory):智能体记忆模块以 Auth 用户的 User ID(如
user_zhangwei_001与user_lina_002)作为记忆归属主键,提取个性化画像(Profile)与长期事实记忆。 - 消息推送(Messaging):用户在 Auth 中自动或手动登记的 Targets(邮箱、手机号、设备推送 Token)直接作为 Messaging 主题(Topics)订阅与消息下发的目标载体。
功能详解与操作指南
1. 认证方式对比:Session vs JWT vs API Key
在企业架构设计中,正确区分并选用三种认证凭据是保障数据安全与租户隔离的前提:
| 对比维度 | Session 会话认证(Cookie / Session Header) | 用户 JWT 认证(X-Appwrite-JWT) | 服务端 API Key(X-Appwrite-Key) |
|---|---|---|---|
| 适用端侧 | 浏览器 Web 应用、移动端 App(agentbase-web-sdk@2.10.0) | 前端调用企业自建后端服务、或访问 SQL Proxy 用户态接口 | 企业后端微服务、定时任务、Agent 编排后端(agentbase-node-sdk@2.10.0) |
| 签发方式 | 调用 createEmailPasswordSession、createOAuth2Session 等登录接口生成 | 已登录客户端调用 account.createJWT() 动态生成 | 组织管理员在 Console Overview → API Keys 中创建 |
| 生命周期 | 由项目 Security → Session length 决定(默认 365 天,可按秒/分/时/天配置) | 固定 15 分钟有效,过期前需由客户端利用有效 Session 重新签发 | 可配置永不过期或指定到期日,支持随时在 Console 吊销 |
| 权限评估模型 | 严格遵循当前用户的 Effective Roles(user:{id}、team:{id}/{role}、label:{name})及资源 ACL | 与签发该 JWT 的用户 Session 权限完全一致,严格受表级/行级/文件级 ACL 约束 | 按 Key 勾选的 Scopes 鉴权;在常规数据接口中默认具备服务端管理视角(不受客户端行级 ACL 限制) |
| 浏览器暴露风险 | 安全(优先使用 HttpOnly Cookie 并绑定域名平台) | 短期令牌,仅在前端向受信后端发起请求时放入请求头 | 绝对禁止放入前端代码或公开仓库,否则将导致全库读写权限泄露 |
2. 登录提供方与 Custom OAuth2 配置指南
在项目 Auth → Settings 页签中,管理员可按业务场景开启或关闭基础登录方式,并配置第三方 OAuth2 提供方:
| 登录方式类别 | 支持的具体方式 | 关键行为与适用场景 |
|---|---|---|
| 基础凭证登录 | Email and Password(邮箱密码)、Phone(手机短信) | 最常用的企业客户与内部员工登录方式;邮箱创建时自动转小写并校验项目内唯一性;手机号强制 E.164 格式(如 +8613800138001)。 |
| 无密码快捷登录 | Magic URL(魔法链接)、Email OTP(邮箱一次性验证码) | 用户无需记忆密码,点击邮件中的含签名跳转链接或输入 6 位数字验证码即可创建会话,适合轻量级客户门户。 |
| 匿名会话登录 | Anonymous(匿名访客) | 为未注册访客临时生成匿名 User ID 与会话(角色归入 guests 直到转正),用户后续可绑定邮箱密码平滑升级为正式注册账号,保留已有会话关联数据。 |
| 标准与自定义 OAuth2 | GitHub、Google、Apple、Microsoft、Custom OAuth2 等 | 支持接入标准 OAuth 2.0 Authorization Code 流程的身份源。Custom OAuth2 支持零代码配置接入企业自建统一身份认证(IdP)或 Gitee 等平台。 |
配置 Custom OAuth2(自定义 OAuth2 提供方)操作步骤
- 在外部身份源注册应用:前往企业统一身份平台(或 Gitee 等 OAuth2 提供方)创建 OAuth2 应用,记录签发的 Client ID 与 Client Secret。
- 进入控制台 OAuth2 设置:在项目
enterprise-ai-hub-210中,依次点击左侧栏 Auth → Settings,向下滚动至 OAuth2 Providers 区域,点击 Custom OAuth2。 - 开启开关并填写端点与映射参数:
| 配置项 | 是否必填 | 填写规范与示例值 |
|---|---|---|
| Enabled | 是 | 切换为开启状态以激活 Custom OAuth2 提供方。 |
| Client ID | 是 | 填入身份提供方分配的应用客户端 ID,如 enterprise_sso_client_210。 |
| Client Secret | 是 | 填入客户端密钥(仅加密保存在服务端,保存后界面不回显明文)。 |
| Well-Known Endpoint | 否 | 若身份源支持 OIDC 自动发现(如 https://idp.example.com/.well-known/openid-configuration),填入后可自动填充授权与令牌端点。 |
| Authorization Endpoint | 是 | OAuth2 授权跳转地址(必须为公网可达的 https:// 地址),如 https://gitee.com/oauth/authorize。 |
| Token Endpoint | 是 | 授权码换取 Access Token 的接口地址,如 https://gitee.com/oauth/token。 |
| User Info Endpoint | 是 | 获取用户资料 JSON 的接口地址,如 https://gitee.com/api/v5/user。 |
| Email Endpoint(邮箱端点) | 否 | 当主 User Info 接口未直接返回邮箱时,可配置独立的邮箱查询接口(如 https://gitee.com/api/v5/emails)。 |
| Client Authentication Method | 是 | 选择 Token 端点的客户端认证方式,支持 client_secret_post(表单提交密钥)或 client_secret_basic(Basic Auth 头)。 |
| Subject / Email / Name / Email Verified 字段路径 | 是 | 从 User Info(或 Email Endpoint)返回 JSON 中提取字段的点分隔路径或十进制数组下标(不支持复杂表达式)。当域名识别为 gitee.com 时,控制台会自动提示示例:Subject 填 id、Name 填 name、Email 填 0.email。注意:仅当 Email Verified 路径明确返回布尔值 true 时,系统才将用户邮箱标记为 Verified。 |
- 登记 Callback URI:复制弹窗底部自动生成的完整回调地址(形如
https://appbuild.oceanbase.com/v1/account/sessions/oauth2/callback/custom/<PROJECT_ID>),原样填入外部身份提供方的允许回调地址白名单中。 - 在 Test 页签执行 OAuth2 验收测试:
- 切换到 Auth → Test 页签。
- 确认当前访问主机的域名已登记在项目 Overview → Platforms 的 Web 平台列表中。
- 选择已启用的 OAuth2 提供方,按需填写自定义授权范围(Scope),点击 Test OAuth2 login 按钮发起真实跳转验证。
截图未公开:原图可能包含账号或资源标识。
界面参考:沿用已登记的历史截图,演示数据与当前项目可能不同;本次未重新取图。
安全与隔离机制说明:
state参数一次性消费,并与项目 ID、浏览器会话、Callback 地址、Client ID 及服务端state revision强绑定;一旦管理员修改了 OAuth2 配置,历史未完成的旧state立即失效。- 测试会话隔离:在 Auth → Test 页签登录产生的终端用户测试会话与管理员当前的 Console 登录态完全隔离;点击测试页的登出按钮仅销毁被测终端用户会话,不会导致管理员退出 Console。
3. 权限表达式(Permission Strings)与角色体系详解
Agentbase 采用统一的 Permission(操作动作)+ Role(授权主体角色)声明式模型控制 Databases、Storage 与 Messaging 的资源访问。四大基础权限动作为:
Permission.read(role):允许读取数据库行、查看或下载存储桶文件、订阅消息主题。Permission.create(role):允许在数据库表中新增行、或在存储桶中上传新文件。Permission.update(role):允许更新已有数据库行或修改文件元数据/权限。Permission.delete(role):允许删除数据库行或删除存储桶文件。Permission.write(role):复合简写,等价于同时授予create、update、delete三项写权限。
下表列出了所有受支持的 Role 角色表达式及其在 SDK 与底层存储中的映射规则:
| 角色类型 | SDK 构造表达式 | 底层角色字符串 | 鉴权匹配逻辑与典型业务场景 |
|---|---|---|---|
| 所有访问者(含未登录) | Role.any() | any | 匹配任何请求(无论是已登录用户还是未登录匿名请求)。适用于公开知识库附件下载或公开公告表读取。 |
| 所有未登录/匿名访客 | Role.guests() | guests | 仅匹配未携带有效注册用户会话的访客或 Anonymous 会话。适用于公开表单投递入口。 |
| 所有已登录用户 | Role.users([status]) | users 或 users/verified、users/unverified | 匹配项目内任意已登录终端用户。传入 'verified' 时(即 Role.users('verified')),强制要求用户的邮箱或手机号已完成验证。 |
| 指定单一用户 | Role.user(userId, [status]) | user:<USER_ID>(如 user:user_zhangwei_001) | 仅匹配指定 User ID 的终端用户。常用于 customer_tickets 行级安全(Row Security),确保客户张伟只能查看自己提交的工单。 |
| 指定团队全体成员 | Role.team(teamId) | team:<TEAM_ID>(如 team:team_support_ops) | 匹配已加入指定团队的任意成员(不论其在团队内担任何种角色)。适用于部门共享文档库或团队公共看板。 |
| 指定团队特定角色成员 | Role.team(teamId, role) | team:<TEAM_ID>/<ROLE>(如 team:team_support_ops/admin) | 仅匹配在指定团队中拥有特定自定义角色(如 admin、support_lead)的成员。适用于工单审批、知识库发布等越权敏感操作。 |
| 指定成员关系 ID | Role.member(membershipId) | member:<MEMBERSHIP_ID> | 精确匹配某一条特定团队成员关系记录(当用户退出重进团队产生新 Membership ID 时旧授权自动失效)。 |
| 持有特定标签的用户 | Role.label(name) | label:<LABEL_NAME>(如 label:vip、label:architect) | 匹配用户 labels 数组中包含该标签的任意终端用户。适用于向全体 vip 客户开放高优先级工单通道或专属存储桶访问。 |
服务端与客户端 SDK 权限配置代码示例
在 enterprise-ai-hub-210 项目中,当客户张伟(user_zhangwei_001)提交一条客户工单时,可使用 @alipay/agentbase-sdk@2.10.0(或 agentbase-web-sdk@2.10.0)为该工单行绑定“本人可读可改 + VIP 技术支持团队可读可处理”的复合权限:
import { Client, Databases, Permission, Role } from 'agentbase-web-sdk'; // 版本固定 @2.10.0
const client = new Client()
.setEndpoint('https://appbuild.oceanbase.com/v1')
.setProject('enterprise-ai-hub-210');
const databases = new Databases(client);
// 创建工单行并声明精细化行级权限(需表已开启 Row security)
const ticket = await databases.createDocument(
'enterprise_biz_db',
'customer_tickets',
'TK-20261022-001',
{
title: 'OceanBase 向量索引在高并发混合检索下的 HNSW 参数调优咨询',
status: 'open',
priority: 'high',
creatorUserId: 'user_zhangwei_001'
},
[
// 提单人张伟本人拥有读取与更新权限
Permission.read(Role.user('user_zhangwei_001')),
Permission.update(Role.user('user_zhangwei_001')),
// VIP 客户技术支持组全体成员可读取工单
Permission.read(Role.team('team_support_ops')),
// 仅 VIP 客户技术支持组的 admin 角色可更新或删除工单
Permission.update(Role.team('team_support_ops', 'admin')),
Permission.delete(Role.team('team_support_ops', 'admin'))
]
);常见问题与排障
Q1:为什么在客户端调用数据库或存储接口时返回 401 User (role: guests) missing scope (account) 或 401 user_unauthorized?
原因分析:
- 请求未成功携带终端用户的登录 Session Cookie 或
X-Appwrite-JWT请求头,导致服务端将该请求识别为未登录访客(role: guests)。 - 在跨域 Web 应用中,当前前端访问的域名(Hostname)未在项目 Overview → Platforms 中登记为受信任的 Web Platform,导致浏览器拦截了跨域 Cookie 或回退令牌。
- 目标数据库表或存储桶未向
Role.any()或当前用户所属的Role.user(...)/Role.team(...)授予对应的read/write权限。
解决步骤:
- 检查项目 Overview → Platforms,确认前端实际运行域名已添加至 Web 平台白名单。
- 若前后端分离且跨顶级域名部署,建议在登录后通过客户端 SDK 调用
account.createJWT()获取短期 JWT,并在请求头中显式传入X-Appwrite-JWT。 - 检查目标表 Settings → Permissions 或存储桶 Settings → Permissions,确认已包含匹配的
Role.users()、Role.user('<USER_ID>')或Role.team('<TEAM_ID>')授权项。
Q2:配置了 Custom OAuth2 后,在 Auth → Test 页面点击测试登录报错 Invalid state 或邮箱未标记为已验证(Unverified)怎么办?
原因分析:
Invalid state:在发起 OAuth2 跳转后,管理员中途修改并重新保存了 Custom OAuth2 配置(触发服务端state revision递增),或者回调地址的主机名与发起请求时的主机名不一致。- 邮箱未标记为
Verified:Custom OAuth2 要求身份提供方返回的用户 JSON 中,配置的 Email Verified 字段路径必须严格返回布尔类型true(字符串"true"、数字1或字段缺失均不会被视为已验证)。
解决步骤:
- 修改任何 Custom OAuth2 参数后,必须关闭旧的授权标签页,重新从 Auth → Test 页点击 Test OAuth2 login 生成全新的
state会话。 - 检查外部 IdP 的 User Info 响应体;若外部身份源不支持返回布尔型
email_verified: true,可在用户首次登录后由企业后端通过持有users.write权限的 Server SDK 调用users.updateEmailVerification(userId, true)完成人工或受信验证同步。
Q3:如何实现后台客服人员(如李娜 user_lina_002)在排查问题时安全冒充(Impersonate)客户视角,且不索要客户密码?
原因分析与解决方案: Agentbase 提供了受审计管控的 User Impersonation(用户冒充) 能力:
- 管理员进入 Auth → Users,点开受信任的高级坐席工程师账号(如
user_lina_002李娜),在 Overview 页签底部找到 User impersonation 卡片并开启开关。 - 开启后,李娜在使用客户端 SDK 登录自己的账号后,可在请求中指定冒充目标用户 ID(如
user_zhangwei_001),以张伟的权限视角重现前端工单或知识检索结果。 - 安全审计保障:所有通过冒充发起的请求,其底层操作审计日志(Activity)均会记录在发起冒充的操作人账号下,严禁向普通外部终端用户开启该开关。
Q4:修改了用户的团队角色(team:team_support_ops/admin)或用户标签(label:vip)后,需要用户重新登录才会生效吗?
回答:
- 对于 Session Cookie 认证:无需重新登录!Agentbase 在每次收到携带 Session 的请求时,会动态加载当前用户的最新 Labels 与 Team Memberships 列表计算 Effective Roles,因此添加/移除标签或移出团队会立即生效。
- **对于短期 JWT(
X-Appwrite-JWT)**:若业务侧对已签发的 15 分钟有效期 JWT 做了本地缓存,建议在权限变更敏感操作后引导客户端重新调用account.createJWT()刷新令牌。
相关文档
- 用户管理(Users):查看与检索终端用户、管理用户标签(Labels)、偏好设置(Preferences)、会话踢出与第三方身份解绑。
- 团队管理(Teams):配置项目内多租户团队、邀请团队成员及划分自定义团队角色。
- 认证安全策略(Security):配置会话有效时长、单用户并发会话上限、密码强度字典策略、MFA 多因素认证与测试模拟手机号。
- 邮件模板(Templates):基于自定义 SMTP 定制邮箱验证、Magic URL、OTP 验证码与团队邀请等 7 类通知邮件。
- 消息目标(Targets):管理用户关联的邮箱、短信与设备 Push 推送目标。
- 核心概念与权限模型:全局了解 Agentbase 组织、项目、资源隔离与权限评估规则。