Di cosa tratta questa guida
PassZit è un password manager gratuito, open source (AGPLv3) e self-hosted con crittografia end-to-end, sviluppato da MaxZit. È un unico programma server con un database PostgreSQL, una cassaforte web, estensioni del browser e una riga di comando. Questa guida descrive solo PassZit — non confronta funzionalità o prezzi di altri prodotti — così puoi verificarlo rispetto a ciò che fa oggi il tuo server.
In sintesi
| Ambito | In PassZit | Non in PassZit |
|---|---|---|
| Installazione | Immagini VM (OVA, QCOW2, VHDX), ISO dell’appliance, script di installazione, pacchetti deb/rpm; amd64 e arm64 | Nessuna immagine Docker |
| Crittografia | Argon2id nel browser, AES-256-GCM per elemento, X25519 per le casseforti condivise | Il codice della cassaforte web arriva dal server (le estensioni portano il proprio) |
| Client | Cassaforte web (installabile come app), estensioni per i browser Chromium e Firefox, riga di comando | Nessuna app mobile nativa, nessuna estensione per Safari, nessuna copia offline |
| Importazione | JSON o CSV di Bitwarden non cifrato, oltre a browser, KeePass/KeePassXC, 1Password, LastPass, CSV | Nessuna esportazione cifrata di altri programmi; dal file nessun allegato, passkey o cronologia delle password |
| Accesso | Secondo fattore obbligatorio, chiavi di sicurezza e passkey, LDAP / Active Directory, OIDC e SAML | Le estensioni non usano il single sign-on |
| Gestione | Backup giornaliero cifrato della console con copia SFTP, aggiornamento automatico firmato con rollback | — |
Installazione
PassZit è un unico programma, passzit-server, con un database PostgreSQL. Ci sono quattro modi per installarlo, tutti nella pagina di download:
- Immagine VM — OVA (VMware, VirtualBox), QCOW2 (Proxmox VE, KVM) o VHDX (Hyper-V generazione 1) con Debian, PostgreSQL e PassZit pronti. Sulla console della VM l’utente
pzadmintrova un menu per la rete, il nome del server, il fuso orario, il token di configurazione e i ripristini. Sono aperte solo le porte 22 e 8443. - ISO dell’appliance — per una nuova VM o un server fisico; l’installazione automatica cancella il primo disco.
- Script di installazione su Debian 12+, Ubuntu 22.04+, AlmaLinux o Rocky Linux 9+:
curl -fsSL https://github.com/Max-Zit/passzit/releases/latest/download/install.sh | sudo sh. Verifica la firma della release, installa PostgreSQL, crea un database con una password casuale e stampa l’indirizzo e il token di configurazione.--dbusa un database PostgreSQL esistente. - Pacchetti (deb, rpm) con un servizio systemd protetto; imposta
PASSZIT_DBin/etc/passzit/server.enve avviapasszit-server.
Il README chiede 2 vCPU, 2 GB di RAM e un disco da 16 GB. La console ascolta sulla porta HTTPS 8443 e risponde solo alle reti private finché non ne consenti altre in Impostazioni → Rete e accesso. Non esiste un’immagine Docker; se tutto il resto gira in container, usa una piccola VM con l’immagine dell’appliance. La versione passo passo è in Password manager self-hosted.
Il modello di crittografia
Come descritto nella pagina sulla sicurezza e in docs/ARCHITECTURE.md del repository:
- Il browser deriva una chiave master dalla password principale con Argon2id (64 MiB, 3 passaggi come impostazione predefinita; i criteri della cassaforte possono cambiare memoria, passaggi e corsie).
- Da essa nascono una chiave di autenticazione, che il server conserva solo come hash argon2id, e una chiave di wrapping che non lascia mai il browser e apre la chiave casuale dell’account.
- Ogni elemento — nome, nome utente, password, siti web, note, campi, cartella e cronologia — è cifrato con AES-256-GCM. Anche i file allegati e la documentazione degli elementi sono cifrati nel browser.
- Una cassaforte condivisa ha una propria chiave, sigillata per la chiave pubblica X25519 di ogni membro. PassZit mostra l’impronta della chiave la prima volta che condividi con qualcuno e avvisa quando una chiave confermata cambia; una cassaforte riceve una nuova chiave quando qualcuno la lascia.
Ciò da cui PassZit non protegge, con parole sue: il JavaScript della cassaforte web arriva dal tuo server, quindi chi controlla completamente il server potrebbe servire codice modificato; chi entra in una cassaforte tramite un gruppo riceve l’accesso senza conferma dell’impronta; un malware sul computer di un utente può leggere ciò che viene digitato. Le estensioni del browser portano il proprio codice, che il server non può modificare. Nessuno può reimpostare una password principale dimenticata — solo la chiave di recupero dell’utente riapre la cassaforte.
Estensioni del browser
L’estensione di PassZit è nel Chrome Web Store (Chrome, Brave, Opera, Vivaldi), in Firefox Add-ons (Firefox 128 o successivo) e in Microsoft Edge Add-ons; i link sono nella pagina di download. Il server la offre anche in Estensioni del browser nella cassaforte web, con Installa con un clic per lo store del browser in uso e i propri pacchetti per l’installazione manuale.
- Collegamento: inserisci solo l’indirizzo del server e fai clic su Collega con la cassaforte web; accedi nella cassaforte web e confermi lì. Il server può girare su una propria porta, come la 8443. Serve un certificato di cui il browser si fidi — l’estensione rifiuta il certificato autofirmato di un server nuovo (Impostazioni → Certificato: uno tuo o Let's Encrypt).
- Compilazione: un accesso viene proposto solo sul proprio sito web (Public Suffix List), solo nei campi visibili della pagina principale, mai nei frame di altri siti, e un accesso salvato per HTTPS non viene proposto su HTTP semplice. I codici monouso vengono compilati nella pagina che li chiede.
- Salvataggio: dopo aver attivato Proponi di salvare credenziali nuove e modificate, l’icona di PassZit mostra un numero; PassZit non mostra mai nulla dentro la pagina web.
- Carte e indirizzi compilano moduli di pagamento e di spedizione — solo campi vuoti, solo su pagine HTTPS, solo nella pagina principale, e per una carta dopo una domanda.
- Un solo sblocco: la cassaforte web e l’estensione dello stesso server si sbloccano e si bloccano insieme. Windows Hello, Touch ID o il blocco schermo di un telefono possono sbloccare la cassaforte web tramite una passkey (WebAuthn PRF).
Non disponibili: un’estensione per Safari, il single sign-on nell’estensione (accede con la password principale e il codice dell’app di autenticazione) e la compilazione di campi di pagamento che si trovano nel frame di un fornitore di pagamenti.
Importare un’esportazione in formato Bitwarden
L’importatore di PassZit legge l’esportazione di Bitwarden non cifrata, come .json o .csv. Un’esportazione cifrata viene rifiutata con un messaggio che ne chiede una non cifrata. PassZit riconosce un file dal suo contenuto, non dal programma che l’ha creato: un file JSON con un elenco items viene letto come formato Bitwarden.
- Crea l’esportazione non cifrata nel tuo programma attuale.
- Nella cassaforte web di PassZit scegli Strumenti → Importa e seleziona il file. Il file viene letto nel browser; PassZit mostra il formato, il numero di elementi e cartelle e quanti sono già nella cassaforte.
- Scegli Mantieni le cartelle del file o una nuova cartella, lascia attivo Salta gli elementi già presenti nella cassaforte e importa.
- Elimina il file esportato — contiene ogni password in chiaro.
Dal formato JSON di Bitwarden PassZit prende gli accessi con i loro siti web, i segreti dei codici monouso e i campi personalizzati (i campi nascosti restano nascosti), le note sicure, le carte, le identità, le chiavi SSH, le cartelle e i preferiti. Non vengono trasferiti: i file allegati (non fanno parte dei file di esportazione — allegali di nuovo), le passkey salvate nel file (salvale di nuovo con l’estensione), la cronologia delle password di un elemento e qualsiasi raggruppamento diverso dalle cartelle. Ogni utente importa nella propria cassaforte; gli elementi per un team si spostano poi con il campo Cassaforte dell’editor dell’elemento, un elemento alla volta. Importazioni ed esportazioni vengono annotate nel registro di audit, con il numero di elementi ma mai il loro contenuto.
Secondo fattore, passkey e codici monouso
- Accesso all’account: l’accesso a due fattori è obbligatorio per ogni account — un’app di autenticazione (TOTP) con dieci codici di recupero. In Il mio account → Chiavi di sicurezza e passkey una chiave di sicurezza (YubiKey, Titan …) o una passkey del dispositivo può sostituire il codice dell’app nella cassaforte web; le estensioni usano comunque il codice dell’app. Un amministratore può reimpostare un secondo fattore perso; la cassaforte non ne è toccata.
- Passkey dei siti web: con Usa PassZit per le passkey attivo, l’estensione propone Salva in PassZit quando un sito web crea una passkey e la conserva come elemento cifrato della cassaforte, utilizzabile in ogni browser con l’estensione. PassZit non invia un flag «utente verificato», quindi un sito web che richiede la verifica riceve le passkey del browser stesso.
- Codici monouso per i siti web: un accesso può contenere la Chiave di autenticazione (TOTP), incollata o letta da un codice QR — nella cassaforte web da un’immagine, nell’estensione con Leggi un codice QR di autenticazione in questa pagina. Chi apre la cassaforte ha allora entrambi i fattori; per gli account più importanti la guida di PassZit suggerisce un’app di autenticazione separata.
Backup e aggiornamenti del server
Impostazioni → Backup della console scrive un backup ogni giorno e su richiesta (Backup ora) in /var/lib/passzit/backups: il database con tutte le casseforti, la chiave segreta del server e il certificato della console. I backup sono sempre cifrati con una passphrase che scegli tu, e ognuno può essere copiato in una cartella SFTP su un altro server. Il ripristino si fa con il menu dell’appliance o con passzit-server -restore; il ripristino sostituisce l’intero database in un solo passo. Se invece fai il backup da solo, prendi il database e secret.key — i segreti propri del server, come i secondi fattori, ne hanno bisogno.
Impostazioni → Aggiornamenti e server installa solo release firmate: fa un backup del database e del programma, installa l’aggiornamento e rimette da sola la versione precedente se il server non ritorna. Lì si possono impostare l’installazione automatica in un’ora scelta e un canale Testing per le release candidate.
Gli utenti possono anche tenere una copia della propria cassaforte: Strumenti → Esporta → File PassZit cifrato (consigliato), protetto con una password a loro scelta.
LDAP e single sign-on
Impostazioni → Accesso aziendale aggiunge il controllo su chi può accedere; la password principale resta sempre, perché è la chiave della cassaforte, e gli account si creano comunque solo su invito.
- Single sign-on con OpenID Connect (Microsoft Entra ID, Google, Okta, Keycloak …) o SAML 2.0 (ADFS, Entra ID, Okta …) per la cassaforte web.
- Active Directory / LDAP: a ogni accesso, anche delle estensioni e della riga di comando, PassZit cerca l’indirizzo con un account di servizio; gli account mancanti o disattivati non possono accedere. Cerca prova le impostazioni.
- Entrambi possono allineare i gruppi di PassZit ai gruppi aziendali con lo stesso nome, così l’accesso alle casseforti condivise segue la directory.
Non c’è provisioning SCIM e nessuna registrazione senza invito. Come funzionano casseforti condivise, gruppi e permessi lo spiega Condividere le password con il team.
Provare PassZit accanto al server attuale
- Lascia in funzione il server attuale. Importa l’appliance di PassZit come piccola VM con un proprio nome DNS e dalle un certificato attendibile prima di provare l’estensione.
- Usa prima account di prova. Invita due o tre persone, crea una cassaforte condivisa e un gruppo, e prova i permessi, il controllo dell’impronta e la rimozione di qualcuno dalla cassaforte.
- Importa una copia, non tutto. Crea un’esportazione non cifrata di un account di prova, importala, confronta il numero di elementi e controlla alcune carte, identità, chiavi SSH e codici monouso. Elimina il file esportato.
- Installa entrambe le estensioni solo dove fai le prove. La proposta di PassZit di salvare gli accessi resta disattivata finché non la attivi, e così anche Usa PassZit per le passkey, quindi le due estensioni non chiedono entrambe mentre confronti.
- Prova il backup del server. Esegui Backup ora, ripristina il backup su una seconda VM di prova e accedi lì.
- Passa in rassegna i limiti qui sotto con le persone che lo useranno, in particolare l’uso da mobile e l’accesso dell’estensione.
Limiti da conoscere
- PassZit è in sviluppo attivo: la prima release pubblica è stata la 0.9.0 a novembre 2026, e nuove versioni escono spesso.
- Nessuna app mobile nativa e nessuna estensione per Safari (entrambe previste). La cassaforte web si può aggiungere alla schermata Home di un telefono, ma non conserva nulla per l’uso offline.
- Nessuna immagine Docker; installa con un’immagine, lo script o i pacchetti.
- L’importatore legge solo file di esportazione non cifrati; allegati, passkey e cronologia delle password nel file non vengono trasferiti.
- Le estensioni richiedono un certificato attendibile e accedono con la password principale e il codice dell’app di autenticazione, non con il single sign-on.
- Una password principale dimenticata senza chiave di recupero non può essere recuperata da nessuno.
- L’interfaccia è in 14 lingue; la guida utente integrata è in inglese e serbo.
Prossimi passi
Scarica PassZit, leggi tutte le funzionalità e il modello di sicurezza, oppure inizia con le guide Password manager self-hosted e Condividere le password con il team. I team che lasciano un servizio in hosting trovano di più in Un’alternativa self-hosted a 1Password per i team. Le domande sono benvenute in GitHub Discussions (solo in inglese); le aziende possono ottenere supporto commerciale da MaxZit (solo in inglese).
Bitwarden è un marchio del rispettivo titolare; Vaultwarden è il nome di un progetto indipendente. PassZit e MaxZit non sono affiliati, approvati o collegati a nessuno dei due. I nomi sono usati qui solo per descrivere ciò che le persone cercano e quale formato di esportazione PassZit può importare.