Overzicht
Passinstance gebruikt een hiërarchische Role-Based Access Control (RBAC)-engine volgens het principle of least privilege (Team Permissions API op /api/v1/rbac/*, visueel beheerd in het Dashboard onder Werkruimte-instellingen -> Leden & rollen: /settings/workspace/members, /settings/workspace/roles en /settings/workspace/roles/permission-matrix) die onderscheid maakt tussen Organisatiebreed bestuur (OrganizationMemberRole: OWNER | ADMIN | MEMBER) en operationele werkruimte-rollen. Beheerders kunnen teamleden uitnodigen (POST /api/v1/users/invitations), aangepaste rollen met overervingsstructuren aanmaken, tweefactorauthenticatie (2FA) per rol afdwingen en operators beperken tot specifieke passjablonen (template-access).
Architectuur voor RBAC met meerdere niveaus & sjabloonafbakening
Belangrijk: Autorisatiecontroles worden strikt aan de serverzijde afgedwongen in de NestJS-controller- en servicelagen. Het beperken van een aangepaste rol via
template-accessgarandeert dat een operator geen passen van niet-toegewezen sjablonen kan opvragen, wijzigen of exporteren, zelfs niet bij rechtstreekse REST API-aanroepen.
Organisatierollen versus werkruimterollen
Passinstance maakt onderscheid tussen overkoepelend Organisatie-lidmaatschap en machtigingen binnen een afzonderlijke Werkruimte (Customer):
| Niveau & rol | Reikwijdte | Kernmogelijkheden & machtigingen |
|---|---|---|
Organization OWNER | Alle werkruimtes in de organisatie | Volledige controle over geconsolideerde organisatiefacturering (GET /api/v1/organizations/current/billing-summary), aanmaken/verwijderen van werkruimtes, SAML 2.0 SSO-configuratie en overdracht van eigendom. |
Organization ADMIN | Toegewezen / alle werkruimtes | Beheren van teamuitnodigingen, werkruimte-instellingen, Apple/Google-ondertekeningscertificaten, API-sleutels (api:keys-manage) en webhooks. |
Workspace Editor (MEMBER) | Enkele werkruimte | Aanmaken en bewerken van passjablonen, instellen van mechanieken en niveaus, uitvoeren van CSV-batchimports en verzendingen via het Delivery Center. |
Workspace Operator | Enkele werkruimte / Toegewezen sjablonen | Individuele passen uitgeven of opzoeken, web-/mobiele validatiescanners bedienen en afgebakende scanrapporten bekijken zonder toegang tot facturering of API-sleutels. |
Aangepaste rollen, overerving & machtigingsbereiken (Team Permissions API)
Wanneer ingebouwde rollen te ruim zijn voor gespecialiseerde teams (zoals een extern marketingbureau of regionale winkelmanagers), kunnen werkruimtebeheerders aangepaste rollen definiëren onder Account → Teamleden → Rollen & machtigingen.
Belangrijkste RBAC API-endpoints
| Endpoint | HTTP-methode | Beschrijving |
|---|---|---|
/api/v1/rbac/roles | GET | Geeft een overzicht van alle ingebouwde en aangepaste rollen in de actieve werkruimte. |
/api/v1/rbac/roles | POST | Maakt een aangepaste RBAC-rol aan met expliciete machtigingstokens en optionele overerving van een bovenliggende rol. |
/api/v1/rbac/roles/:roleId | PUT | Werkt de naam, omschrijving, requireTwoFactor-vereiste of machtigingsset van een aangepaste rol bij. |
/api/v1/rbac/roles/:roleId | DELETE | Verwijdert een aangepaste rol (faalt veilig als er nog actieve teamleden aan zijn gekoppeld). |
/api/v1/rbac/roles/:roleId/inheritance | GET | Retourneert de bovenliggende/onderliggende overervingsboom voor de opgegeven rol. |
/api/v1/rbac/roles/:roleId/inherited-permissions | GET | Berekent de effectieve vereniging van directe machtigingen en geërfde machtigingen uit bovenliggende rollen. |
/api/v1/rbac/roles/:roleId/template-access | POST | Koppelt de rol aan een expliciete allowlist van templateIds (accessMode: 'SCOPED'). |
Een aangepaste rol met overerving aanmaken
POST /api/v1/rbac/roles HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>
Content-Type: application/json
{
"name": "Regional Event Coordinator",
"description": "Can manage passes and view scan analytics for assigned event templates only.",
"parentRoleId": "rol_builtin_operator",
"requireTwoFactor": true,
"permissions": [
"passes:read",
"passes:write",
"passes:export",
"scans:read",
"analytics:read"
]
}
Antwoordpayload (201 Created)
{
"id": "rol_01933210-8b44-7c00-9e12-445566778899",
"name": "Regional Event Coordinator",
"description": "Can manage passes and view scan analytics for assigned event templates only.",
"isSystemRole": false,
"parentRoleId": "rol_builtin_operator",
"requireTwoFactor": true,
"permissions": [
"passes:read",
"passes:write",
"passes:export",
"scans:read",
"analytics:read"
],
"createdAt": "2026-11-15T23:34:30.000Z"
}
Een rol beperken tot specifieke sjablonen (template-access)
Om een aangepaste rol zodanig af te schermen dat leden uitsluitend passen van specifieke sjablonen kunnen bekijken en beheren:
POST /api/v1/rbac/roles/rol_01933210-8b44-7c00-9e12-445566778899/template-access HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>
Content-Type: application/json
{
"accessMode": "SCOPED",
"templateIds": [
"b4f29c10-83e1-4a7b-9d12-56e8012a9c04",
"c8e12a90-41b2-4f00-8a11-998877665544"
],
"allowedActions": ["READ", "ISSUE_PASS", "SCAN_PASS", "EXPORT_DATA"]
}
{
"roleId": "rol_01933210-8b44-7c00-9e12-445566778899",
"accessMode": "SCOPED",
"scopedTemplateCount": 2,
"templateIds": [
"b4f29c10-83e1-4a7b-9d12-56e8012a9c04",
"c8e12a90-41b2-4f00-8a11-998877665544"
],
"updatedAt": "2026-11-15T23:35:02.000Z"
}
Gerelateerde documentatie
-
Beheer multi-werkruimte-agentschapsstructuren in Multi-klantbeheer.
-
Configureer persoonlijke TOTP 2FA in Profiel & voorkeuren.
-
Bekijk auditlogexports in Accountbeveiliging & toegang.
