Skip to content
Hilfecenter-Anleitung · Sicherheit & Compliance
3 Min. LesezeitGeprüft 2026-11-16

Kontosicherheit & Zugriff

Schützen Sie Konten durch rollenpflichtige 2FA, Schlüsselrotation, Sitzungswiderruf und PIN-Downloadschutz.

In dieser Anleitung

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.

SYSTEMARCHITEKTUR-ABLAUF
INTERAKTIVE ARCHITEKTUR
AUTHENTIFIZIERUNGS- & ZUGRIFFSKONTROLL-PIPELINE
STUFE 01
1
IDENTITÄTSPRÜFUNG
Dashboard-Betreiber: E-Mail/Passwort + TOTP 2FA ODER Enterprise SAML 2.0 (/api/v1/auth/saml/:customerId/*)
Server-Integrationen: x-api-key (pi_live_... / pi_test_...) oder OAuth2
Mobile Scanner: x-scanner-key + Bediener-PIN (/scanner-keys/unlock-pin)
STUFE 02
2
MANDANTEN- & RBAC-AUTORISIERUNGSGRENZE
Workspace-Sicherheitsrichtlinie (GET/PUT /customer/:customerId/security-settings)
Sitzungsrotation bei Workspace-Wechsel (/organizations/current/workspaces/switch)
Fein granulare Rollen- & Vorlagenbegrenzung (/api/v1/rbac/roles)
STUFE 03
3
UNVERÄNDERLICHE AUDIT-PROTOKOLLIERUNG
Abfragen & CSV-Export (GET/api/v1/audit-log & /api/v1/audit-log/export.csv)

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:

EndpunktpfadMethodeAuthentifizierungBeschreibung
/api/v1/customer/:customerId/security-settingsGET / PUT / POST / DELETEBearerLiest, aktualisiert (request payload), setzt zurück oder entfernt Richtlinienkontrollen für die Workspace-Sicherheit.
/api/v1/auth/saml/admin/:customerId/idpGET / PUT / DELETEBearerKonfiguriert SAML Identity Provider-Metadaten, Entity-ID und X.509-IdP-Zertifikate (GET .../setup für den SP-Leitfaden).
/api/v1/auth/saml/:customerId/loginGETÖffentlichInitiiert die SP-SSO-Weiterleitung (neben GET .../metadata, POST .../acs und GET /api/v1/auth/saml/resolve).
/api/v1/organizations/current/workspaces/switchPOSTBearerWechselt den aktiven Mandanten-Workspace und rotiert Sitzungs-Tokens, um mandantenübergreifende Replay-Angriffe zu verhindern.
/api/v1/api-keysGET / POSTBearerListet umgebungsgebundene API-Schlüssel auf oder stellt sie bereit (pi_live_ in der Produktion, pi_test_ in der Sandbox).
/api/v1/api-keys/:id/regeneratePOSTBearerRotiert das Geheimnis eines API-Schlüssels atomar unter Beibehaltung seiner UUID und der konfigurierten Berechtigungsumfänge (scopes).
/api/v1/api-keys/:id/deactivatePOSTBearerSperrt einen API-Schlüssel sofort, ohne die historische Nutzungstelemetrie zu löschen.
/api/v1/audit-logGETBearerFragt unveränderliche Sicherheits- und Verwaltungs-Audit-Ereignisse des Workspaces ab (Klassifizierungen bis zu SecurityLevel: `LOWMEDIUMHIGHCRITICAL`).
/api/v1/audit-log/export.csvGETBearer (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:

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
}

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, wenn scopes weggelassen wird).
JSON
{
  "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 niemals pi_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.

Weiterführende Produkt- & Entwicklerdoku

Bereit für Ihr erstes Wallet-Kartenprogramm?

Erstellen Sie Ihren Workspace, konfigurieren Sie Ihre Vorlage und testen Sie eine echte Karte in Apple Wallet und Google Wallet, bevor Sie skalieren.