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.
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:
| Eindpuntpad | Methode | Auth | Beschrijving | |||
|---|---|---|---|---|---|---|
/api/v1/customer/:customerId/security-settings | GET / PUT / POST / DELETE | Bearer | Leest, wijzigt (request payload), herstelt of verwijdert beleidsinstellingen voor werkruimtebeveiliging. | |||
/api/v1/auth/saml/admin/:customerId/idp | GET / PUT / DELETE | Bearer | Configureert SAML Identity Provider-metadata, Entity ID en X.509 IdP-certificaten (GET .../setup voor SP-handleiding). | |||
/api/v1/auth/saml/:customerId/login | GET | Public | Start SP-SSO-omleiding (naast GET .../metadata, POST .../acs en GET /api/v1/auth/saml/resolve). | |||
/api/v1/organizations/current/workspaces/switch | POST | Bearer | Wisselt van actieve tenantwerkruimte en roteert sessietokens om cross-tenant replay te voorkomen. | |||
/api/v1/api-keys | GET / POST | Bearer | Toont of verstrekt omgevingsgebonden API-sleutels (pi_live_ op productie, pi_test_ op sandbox). | |||
/api/v1/api-keys/:id/regenerate | POST | Bearer | Roteert atomair het geheim van een API-sleutel met behoud van de UUID en geconfigureerde scopes. | |||
/api/v1/api-keys/:id/deactivate | POST | Bearer | Schorst onmiddellijk een API-sleutel zonder historische gebruikstelemetrie te verwijderen. | |||
/api/v1/audit-log | GET | Bearer | Doorzoekt onveranderlijke beveiligings- en beheerdersauditgebeurtenissen in de werkruimte (classificaties tot SecurityLevel: `LOW | MEDIUM | HIGH | CRITICAL`). |
/api/v1/audit-log/export.csv | GET | Bearer (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:
{
"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 indienscopeswordt weggelaten).
{
"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 sluitpi_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.
