Skip to content
Helpcentrum-gids · Account- & werkruimte-instellingen
3 min leestijdGecontroleerd 2026-11-16

Teamleden & machtigingen

Nodig collega's uit met Admin-, Editor- of Operator-rollen, projecttoegang en rolgebonden 2FA.

In deze gids

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

SYSTEEMARCHITECTUUR
INTERACTIEVE ARCHITECTUUR
MEERLAAGSE RBAC & SJABLOONAFBAKENING
FASE 01 NIVEAU 1: ORGANISATIEBESTUUR
Organization-rollen: OWNER | ADMIN | MEMBER
Beheert meervoudige werkruimtes, geconsolideerde facturering & SSO/SAML
FASE 02 NIVEAU 2: HIËRARCHIE VAN WERKRUIMTEROLLEN
Team Permissions API (/api/v1/rbac/roles)
Systeemrollen: Workspace Admin, Campaign Editor, Scanner Operator
Aangepaste rollen: POST/api/v1/rbac/roles met fijnmazige scopes
Rolovererving: GET/api/v1/rbac/roles/:roleId/inheritance
FASE 03 NIVEAU 3: TOEGANGSBEPERKING OP SJABLOONNIVEAU
POST/api/v1/rbac/roles/:roleId/template-access
Beperkt rolhouders tot expliciete templateId-toestemmingslijsten
Server-side afgedwongen over paszoeken, verzendingen, scans & exports

Belangrijk: Autorisatiecontroles worden strikt aan de serverzijde afgedwongen in de NestJS-controller- en servicelagen. Het beperken van een aangepaste rol via template-access garandeert 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 & rolReikwijdteKernmogelijkheden & machtigingen
Organization OWNERAlle werkruimtes in de organisatieVolledige 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 ADMINToegewezen / alle werkruimtesBeheren van teamuitnodigingen, werkruimte-instellingen, Apple/Google-ondertekeningscertificaten, API-sleutels (api:keys-manage) en webhooks.
Workspace Editor (MEMBER)Enkele werkruimteAanmaken en bewerken van passjablonen, instellen van mechanieken en niveaus, uitvoeren van CSV-batchimports en verzendingen via het Delivery Center.
Workspace OperatorEnkele werkruimte / Toegewezen sjablonenIndividuele 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

EndpointHTTP-methodeBeschrijving
/api/v1/rbac/rolesGETGeeft een overzicht van alle ingebouwde en aangepaste rollen in de actieve werkruimte.
/api/v1/rbac/rolesPOSTMaakt een aangepaste RBAC-rol aan met expliciete machtigingstokens en optionele overerving van een bovenliggende rol.
/api/v1/rbac/roles/:roleIdPUTWerkt de naam, omschrijving, requireTwoFactor-vereiste of machtigingsset van een aangepaste rol bij.
/api/v1/rbac/roles/:roleIdDELETEVerwijdert een aangepaste rol (faalt veilig als er nog actieve teamleden aan zijn gekoppeld).
/api/v1/rbac/roles/:roleId/inheritanceGETRetourneert de bovenliggende/onderliggende overervingsboom voor de opgegeven rol.
/api/v1/rbac/roles/:roleId/inherited-permissionsGETBerekent de effectieve vereniging van directe machtigingen en geërfde machtigingen uit bovenliggende rollen.
/api/v1/rbac/roles/:roleId/template-accessPOSTKoppelt de rol aan een expliciete allowlist van templateIds (accessMode: 'SCOPED').

Een aangepaste rol met overerving aanmaken

HTTP
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)

JSON
{
  "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:

HTTP
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"]
}
JSON
{
  "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

Klaar om uw eerste kaartprogramma te lanceren?

Maak uw workspace aan, configureer uw sjabloon en test een echte kaart in Apple Wallet en Google Wallet voordat u opschaalt.