Skip to content
Guida del Centro assistenza · Impostazioni account e workspace
4 min di letturaVerificato 2026-11-16

Profilo e preferenze

Aggiorna credenziali personali, lingua dell'interfaccia, fuso orario e preferenze di notifica.

In questa guida

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

FLUSSO ARCHITETTURALE
ARCHITETTURA INTERATTIVA
PROFILO OPERATORE, 2FA TOTP E GESTIONE DELLE SESSIONI
FASE 01 LIVELLO BROWSER / CLIENT OPERATORE
UI Profilo e Lingua
(/settings/account/*)
App di autenticazione
(RFC 6238 TOTP 6 cifre)
Gestore sessioni
dispositivi attivi
FASE 02 CONTROLLER UTENTI, AUTH E SESSIONI (API)
Identità e preferenze
GET/api/v1/users/me/profile
PUT/api/v1/users/me/profile
`PUT/api/v1/users/:id/preferences
Tema: light | dark | system
Sicurezza e controllo sessioni
POST/api/v1/auth/2fa/setup
POST/api/v1/auth/2fa/verify
POST/api/v1/users/change-passw
DELETE/api/v1/sessions/:id
FASE 03 LIVELLO DI PERSISTENZA E AUDIT DI SICUREZZA
Record User (Segreto TOTP crittografato, hash password Bcrypt, codici backup)
Archivio Refresh Token in-memory cache (Invalidazione immediata al cambio password)

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:

ImpostazioneCampo APIComportamento e ambito
Nome visualizzato e avatarfirstName, lastName / PUT /api/v1/users/me/avatarVisualizzati 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'interfaccialocale (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à tematheme (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 visualizzazionetimezone (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 notificaOggetto notificationsAttiva 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

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"
}

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:

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"
}

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. 1
    Generazione del segreto e dell'URI QR (POST /api/v1/auth/2fa/setup): restituisce un URI di provisioning otpauth://totp/ crittografato e una chiave segreta base32 (GET /api/v1/auth/2fa/status verifica lo stato corrente).
  2. 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-codes consente di ruotarli).
  3. 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.
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"
  ]
}

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/:sessionId e DELETE /api/v1/sessions/others): mostra l'indirizzo IP della sessione attiva, lo User-Agent del 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

Pronto a lanciare il tuo primo programma di carte Wallet?

Crea il tuo workspace, configura il modello e testa una carta reale in Apple Wallet e Google Wallet prima di scalare.