Panoramica
Il Suo profilo operatore personale regola il modo in cui si autentica nella Dashboard di Passinstance (/settings/account/profile, /preferences, /notifications, /authentication, /two-factor-authentication e /sessions), come vengono localizzati i testi dell'interfaccia e i timestamp nella sessione del browser e come Le vengono recapitati gli avvisi di sicurezza. A differenza delle impostazioni a livello di intero workspace presenti in Impostazioni aziendali, le modifiche apportate in Account -> Profilo e preferenze si applicano esclusivamente alla Sua identità individuale User, senza alterare le impostazioni internazionali dei pass degli utenti finali o le visualizzazioni della Dashboard dei Suoi colleghi.
Architettura dell'identità utente, MFA e ciclo di vita della sessione
Importante: La modifica della Lingua dell'interfaccia o della Preferenza del tema personale influisce esclusivamente sulla sessione della Sua Dashboard. I testi dei pass rivolti ai clienti, le pagine di download intelligenti (
/d/:slug) e i moduli di iscrizione PassFlow seguono sempre le regole di localizzazione configurate sul rispettivo Modello di pass e nelle Impostazioni aziendali.
Profilo personale e preferenze dell'interfaccia
Acceda a Account -> Profilo (/settings/account/profile) e Preferenze (/settings/account/preferences) per configurare la Sua identità di operatore e le preferenze dell'interfaccia utente:
| Impostazione | Campo API | Comportamento e ambito |
|---|---|---|
| Nome visualizzato e avatar | firstName, lastName / PUT /api/v1/users/me/avatar | Visualizzati negli elenchi dei membri del team, nella cronologia delle revisioni dei modelli e nei log di audit di conformità (GET /api/v1/audit-log/export.csv). |
| Lingua dell'interfaccia | locale (en, de, es, fr, it, nl, pt) | Controlla il dizionario di traduzione dell'interfaccia della Dashboard indipendentemente dalle lingue del workspace o dei modelli di pass. |
| Modalità tema | theme (light, dark, system) | Mantiene lo schema di colori preferito su tutti i dispositivi e si sincronizza con i token CSS semantici di design. |
| Fuso orario di visualizzazione | timezone (identificativo IANA) | Formatta i timestamp delle attività nella Sua vista personale preservando l'allineamento del fuso orario del workspace per le aggregazioni analitiche. |
| Canali di notifica | Oggetto notifications | Attiva o disattiva gli avvisi email per il completamento delle importazioni batch, gli avvisi di scadenza dei certificati, le ricevute di fatturazione e le notifiche di sicurezza sugli accessi. |
Aggiornamento del profilo e delle preferenze tramite API
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"
}
Utilizzi PUT /api/v1/users/:userId/preferences (oppure GET /api/v1/users/me/settings) per aggiornare la lingua dell'interfaccia, il tema e i flag di notifica:
{
"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"
}
Configurazione dell'autenticazione a due fattori (2FA TOTP)
Passinstance supporta l'autenticazione a più fattori basata su password monouso temporizzate (TOTP) conforme allo standard RFC 6238 all'indirizzo /settings/account/two-factor-authentication, compatibile con 1Password, Google Authenticator, Authy e Apple Passwords. I workspace possono inoltre imporre l'obbligo della 2FA per i ruoli amministrativi tramite Membri del team e autorizzazioni.
-
1
Generazione del segreto e dell'URI QR (
POST /api/v1/auth/2fa/setup): restituisce un URI di provisioningotpauth://totp/crittografato e una chiave segreta base32 (GET /api/v1/auth/2fa/statusverifica lo stato corrente). -
2
Verifica e attivazione (
POST /api/v1/auth/2fa/verify+/api/v1/auth/2fa/enable): invii un codice valido a 6 cifre generato dall'app di autenticazione per attivare la 2FA e ricevere i codici di recupero di emergenza monouso (POST /api/v1/auth/2fa/regenerate-backup-codesconsente di ruotarli). -
3
Conservazione dei codici di recupero: conservi i codici di recupero generati in un luogo sicuro; ciascun codice può essere utilizzato una sola volta in caso di smarrimento del dispositivo mobile di autenticazione.
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"
]
}
Rotazione della password e gestione delle sessioni attive
In Account -> Autenticazione (/settings/account/authentication) e Sessioni (/settings/account/sessions), può ruotare la Sua password e ispezionare tutte le sessioni attualmente autenticate collegate al Suo account utente:
-
Rotazione della password (
POST /api/v1/users/change-password): richiede la verifica della password corrente (e del codice TOTP attivo se la 2FA è abilitata). La rotazione della password revoca automaticamente tutti gli altri refresh token attivi sui dispositivi secondari. -
Ispezione e revoca delle sessioni (
GET /api/v1/users/sessions,DELETE /api/v1/sessions/:sessionIdeDELETE /api/v1/sessions/others): mostra l'indirizzo IP della sessione attiva, loUser-Agentdel browser/sistema operativo, lo stato di attendibilità del dispositivo (/api/v1/sessions/trust-device) e il timestamp dell'ultima attività per consentire la disconnessione da remoto.
Documentazione correlata
-
Configuri i criteri di sicurezza a livello di workspace in Sicurezza dell'account e controllo degli accessi.
-
Imposti la valuta dell'organizzazione, l'indirizzo legale e la lingua predefinita in Impostazioni aziendali.
