Permission Model
Sorcia uses multi-layered security to ensure users only see documents they’re authorized to access.Permission Layers
Layer 1: Organization Membership
Database-level isolation using Row-Level Security (RLS):Layer 2: Access Control Lists (ACLs)
Document-level permissions:Layer 3: Source Permissions
Mirrors original system permissions:- Slack
- Google Drive
- Notion
- Public channel → All workspace members
- Private channel → Only channel members
- DMs → Never indexed
User Roles
Organization Roles
| Role | Permissions |
|---|---|
| Owner | Full admin access, billing, delete org |
| Admin | Manage integrations, invite users, configure |
| Member | Query knowledge base, view own history |
Custom Permission Groups
Create groups for fine-grained control:Permission Sync
Real-Time Sync
Permissions updated when:- User added/removed from Slack channel
- Google Drive file sharing changes
- Notion page permissions modified
Daily Reconciliation
Full permission audit runs nightly:- Fetch all ACLs from source systems
- Compare with Sorcia’s ACL table
- Update differences
- Log changes for audit
Query-Time Filtering
Every search automatically filters by permissions:Audit Logging
All queries are logged:Best Practices
Use Groups, Not Individual Users
Use Groups, Not Individual Users
Manage permissions via groups (e.g., “Engineering”, “Sales”) rather than individual users
Principle of Least Privilege
Principle of Least Privilege
Grant minimum necessary access. Users can always request more.
Regular Audits
Regular Audits
Review permissions quarterly. Remove access for departed team members.
Monitor Access Logs
Monitor Access Logs
Check audit logs for unusual access patterns
Common Scenarios
New Employee
Sensitive Document
Department Data
Troubleshooting
User can't see expected documents
User can't see expected documents
Check:
- User is org member
- Source permissions are correct
- ACLs have synced (wait 1-2 min)
- Document isn’t excluded via filters
Too many results returned
Too many results returned
Cause: User has broad accessSolution: Use filters or create restricted permission groups
Permissions not updating
Permissions not updating
Fix: Manual re-sync via Integrations → Configure → Sync Permissions
Security Guarantees
✓ No data leakage - Users never see unauthorized documents✓ Automatic sync - Permissions update in real-time✓ Source-of-truth - Respects original system permissions✓ Audit trail - All access logged for compliance