SuperAPI AI 工具集

better-auth-organization-best-practices

安全与审计

查看项目

更新于 10-16 03:17

技能介绍

用途:为 Better Auth 配置多租户组织能力,覆盖组织创建、成员与邀请管理、自定义角色权限、团队以及 RBAC。

主要能力:服务端添加 organization() 插件、客户端添加 organizationClient() 插件,运行 npx @better-auth/cli migrate 后校验 organization、member、invitation 表;支持创建组织(创建者自动为 owner)、限制创建条件与数量、管理员代建组织、设置活动组织;成员添加、多角色分配、移除与角色更新、成员上限;邀请邮件、可分享邀请链接、邀请过期与数量配置;默认角色 owner/admin/member 与权限检查;启用团队、创建团队、管理团队成员与团队上限;动态访问控制与自定义角色;组织生命周期钩子;表名、字段名与附加字段自定义。

使用方式:在服务端 betterAuth 配置中注册 organization 插件并传入 allowUserToCreateOrganization、organizationLimit、membershipLimit、invitationExpiresIn、sendInvitationEmail、teams、dynamicAccessControl、hooks、schema 等选项;客户端通过 authClient.organization 调用 create、setActive、inviteMember、getInvitationURL、hasPermission、createTeam、addTeamMember、createRole 等方法。

适用场景:需要多租户、组织成员与邀请、团队协作和细粒度权限控制的应用。

限制:客户端添加成员需改用邀请系统;代建组织的 userId 不能与 session headers 同时使用;最后一个 owner 不可移除、退出或被移除 owner 角色;预定义角色不可删除,已分配角色需先重新分配;删除组织会清除关联数据,可用 disableOrganizationDeletion 或钩子实现软删除;邀请默认 48 小时过期,仅受邀邮箱可接受。