Skip to content
Helpcentrum-gids · Beveiliging & compliance
3 min leestijdGecontroleerd 2026-11-16

Accountbeveiliging & toegang

Beveilig toegang met 2FA per rol, sleutelrotatie, sessiebeheer en pincodebeschermde downloadlinks.

In deze gids

Defense-in-Depth identiteits- en toegangsarchitectuur

Passinstance handhaaft meerlaagse authenticatie, sessie-isolatie en cryptografische sleutelscoping voor dashboardoperators (/settings/workspace/security), zakelijke SAML 2.0 single sign-on (SSO), server-naar-server API-integraties en point-of-sale scannerapparaten.

SYSTEEMARCHITECTUUR
INTERACTIEVE ARCHITECTUUR
SYSTEEMARCHITECTUURSTROOM: AUTHENTICATIE- EN TOEGANGSCONTROLEPIJPLIJN
FASE 01
1
IDENTITEITSVERIFICATIE
Dashboardoperators: E-mail/wachtwoord + TOTP 2FA OF Enterprise SAML 2.0 (/api/v1/auth/saml/:customerId/*)
Serverintegraties: x-api-key (pi_live_... / pi_test_...) of OAuth2 JWT
Mobiele scanners: x-scanner-key + Operator-PIN (/scanner-keys/unlock-pin)
FASE 02
2
TENANT- EN RBAC-AUTORISATIEGRENS
Werkruimtebeveiligingsbeleid (GET/PUT /customer/:customerId/security-settings)
Sessierotatie bij werkruimtewissel (/organizations/current/workspaces/switch)
Fijnmazige rol- en sjabloonscoping (/api/v1/rbac/roles)
FASE 03
3
ONVERANDERLIJKE AUDITLOGGING
Query's en CSV-export (GET/api/v1/audit-log & /api/v1/audit-log/export.csv)

Eindpunten voor beveiligingshouding en toegangsbeheer

Werkruimte-eigenaren en beveiligingsbeheerders configureren het authenticatiebeleid (/settings/workspace/security), beheren API-sleutels (/settings/workspace/developer/api-credentials) en exporteren compliance-audittrails (/settings/workspace/developer/audit-logs) via deze gekoppelde eindpunten:

EindpuntpadMethodeAuthBeschrijving
/api/v1/customer/:customerId/security-settingsGET / PUT / POST / DELETEBearerLeest, wijzigt (request payload), herstelt of verwijdert beleidsinstellingen voor werkruimtebeveiliging.
/api/v1/auth/saml/admin/:customerId/idpGET / PUT / DELETEBearerConfigureert SAML Identity Provider-metadata, Entity ID en X.509 IdP-certificaten (GET .../setup voor SP-handleiding).
/api/v1/auth/saml/:customerId/loginGETPublicStart SP-SSO-omleiding (naast GET .../metadata, POST .../acs en GET /api/v1/auth/saml/resolve).
/api/v1/organizations/current/workspaces/switchPOSTBearerWisselt van actieve tenantwerkruimte en roteert sessietokens om cross-tenant replay te voorkomen.
/api/v1/api-keysGET / POSTBearerToont of verstrekt omgevingsgebonden API-sleutels (pi_live_ op productie, pi_test_ op sandbox).
/api/v1/api-keys/:id/regeneratePOSTBearerRoteert atomair het geheim van een API-sleutel met behoud van de UUID en geconfigureerde scopes.
/api/v1/api-keys/:id/deactivatePOSTBearerSchorst onmiddellijk een API-sleutel zonder historische gebruikstelemetrie te verwijderen.
/api/v1/audit-logGETBearerDoorzoekt onveranderlijke beveiligings- en beheerdersauditgebeurtenissen in de werkruimte (classificaties tot SecurityLevel: `LOWMEDIUMHIGHCRITICAL`).
/api/v1/audit-log/export.csvGETBearer (audit:read-all)Streamt tot 1000 gefilterde auditrijen als text/csv voor SOC 2- en compliance-evaluaties.

Beveiligingsinstellingen van de werkruimte configureren (request payload)

Beheerders kunnen organisatiebrede tweefactorauthenticatie afdwingen, time-outs voor inactieve sessies configureren, brute-force aanmeldpogingen blokkeren, wachtwoordcomplexiteit vereisen, demo-ondertekeningscertificaten uitschakelen en de levensduur van API-sleutels beheren via PUT /api/v1/customer/:customerId/security-settings:

JSON
{
  "requireTwoFactor": true,
  "enforceTwoFactorAuth": true,
  "sessionTimeoutMinutes": 60,
  "maxLoginAttempts": 5,
  "lockoutDurationMinutes": 15,
  "passwordMinLength": 12,
  "passwordRequireUppercase": true,
  "passwordRequireNumbers": true,
  "passwordHistoryLength": 5,
  "preventDemoCertificates": true,
  "apiRateLimitPerMinute": 120,
  "apiKeyExpirationDays": 180
}

Zakelijke SAML 2.0 Single Sign-On (SAML Identity Provider)

Zakelijke werkruimten kunnen operatoraanmeldingen federeren met Okta, Microsoft Entra ID (Azure AD), Google Workspace of Ping Identity via SAML SSO API (/api/v1/auth/saml/:customerId/*) en SAML Admin API (/api/v1/auth/saml/admin/:customerId/*). Elk SAML Identity Provider-record koppelt een Identity Provider Entity ID, SSO Sign-On URL en X.509-ondertekeningscertificaat rechtstreeks aan het tenantdomein.

Levenscyclus van gescopete API-sleutels (API_KEY_SCOPE_VALUES & API_KEY_ENVIRONMENT_VALUES)

Passinstance dwingt omgevingsisolatie af (API_KEY_ENVIRONMENT_VALUES: 'live' | 'test') door productiegegevens (pi_live_...) te scheiden van sandboxsleutels (pi_test_...). Wijs bij het aanmaken van een sleutel via POST /api/v1/api-keys scopes met minimale rechten toe uit API_KEY_SCOPE_VALUES:

  • 'passes' — Pasinstanties uitgeven, bijwerken, ongeldig verklaren en opzoeken.
  • 'templates' — Sjabloonschema's, attributen en mechanieken uitlezen.
  • 'scans' — Validatie en verzilveringen van mechanieken uitvoeren.
  • 'webhooks' — Push-/pull-webhookabonnementen beheren.
  • 'analytics' — Werkruimtestatistieken en rapporten opvragen.
  • '*' — Volledige administratieve ontwikkelaars-API-toegang (standaard indien scopes wordt weggelaten).
JSON
{
  "name": "POS Checkout Integration — Production",
  "environment": "live",
  "scopes": ["passes", "scans"],
  "expiresAt": "2027-05-15T00:00:00.000Z"
}

Belangrijk: Onbewerkte API-sleutelgeheimen (data.key) en koppelingstokens voor scanners (key) worden slechts eenmaal geretourneerd bij het aanmaken of roteren (POST /api/v1/api-keys/:id/regenerate). Bewaar geheimen in een speciale kluis of secrets manager en sluit pi_live_-sleutels nooit in binnen client-side browserbundels of binaire bestanden van mobiele applicaties.

Bekijk de infrastructuurversleuteling en compliance-controles in het Beveiligings- en vertrouwenscentrum.

Gerelateerde product- en ontwikkelaarsdocs

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.