Skip to content
Hilfecenter-Anleitung · Konto- & Workspace-Einstellungen
3 Min. LesezeitGeprüft 2026-11-16

Profil & Präferenzen

Aktualisieren Sie Ihre persönlichen Anmeldedaten, Oberflächensprache, Zeitzone und Benachrichtigungsoptionen.

In dieser Anleitung

Überblick

Ihr persönliches Bedienerprofil steuert, wie Sie sich im Passinstance Dashboard anmelden (/settings/account/profile, /preferences, /notifications, /authentication, /two-factor-authentication und /sessions), wie Oberflächentexte und Zeitstempel in Ihrer Browsersitzung lokalisiert werden und wie Sicherheitsbenachrichtigungen Sie erreichen. Anders als workspace-weite Vorgaben unter Unternehmenseinstellungen gelten Änderungen in Konto -> Profil & Einstellungen ausschließlich für Ihre individuelle User-Identität, ohne Pass-Sprachen für Endkunden oder die Ansichten Ihrer Teammitglieder zu verändern.

Benutzeridentität, MFA & Sitzungslebenszyklus-Architektur

SYSTEMARCHITEKTUR-ABLAUF
INTERAKTIVE ARCHITEKTUR
BEDIENERPROFIL, TOTP-2FA & SITZUNGSVERWALTUNG
STUFE 01 BROWSER- / CLIENT-EBENE DES BEDIENERS
Profil & Sprach-UI
(/settings/account/*)
Authenticator-App
(RFC 6238 TOTP 6-st.)
Aktive Geräte-
Sitzungsverwaltung
STUFE 02 USERS-, AUTH- & SESSION-CONTROLLER (API)
Identität & Präferenzen
GET/api/v1/users/me/profile
PUT/api/v1/users/me/profile
`PUT/api/v1/users/:id/preferences
Theme: light | dark | system
Sicherheit & Sitzungskontrolle
POST/api/v1/auth/2fa/setup
POST/api/v1/auth/2fa/verify
POST/api/v1/users/change-passw
DELETE/api/v1/sessions/:id
STUFE 03 PERSISTENZ- & SICHERHEITSAUDIT-EBENE
User-Datensatz (Verschl. TOTP-Secret, Bcrypt-Passwort-Hash, Backup-Codes)
in-memory cache Refresh-Token-Speicher (Sofortige Abmeldung aller Sessions bei Passw.)

Wichtig: Änderungen an Ihrer persönlichen Oberflächensprache oder dem Design-Modus (Theme) wirken sich ausschließlich auf Ihre eigene Dashboard-Sitzung aus. Endkunden-Passtexte, Smart-Downloadseiten (/d/:slug) und PassFlow-Registrierungsformulare folgen stets den Sprachregeln der jeweiligen Pass-Vorlage und den Unternehmenseinstellungen.

Persönliches Profil & Oberflächenpräferenzen

Öffnen Sie Konto -> Profil (/settings/account/profile) und Einstellungen (/settings/account/preferences), um Ihre Benutzeridentität und UI-Präferenzen anzupassen:

EinstellungAPI-FeldVerhalten & Geltungsbereich
Anzeigename & AvatarfirstName, lastName / PUT /api/v1/users/me/avatarErscheint in Team-Listen, Vorlagen-Revisionsverläufen und Compliance-Audit-Protokollen (GET /api/v1/audit-log/export.csv).
Oberflächensprachelocale (en, de, es, fr, it, nl, pt)Steuert das UI-Wörterbuch des Dashboards unabhängig von Workspace- oder Vorlagensprachen.
Design-Modus (Theme)theme (light, dark, system)Speichert Ihr bevorzugtes Farbschema geräteübergreifend und synchronisiert es mit den semantischen CSS-Tokens.
Anzeige-Zeitzonetimezone (IANA-Kennung)Formatiert Aktivitätszeitstempel in Ihrer persönlichen Ansicht, während Analytics-Rollups der Workspace-Zeitzone treu bleiben.
Benachrichtigungskanälenotifications-ObjektSchaltet E-Mail-Benachrichtigungen für abgeschlossene Stapelimporte, Ablaufwarnungen von Zertifikaten, Zahlungsbelege und Login-Warnungen um.

Profil & Präferenzen über die API aktualisieren

HTTP
PUT /api/v1/users/me/profile HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "firstName": "Elena",
  "lastName": "Rostova",
  "timezone": "Europe/Berlin"
}

Verwenden Sie PUT /api/v1/users/:userId/preferences (bzw. GET /api/v1/users/me/settings), um UI-Sprache, Theme und Benachrichtigungsflags anzupassen:

JSON
{
  "id": "usr_019331a0-4c22-7b10-8a99-112233445566",
  "email": "elena.rostova@example.com",
  "firstName": "Elena",
  "lastName": "Rostova",
  "locale": "en",
  "timezone": "Europe/Berlin",
  "theme": "dark",
  "twoFactorEnabled": true,
  "updatedAt": "2026-11-16T09:31:00.000Z"
}

Einrichtung der Zwei-Faktor-Authentifizierung (TOTP 2FA)

Passinstance unterstützt zeitbasierte Einmalpasswörter nach RFC 6238 (TOTP) unter /settings/account/two-factor-authentication, kompatibel mit 1Password, Google Authenticator, Authy und Apple Passwörter. Workspaces können zudem eine 2FA-Pflicht für administrative Rollen unter Teammitglieder & Berechtigungen erzwingen.

  1. 1
    Secret & QR-URI erzeugen (POST /api/v1/auth/2fa/setup): Liefert eine verschlüsselte otpauth://totp/-Provisionierungs-URI und einen Base32-Schlüssel (GET /api/v1/auth/2fa/status zeigt den aktuellen Zustand).
  2. 2
    Verifizieren & aktivieren (POST /api/v1/auth/2fa/verify + /api/v1/auth/2fa/enable): Übermitteln Sie einen gültigen 6-stelligen Code aus Ihrer Authenticator-App, um 2FA zu aktivieren und einmalig verwendbare Notfall-Wiederherstellungscodes zu erhalten (POST /api/v1/auth/2fa/regenerate-backup-codes erneuert diese).
  3. 3
    Sichere Aufbewahrung der Backup-Codes: Bewahren Sie die erzeugten Wiederherstellungscodes sicher auf; jeder Code lässt sich bei Verlust Ihres Authentifizierungsgeräts genau einmal nutzen.
HTTP
POST /api/v1/auth/2fa/verify HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "code": "482910"
}
JSON
{
  "twoFactorEnabled": true,
  "verifiedAt": "2026-11-16T09:32:15.000Z",
  "recoveryCodes": [
    "PI-894A-221C",
    "PI-773B-904D",
    "PI-112E-665F",
    "PI-550C-338A"
  ]
}

Passwortwechsel & Verwaltung aktiver Sitzungen

Unter Konto -> Authentifizierung (/settings/account/authentication) und Sitzungen (/settings/account/sessions) können Sie Ihr Passwort ändern und alle derzeit mit Ihrem Benutzerkonto verbundenen Sitzungen prüfen:

  • Passwortwechsel (POST /api/v1/users/change-password): Erfordert die Bestätigung Ihres aktuellen Passworts (und eines aktuellen TOTP-Codes bei aktiver 2FA). Ein Passwortwechsel widerruft automatisch alle übrigen aktiven Refresh-Tokens auf Zweitgeräten.
  • Sitzungseinsicht & Widerruf (GET /api/v1/users/sessions, DELETE /api/v1/sessions/:sessionId und DELETE /api/v1/sessions/others): Zeigt IP-Adresse, Browser-/OS-User-Agent, Gerätevertrauensstatus (/api/v1/sessions/trust-device) und Zeitpunkt der letzten Aktivität für eine gezielte Abmeldung aus der Ferne.

Weiterführende Dokumentation

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.