mehrschichtige Identitäts- und Zugriffsarchitektur (Defense-in-Depth)
Passinstance setzt eine mehrstufige Authentifizierung, Sitzungsisolierung und kryptografische Schlüsselbegrenzung für Dashboard-Betreiber (/settings/workspace/security), Enterprise-SAML-2.0-Single-Sign-On (SSO), Server-zu-Server-API-Integrationen und Point-of-Sale-Scannergeräte durch.
Endpunkte für Sicherheitsstatus & Zugriffsverwaltung
Workspace-Inhaber und Sicherheitsadministratoren konfigurieren Authentifizierungsrichtlinien (/settings/workspace/security), verwalten API-Schlüssel (/settings/workspace/developer/api-credentials) und exportieren Compliance-Audit-Protokolle (/settings/workspace/developer/audit-logs) über diese bereitgestellten Endpunkte:
| Endpunktpfad | Methode | Authentifizierung | Beschreibung | |||
|---|---|---|---|---|---|---|
/api/v1/customer/:customerId/security-settings | GET / PUT / POST / DELETE | Bearer | Liest, aktualisiert (request payload), setzt zurück oder entfernt Richtlinienkontrollen für die Workspace-Sicherheit. | |||
/api/v1/auth/saml/admin/:customerId/idp | GET / PUT / DELETE | Bearer | Konfiguriert SAML Identity Provider-Metadaten, Entity-ID und X.509-IdP-Zertifikate (GET .../setup für den SP-Leitfaden). | |||
/api/v1/auth/saml/:customerId/login | GET | Öffentlich | Initiiert die SP-SSO-Weiterleitung (neben GET .../metadata, POST .../acs und GET /api/v1/auth/saml/resolve). | |||
/api/v1/organizations/current/workspaces/switch | POST | Bearer | Wechselt den aktiven Mandanten-Workspace und rotiert Sitzungs-Tokens, um mandantenübergreifende Replay-Angriffe zu verhindern. | |||
/api/v1/api-keys | GET / POST | Bearer | Listet umgebungsgebundene API-Schlüssel auf oder stellt sie bereit (pi_live_ in der Produktion, pi_test_ in der Sandbox). | |||
/api/v1/api-keys/:id/regenerate | POST | Bearer | Rotiert das Geheimnis eines API-Schlüssels atomar unter Beibehaltung seiner UUID und der konfigurierten Berechtigungsumfänge (scopes). | |||
/api/v1/api-keys/:id/deactivate | POST | Bearer | Sperrt einen API-Schlüssel sofort, ohne die historische Nutzungstelemetrie zu löschen. | |||
/api/v1/audit-log | GET | Bearer | Fragt unveränderliche Sicherheits- und Verwaltungs-Audit-Ereignisse des Workspaces ab (Klassifizierungen bis zu SecurityLevel: `LOW | MEDIUM | HIGH | CRITICAL`). |
/api/v1/audit-log/export.csv | GET | Bearer (audit:read-all) | Streamt bis zu 1000 gefilterte Audit-Zeilen als text/csv für SOC-2- und Compliance-Prüfungen. |
Konfigurieren der Workspace-Sicherheitseinstellungen (request payload)
Administratoren können über PUT /api/v1/customer/:customerId/security-settings eine organisationsweite Zwei-Faktor-Authentifizierung erzwingen, Sitzungs-Timeouts bei Inaktivität festlegen, Brute-Force-Anmeldungen sperren, Passwortkomplexität vorschreiben, Demo-Signaturzertifikate deaktivieren und die Gültigkeitsdauer von API-Schlüsseln steuern:
{
"requireTwoFactor": true,
"enforceTwoFactorAuth": true,
"sessionTimeoutMinutes": 60,
"maxLoginAttempts": 5,
"lockoutDurationMinutes": 15,
"passwordMinLength": 12,
"passwordRequireUppercase": true,
"passwordRequireNumbers": true,
"passwordHistoryLength": 5,
"preventDemoCertificates": true,
"apiRateLimitPerMinute": 120,
"apiKeyExpirationDays": 180
}
Enterprise SAML 2.0 Single Sign-On (SAML Identity Provider)
Enterprise-Workspaces können Betreiberanmeldungen mit Okta, Microsoft Entra ID (Azure AD), Google Workspace oder Ping Identity über den SAML SSO API (/api/v1/auth/saml/:customerId/*) und den SAML Admin API (/api/v1/auth/saml/admin/:customerId/*) föderieren. Jeder SAML Identity Provider-Datensatz bindet eine Identity-Provider-Entity-ID, eine SSO-Anmelde-URL und ein X.509-Signaturzertifikat direkt an die Mandantendomäne.
Lebenszyklus berechtigungsbegrenzter API-Schlüssel (API_KEY_SCOPE_VALUES & API_KEY_ENVIRONMENT_VALUES)
Passinstance setzt eine strikte Umgebungstrennung (API_KEY_ENVIRONMENT_VALUES: 'live' | 'test') durch, die Produktionszugangsdaten (pi_live_...) von Sandbox-Schlüsseln (pi_test_...) isoliert. Weisen Sie beim Bereitstellen eines Schlüssels über POST /api/v1/api-keys minimale Berechtigungen (Least Privilege) aus API_KEY_SCOPE_VALUES zu:
-
'passes'— Karteninstanzen ausstellen, aktualisieren, ungültig machen und nachschlagen. -
'templates'— Vorlagenschemata, Attribute und Mechaniken lesen. -
'scans'— Validierungen und Mechanik-Einlösungen ausführen. -
'webhooks'— Push-/Pull-Webhook-Abonnements verwalten. -
'analytics'— Workspace-Metriken und Berichte abfragen. -
'*'— Vollständiger administrativer Entwickler-API-Zugriff (Standardwert, wennscopesweggelassen wird).
{
"name": "POS Checkout Integration — Production",
"environment": "live",
"scopes": ["passes", "scans"],
"expiresAt": "2027-05-15T00:00:00.000Z"
}
Wichtig: Unverschlüsselte API-Schlüsselgeheimnisse (
data.key) und Scanner-Kopplungs-Tokens (key) werden nur einmalig bei der Erstellung oder Rotation (POST /api/v1/api-keys/:id/regenerate) zurückgegeben. Speichern Sie Geheimnisse in einem dedizierten encrypted storage oder Secrets-Manager und betten Sie niemalspi_live_-Schlüssel in clientseitige Browser-Bundles oder Binärdateien mobiler Apps ein.
Überprüfen Sie die Infrastrukturverschlüsselung und Compliance-Kontrollen im Sicherheits- & Trust-Center.
