SuperAPI AI 工具集

rls-templates

通用与其它

查看项目

更新于 10-16 05:47

技能介绍

用途:为 Supabase 应用提供生产可用的行级安全(RLS)策略模板,重点覆盖 AI 应用场景,如多租户聊天、RAG 系统与用户专属向量嵌入。

主要能力:提供多种策略模式。user-isolation.sql 用于用户直接拥有行(auth.uid() = user_id),适合个人资料、设置、个人文档;multi-tenant.sql 用于组织/团队隔离,通过连接检查组织成员身份,适合 SaaS 与团队工作区;role-based-access.sql 按角色区分权限,从 auth.jwt() 声明读取角色,适合管理面板与分级访问;ai-chat-policies.sql 用于聊天/会话数据,用户拥有会话并配合参与者表;embeddings-policies.sql 用于向量/嵌入数据,用户拥有源文档进而拥有嵌入,适合 RAG 与语义搜索。

使用方式:通过脚本应用策略,如 bash scripts/apply-rls-policies.sh user-isolation conversations messages;生成自定义策略,如 bash scripts/generate-policy.sh user-isolation my_table user_id;测试策略,如 bash scripts/test-rls-policies.sh conversations,可指定 --user-id 或 --org-id;审计缺失 RLS 的表,如 bash scripts/audit-rls.sh,可生成报告 --report audit-report.md。也可在 SQL 中直接引入模板文件,如 \i templates/ai-chat-policies.sql。

适用场景:需要用户隔离、多租户隔离、角色权限控制或 AI 聊天与向量数据安全的 Supabase 项目。

限制与要求:需 Supabase 项目数据库访问权限、已安装 psql,并设置 SUPABASE_DB_URL、SUPABASE_ANON_KEY、SUPABASE_SERVICE_KEY 环境变量。安全上应确保 public schema 所有表启用 RLS,测试认证与匿名访问,为策略列建索引,服务密钥不得暴露给客户端,策略中使用 (SELECT auth.uid()) 提升性能,INSERT/UPDATE 策略包含 WITH CHECK,并验证用户/租户间隔离。性能优化包括建索引、包装 auth 函数、客户端始终过滤、复杂授权用 security definer 函数、策略中指定 TO authenticated。最佳实践为添加数据前启用 RLS、多用户上下文测试、在 CI/CD 中定期审计、在迁移文件中记录策略决策并监控查询性能。其他收费、平台细节暂未提供。