Roles and permissions
Instance roles, app roles, effective permissions, and authorization behavior.
Oore combines one instance role with an optional role on each app. Instance Owners and Admins have implicit full app access. Developers and QA Viewers need explicit app membership.
Instance roles
| Role | Instance access |
|---|---|
owner | Full administration and app access; exactly one Owner exists |
admin | Full administration and app access, except Owner-only actions |
developer | Read apps, pipelines, builds, artifacts, runners, and integrations; operate assigned apps |
qa_viewer | Read assigned app, pipeline, build, artifact, and integration data |
Developers can manage their API tokens. Owners and Admins can manage users, settings, integrations, runners, and audit surfaces. QA Viewers do not receive operator write permissions.
App roles
| App role | Effective permissions |
|---|---|
maintainer | All app permissions, including settings, deletion, members, pipelines, builds, and artifacts |
developer | Read; manage pipelines; trigger or cancel builds; read and write artifacts |
viewer | Read the app and artifacts |
Owners and Admins resolve to Maintainer on every app without a membership row. A Developer’s explicit membership is capped at Developer. A QA Viewer’s membership is always capped at Viewer, including if older data contains a higher app role.
Effective access
App permission checks use both layers:
- Resolve the instance role.
- Resolve explicit app membership when the instance role is not Owner or Admin.
- Cap the app role at the maximum allowed by the instance role or API token.
- Check the action-specific app permission.
A caller with no app access receives 404 not_found, which avoids leaking
the app’s existence. A caller who can discover the app but lacks the
requested action receives 403 permission_denied.
Users also have an account status: invited, active, or disabled.
Disabling a user revokes sessions and API tokens. Restoring the user does not
restore those credentials.
For operator tasks, see Manage roles and app access and Disable or restore a user.