Role-based access control

Jutsu authorizes every request against two layers of roles — what you hold inside an organization and a platform-level role on your account — and evaluates all data access within a single organization boundary.

Two role layers

Organization member roles

Your role within an organization determines what you can do with that organization's data. The defined roles are:

RolePurpose
ownerThe organization's owner. Full control, including settings and ownership-level actions. One owner per organization.
adminAdministers the organization, its members, and its settings.
memberDefault role for a newly added member.
analystGeneral security analyst.
l1_analystFirst-line triage.
l2_analystTakes escalations and drives response.
l3_analystDeep investigation and senior review.

The tiered analyst roles map onto an escalation workflow: L1 triages, L2 takes escalations and runs response, and L3 owns the hardest investigations. Higher tiers generally include the abilities of lower ones.

Platform roles

Your account also carries a platform-level role that applies across Jutsu, independent of any single organization:

RolePurpose
userDefault account role.
analystPlatform analyst.
adminPlatform administrator.
superSuper-admin — operates the platform itself, including administrative areas that span tenants.

Middleware guards

Access is enforced by layered middleware on the API, evaluated in order:

  1. Authentication guard. Requires a valid session token, loads the current user, and rejects unauthenticated or deactivated accounts with 401/403.
  2. Super-admin guard. Restricts platform-administration routes to accounts whose platform role is super; everyone else receives 403.
  3. Organization-owner guard. Restricts ownership-level actions on an organization to that organization's owner (super-admins are also allowed). A non-owner acting on the organization receives 403.

Because the guards run in sequence, a request must clear authentication before any role check, and role checks are evaluated against the organization the request is scoped to.

Role × capability matrix

The following summarizes capabilities by organization role at a sensible granularity. Higher analyst tiers inherit the abilities of lower ones.

Capabilitymemberanalyst / l1l2 / l3adminowner
View alerts & incidentsYesYesYesYesYes
Triage & investigate casesYesYesYesYes
Run / approve response actionsYesYesYes
Manage integration credentialsYesYes
Manage members & rolesYesYes
Organization & billing settingsYes

The exact permission a given role carries is enforced in your deployment. This matrix describes the intended division of duties; confirm specific permissions against your environment.

Multi-tenant isolation

Jutsu is multi-tenant. Every record — events, alerts, incidents, cases, credentials, and reports — is scoped to an organization, and access is always evaluated within that boundary. A user can belong to several organizations and holds an independent member role in each. A valid session for one organization never grants access to another organization's data; the request's organization context, combined with the member role, decides what is visible and permitted.