Skip to main content

Security overview

Crusoe AI Platform enforces multi-tenant isolation, role-based access control (RBAC), and strict separation between platform administration and customer project data.

Two axes of authority

Authority within the platform is divided into two independent axes:

  1. Metadata Authority: Power over project management—creating, renaming, or deleting projects and managing project memberships.
  2. Resource Authority: Power over project contents—agents, functions, secret values, Pub/Sub topics, vector indexes, and database instances.

Strict platform admin separation

Platform administrators hold metadata authority across the infrastructure to manage tenancy and platform health, but hold no resource authority over project contents.

API endpoints enforce this boundary: when a platform administrator queries customer project resources directly, the API returns 404 Not Found—preventing unauthorized inspection of customer data.


Role-based access control (RBAC)

RoleScopeMetadata AuthorityResource Authority
Platform AdminInfrastructureAll projects (tenancy management)None (Break-glass access only)
Organization AdminOrganizationAll projects in the organizationInherited Admin across org projects
Project AdminSingle ProjectProject metadata & membershipFull resource control, secret reveals, key management
Project MemberSingle ProjectRead-only membership metadataExecute, deploy, and interact with project resources
Service AccountSingle ProjectNoneAssigned resource role (Member or Admin)

Break-glass administrative access

When a customer requests support or emergency troubleshooting, platform staff can request temporary, time-bound break-glass access:

  • Required Justification: Staff must provide a written reason string (minimum 8 characters) specifying the support ticket ID.
  • Time-Bound Expiration: Grants automatically expire (default: 4 hours; maximum: 24 hours).
  • Public Visibility: Active break-glass grants appear prominently on the project IAM page.
  • Immutable Audit Trail: Every break-glass grant is permanently logged to the project's immutable audit trail (project.break-glass).

Access evaluation (404 vs 403 response policy)

To prevent resource enumeration and unauthorized scanning, the API enforces a strict response policy:

  • No Project Access → 404 Not Found: Callers lacking access to a project receive 404 Not Found for all paths, hiding project existence.
  • Valid Project Member, Insufficient Permission → 403 Forbidden: Authenticated project members trying to perform administrative actions without sufficient role privileges receive 403 Forbidden.

Feature comparison

Security CapabilityCrusoe AI PlatformAWS IAM / GCP IAM / Azure RBAC
Project Role ModelSimple Member / Admin per projectFine-grained policy documents
Staff IsolationHard code-enforced isolation + audited break-glassGoverned by internal provider IAM policies
Permission EvaluationLive database evaluation per requestNear real-time propagation
Audit LoggingImmutable per-project audit trailAWS CloudTrail / GCP Audit Logs

Next steps