Skip to content

Security reference says standard users cannot read any data and unannotated routes default to admin-only #1791

Open

Description

@joshunrau

The Security reference misstates what the Standard User role can read and what happens to a route with no @RouteAccess. It says standard users "are not able to access any data" and "are only allowed to administer instruments". AbilityFactory gives the STANDARD role read Subject and read Session in their groups, and read Group too. So a standard user can list every subject in their groups, including the stored names, dates of birth and sex (GET /v1/subjects), and every session there with its subject embedded (GET /v1/sessions). For a route with no route access defined, the page also says "the default is manage and all", so only an admin may call it. JwtAuthGuard instead logs an error and throws a 500 for every caller, including admins. An admin deciding which role to give a research assistant uses this page to judge exposure. As written, it understates what the default role can see.

Where

docs/en/5-reference/5.1-security.md:28, :38 and :50-52:

... If there is no route access explicitly defined for a given route, the default is `manage` and `all`.
...
... If a route does not have any required permission set specified, the user must have permission to manage all resources to have access (i.e., the platform admin). ...
...
#### Standard User

By default, standard users are not able to access any data. They are only allowed to administer instruments, and download the record once complete (as it is stored in memory at that time).

apps/api/src/auth/ability.factory.ts:78-88:

case 'STANDARD':
  ability.can('read', 'Group', { id: { in: groupIds } });
  ability.can('read', 'Instrument');
  ability.can('create', 'InstrumentRecord');
  ability.can('create', 'InstrumentRecordFile', { groupId: { in: groupIds } });
  ability.can('read', 'Session', { groupId: { in: groupIds } });
  ability.can('create', 'Session');
  ability.can('create', 'Subject');
  ability.can('read', 'Subject', { groupIds: { hasSome: groupIds } });
  ability.can('read', 'User', { id: payload.id });

apps/api/src/auth/guards/jwt-auth.guard.ts:31-34:

if (!routeAccess) {
  this.loggingService.error(`Route access is not defined for url: ${request.url}`);
  throw new InternalServerErrorException();
}

Reproduce

  1. Create a user with the Standard User role in a group that has subjects identified by personal information.
  2. Sign in as that user and call GET /v1/subjects?groupId=<group> and GET /v1/sessions?groupId=<group>.

Actual: both return the group's subjects (with firstName, lastName, dateOfBirth, sex) and its sessions.
Expected (per the page): no data is returned.

Tests

docs/ has no test runner (docs/AGENTS.md). Review the corrected text against ability.factory.ts and jwt-auth.guard.ts.

Suggested fix

Rewrite "Standard User" to list what the role holds: it can create subjects, sessions and records, and it can read the subjects, sessions and group of its own groups, but not instrument records. Replace both "default is manage all" sentences with what the guard does: a route without @RouteAccess fails with 500 for everyone, and eslint (REQUIRE_ROUTE_ACCESS) refuses such a route at lint time.

Activity

  1. added
    BugType: existing behavior is wrong
    Difficulty: LowIsolated change, about 2 hours or less
    Area: Outreachapps/outreach and docs/ (marketing site and user documentation)
    SecurityAuthentication, authorization, data exposure or a vulnerable dependency
    on Oct 7, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    Area: Outreachapps/outreach and docs/ (marketing site and user documentation)BugType: existing behavior is wrongDifficulty: LowIsolated change, about 2 hours or lessPriority: MediumReal value; schedule normallySecurityAuthentication, authorization, data exposure or a vulnerable dependency

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions