Permissions

Target permissioning for multi-organization work.

Permissions

The current repository has Better Auth identity and organization tables. It does not yet implement relationship-scoped permissions, external participants, field policies, document policies, or workstream visibility.

Target boundaries#

BoundaryExample
OrganizationCustomer users can see their own implementation portal, not another customer's portal
RelationshipA vendor manager can access one vendor relationship, not all vendor records
WorkstreamCustomer security can see security review tasks, not pricing approval notes
ChannelA chat channel can sync to one workstream without exposing the entire account timeline
DocumentA DPA can be shared with legal while pricing files remain internal
FieldExternal users can see target launch date but not internal health rationale
ActionA customer can upload a file and comment, but cannot approve an internal exception

Target participant types#

  • Internal user: employee of the company using Arn.
  • External participant: customer, vendor, partner, auditor, consultant, or service provider.
  • Service account: integration identity for systems, channels, or bots.
  • Guest reviewer: time-bound access for legal, security, procurement, or executive review.

Target visibility states#

StateBehavior
Internalvisible only to internal users with access to the relationship
Sharedvisible to approved external participants in the relevant portal or channel
Restrictedvisible only to named users, teams, or roles
Redactedvisible as metadata, with sensitive content hidden
Pending approvalhidden externally until an authorized owner approves release

Target sync rules#

Permissions must apply before data moves:

  • Do not sync internal notes to external channels.
  • Do not write inferred contract terms into a system without approval.
  • Do not expose cross-customer vendor performance data to a single customer.
  • Do not include restricted files in generated summaries for unauthorized users.
  • Do not let external users discover internal-only records through search.

Current status#

Relationship-scoped RBAC, field policies, document policies, approval gates, audit logs for relationship actions, and permission-aware AI retrieval are not implemented yet.