Ü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
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:
| Einstellung | API-Feld | Verhalten & Geltungsbereich |
|---|---|---|
| Anzeigename & Avatar | firstName, lastName / PUT /api/v1/users/me/avatar | Erscheint in Team-Listen, Vorlagen-Revisionsverläufen und Compliance-Audit-Protokollen (GET /api/v1/audit-log/export.csv). |
| Oberflächensprache | locale (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-Zeitzone | timezone (IANA-Kennung) | Formatiert Aktivitätszeitstempel in Ihrer persönlichen Ansicht, während Analytics-Rollups der Workspace-Zeitzone treu bleiben. |
| Benachrichtigungskanäle | notifications-Objekt | Schaltet E-Mail-Benachrichtigungen für abgeschlossene Stapelimporte, Ablaufwarnungen von Zertifikaten, Zahlungsbelege und Login-Warnungen um. |
Profil & Präferenzen über die API aktualisieren
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:
{
"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
Secret & QR-URI erzeugen (
POST /api/v1/auth/2fa/setup): Liefert eine verschlüsselteotpauth://totp/-Provisionierungs-URI und einen Base32-Schlüssel (GET /api/v1/auth/2fa/statuszeigt den aktuellen Zustand). -
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-codeserneuert diese). -
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.
POST /api/v1/auth/2fa/verify HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>
Content-Type: application/json
{
"code": "482910"
}
{
"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/:sessionIdundDELETE /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
-
Workspace-weite Sicherheitsrichtlinien konfigurieren in Kontosicherheit & Zugriff.
-
Organisationswährung, gesetzliche Anschrift und Standardsprache festlegen in Unternehmenseinstellungen.
