O que este guia cobre
O PassZit é um gerenciador de senhas gratuito, de código aberto (AGPLv3) e auto-hospedado, com criptografia de ponta a ponta, feito pela MaxZit. É um único programa de servidor com um banco de dados PostgreSQL, um cofre web, extensões do navegador e uma linha de comando. Este guia descreve apenas o PassZit — não compara recursos nem preços de outros produtos — para que você possa compará-lo com o que o seu servidor faz hoje.
- Visão geral
- Instalação
- O modelo de criptografia
- Extensões do navegador
- Importar uma exportação no formato do Bitwarden
- Segundo fator, passkeys e códigos de uso único
- Backups e atualizações do servidor
- LDAP e login único
- Testar o PassZit ao lado do servidor atual
- Limites que convém conhecer
- Próximos passos
Visão geral
| Área | No PassZit | Fora do PassZit |
|---|---|---|
| Instalação | Imagens de VM (OVA, QCOW2, VHDX), ISO do appliance, script de instalação, pacotes deb/rpm; amd64 e arm64 | Não há imagem Docker |
| Criptografia | Argon2id no navegador, AES-256-GCM por item, X25519 para cofres compartilhados | O código do cofre web vem do servidor (as extensões trazem o próprio) |
| Clientes | Cofre web (instalável como app), extensões para navegadores Chromium e Firefox, linha de comando | Não há app móvel nativo, extensão para Safari nem cópia offline |
| Importação | JSON ou CSV do Bitwarden sem criptografia, além de navegadores, KeePass/KeePassXC, 1Password, LastPass, CSV | Nenhuma exportação criptografada de outros programas; do arquivo não vêm anexos, passkeys nem histórico de senhas |
| Login | Segundo fator obrigatório, chaves de segurança e passkeys, LDAP / Active Directory, OIDC e SAML | As extensões não usam login único |
| Operação | Backup diário criptografado do console com cópia SFTP, autoatualização assinada com reversão | — |
Instalação
O PassZit é um único programa, passzit-server, com um banco de dados PostgreSQL. Há quatro formas de instalá-lo, todas na página de download:
- Imagem de VM — OVA (VMware, VirtualBox), QCOW2 (Proxmox VE, KVM) ou VHDX (Hyper-V geração 1) com Debian, PostgreSQL e PassZit prontos. No console da VM, o usuário
pzadmintem um menu para a rede, o nome do servidor, o fuso horário, o token de configuração e as restaurações. Só as portas 22 e 8443 ficam abertas. - ISO do appliance — para uma VM nova ou um servidor físico; a instalação automática apaga o primeiro disco.
- Script de instalação no Debian 12+, Ubuntu 22.04+, AlmaLinux ou Rocky Linux 9+:
curl -fsSL https://github.com/Max-Zit/passzit/releases/latest/download/install.sh | sudo sh. Ele verifica a assinatura da versão, instala o PostgreSQL, cria um banco de dados com senha aleatória e mostra o endereço e o token de configuração.--dbusa um banco PostgreSQL existente. - Pacotes (deb, rpm) com um serviço systemd reforçado; defina
PASSZIT_DBem/etc/passzit/server.enve inicie opasszit-server.
O README pede 2 vCPU, 2 GB de RAM e um disco de 16 GB. O console escuta na porta HTTPS 8443 e só responde a redes privadas até você permitir outras em Definições → Rede e acesso. Não há imagem Docker; se você roda todo o resto em contêineres, use uma VM pequena com a imagem do appliance. A versão passo a passo está em Gerenciador de senhas auto-hospedado.
O modelo de criptografia
Conforme descrito na página de segurança e em docs/ARCHITECTURE.md do repositório:
- O navegador deriva uma chave mestra da senha mestra com Argon2id (64 MiB, 3 passagens por padrão; a política do cofre pode alterar memória, passagens e faixas).
- Dela saem uma chave de autenticação, que o servidor guarda só como hash argon2id, e uma chave de envelope que nunca sai do navegador e abre a chave de conta aleatória.
- Cada item — nome, usuário, senha, sites, notas, campos, pasta e histórico — é criptografado com AES-256-GCM. Arquivos anexados e a documentação dos itens também são criptografados no navegador.
- Um cofre compartilhado tem a própria chave, selada para a chave pública X25519 de cada membro. O PassZit mostra a impressão digital da chave na primeira vez que você compartilha com alguém e avisa quando uma chave confirmada muda; um cofre recebe uma nova chave quando alguém sai dele.
Contra o que o PassZit não protege, nas palavras dele: o JavaScript do cofre web vem do seu servidor, então quem controla totalmente o servidor poderia servir código alterado; quem entra em um cofre por meio de um grupo recebe acesso sem confirmação da impressão digital; um malware no computador de um usuário pode ler o que é digitado. As extensões do navegador trazem o próprio código, que o servidor não pode alterar. Ninguém pode redefinir uma senha mestra esquecida — só a chave de recuperação do usuário abre o cofre de novo.
Extensões do navegador
A extensão do PassZit está na Chrome Web Store (Chrome, Brave, Opera, Vivaldi), no Firefox Add-ons (Firefox 128 ou mais recente) e no Microsoft Edge Add-ons; os links estão na página de download. O servidor também a oferece em Extensões do navegador no cofre web, com Instalar com um clique para a loja do navegador em uso e pacotes próprios para instalação manual.
- Conexão: digite só o endereço do servidor e clique em Ligar com o cofre web; você entra no cofre web e confirma ali. O servidor pode rodar em uma porta própria, como a 8443. Ele precisa de um certificado em que o navegador confie — a extensão recusa o certificado autoassinado de um servidor novo (Definições → Certificado: o seu ou Let's Encrypt).
- Preenchimento: um login só é oferecido no próprio site (Public Suffix List), só em campos visíveis da página principal, nunca em frames de outros sites, e um login salvo para HTTPS não é oferecido em HTTP simples. Os códigos de uso único são preenchidos na página que os pede.
- Salvamento: depois que você ativa Oferecer guardar credenciais novas e alteradas, o ícone do PassZit mostra um número; o PassZit nunca mostra nada dentro da página web.
- Cartões e endereços preenchem formulários de pagamento e de entrega — só campos vazios, só em páginas HTTPS, só na página principal e, no caso de um cartão, depois de uma pergunta.
- Um único desbloqueio: o cofre web e a extensão do mesmo servidor desbloqueiam e bloqueiam juntos. Windows Hello, Touch ID ou o bloqueio de tela de um celular podem desbloquear o cofre web por meio de uma passkey (WebAuthn PRF).
Não disponível: uma extensão para Safari, login único na extensão (ela entra com a senha mestra e o código do autenticador) e o preenchimento de campos de pagamento que ficam no frame de um provedor de pagamentos.
Importar uma exportação no formato do Bitwarden
O importador do PassZit lê a exportação do Bitwarden sem criptografia, como .json ou .csv. Uma exportação criptografada é recusada com uma mensagem pedindo uma sem criptografia. O PassZit reconhece um arquivo pelo conteúdo, não pelo programa que o criou: um arquivo JSON com uma lista items é lido como formato do Bitwarden.
- Faça a exportação sem criptografia no seu programa atual.
- No cofre web do PassZit, escolha Ferramentas → Importar e selecione o arquivo. O arquivo é lido no navegador; o PassZit mostra o formato, o número de itens e pastas e quantos já estão no cofre.
- Escolha Manter as pastas do ficheiro ou uma pasta nova, deixe Ignorar itens que já estão no cofre ativado e importe.
- Exclua o arquivo exportado — ele contém todas as senhas sem criptografia.
Do formato JSON do Bitwarden, o PassZit leva os logins com seus sites, segredos de códigos de uso único e campos próprios (campos ocultos continuam ocultos), notas seguras, cartões, identidades, chaves SSH, pastas e favoritos. Não são transferidos: arquivos anexados (não fazem parte dos arquivos de exportação — anexe-os de novo), passkeys guardadas no arquivo (salve-as de novo com a extensão), o histórico de senhas de um item e qualquer agrupamento além de pastas. Cada usuário importa para o próprio cofre; itens para uma equipe são movidos depois pelo campo Cofre do editor de itens, um item por vez. Importações e exportações ficam registradas no registro de auditoria, com o número de itens, mas nunca o conteúdo deles.
Segundo fator, passkeys e códigos de uso único
- Login na conta: o login em dois fatores é obrigatório para todas as contas — um aplicativo autenticador (TOTP) com dez códigos de recuperação. Em A minha conta → Chaves de segurança e passkeys, uma chave de segurança (YubiKey, Titan …) ou uma passkey do dispositivo pode substituir o código do aplicativo no cofre web; as extensões continuam usando o código do aplicativo. Um administrador pode redefinir um segundo fator perdido; o cofre não é afetado.
- Passkeys de sites: com Usar o PassZit para chaves de acesso ativado, a extensão oferece Salvar no PassZit quando um site cria uma passkey e a guarda como item criptografado do cofre, utilizável em qualquer navegador com a extensão. O PassZit não envia o sinalizador “usuário verificado”, então um site que exige verificação recebe as passkeys do próprio navegador.
- Códigos de uso único para sites: um login pode guardar a Chave do autenticador (TOTP), colada ou lida de um QR code — no cofre web a partir de uma imagem, na extensão com Ler um código QR de autenticação nesta página. Quem abre o cofre passa a ter os dois fatores; para as contas mais importantes, o guia do PassZit sugere um aplicativo autenticador separado.
Backups e atualizações do servidor
Definições → Backup da consola grava um backup todos os dias e sob demanda (Fazer backup agora) em /var/lib/passzit/backups: o banco de dados com todos os cofres, a chave secreta do servidor e o certificado do console. Os backups são sempre criptografados com uma frase-senha que você define, e cada um pode ser copiado para uma pasta SFTP em outro servidor. Restaure com o menu do appliance ou com passzit-server -restore; a restauração substitui o banco de dados inteiro de uma só vez. Se você mesmo fizer o backup, leve o banco de dados e o secret.key — os segredos do próprio servidor, como os segundos fatores, precisam dele.
Definições → Atualizações e servidor instala apenas versões assinadas: faz backup do banco de dados e do programa, instala a atualização e restaura sozinho a versão anterior se o servidor não voltar. Ali se pode configurar a instalação automática em um horário escolhido e um canal Testing para versões candidatas.
Os usuários também podem guardar uma cópia do próprio cofre: Ferramentas → Exportar → Ficheiro PassZit cifrado (recomendado), protegido com uma senha de sua escolha.
LDAP e login único
Definições → Início de sessão da empresa acrescenta o controle de quem pode entrar; a senha mestra continua sempre, porque é a chave do cofre, e as contas continuam sendo criadas só por convite.
- Login único com OpenID Connect (Microsoft Entra ID, Google, Okta, Keycloak …) ou SAML 2.0 (ADFS, Entra ID, Okta …) para o cofre web.
- Active Directory / LDAP: a cada login, inclusive das extensões e da linha de comando, o PassZit procura o endereço com uma conta de serviço; contas ausentes ou desativadas não conseguem entrar. Procurar testa as configurações.
- Ambos podem manter os grupos do PassZit sincronizados com os grupos da empresa de mesmo nome, então o acesso aos cofres compartilhados segue o diretório.
Não há provisionamento SCIM nem cadastro sem convite. Como funcionam cofres compartilhados, grupos e permissões está em Compartilhar senhas com a equipe.
Testar o PassZit ao lado do servidor atual
- Mantenha o servidor atual funcionando. Importe o appliance do PassZit como uma VM pequena com nome DNS próprio e dê a ela um certificado confiável antes de testar a extensão.
- Use contas de teste primeiro. Convide duas ou três pessoas, crie um cofre compartilhado e um grupo, e teste as permissões, a verificação da impressão digital e a remoção de alguém do cofre.
- Importe uma cópia, não tudo. Faça uma exportação sem criptografia de uma conta de teste, importe-a, compare a contagem de itens e confira alguns cartões, identidades, chaves SSH e códigos de uso único. Exclua o arquivo exportado.
- Instale as duas extensões só onde você testa. A oferta do PassZit para salvar logins fica desativada até você ativá-la, assim como Usar o PassZit para chaves de acesso, para que as duas extensões não perguntem ao mesmo tempo enquanto você compara.
- Teste o backup do servidor. Execute Fazer backup agora, restaure o backup em uma segunda VM de teste e entre nela.
- Repasse os limites abaixo com as pessoas que vão usá-lo, principalmente o uso no celular e o login da extensão.
Limites que convém conhecer
- O PassZit está em desenvolvimento ativo: a primeira versão pública foi a 0.9.0, em novembro de 2026, e novas versões saem com frequência.
- Não há app móvel nativo nem extensão para Safari (ambos planejados). O cofre web pode ser adicionado à tela inicial de um celular, mas não guarda nada para uso offline.
- Não há imagem Docker; instale com uma imagem, o script ou os pacotes.
- O importador só lê arquivos de exportação sem criptografia; anexos, passkeys e histórico de senhas do arquivo não são transferidos.
- As extensões precisam de um certificado confiável e entram com a senha mestra e o código do autenticador, não com login único.
- Uma senha mestra esquecida sem chave de recuperação não pode ser recuperada por ninguém.
- A interface está em 14 idiomas; o guia do usuário integrado está em inglês e sérvio.
Próximos passos
Baixe o PassZit, leia sobre todos os recursos e o modelo de segurança, ou comece pelos guias Gerenciador de senhas auto-hospedado e Compartilhar senhas com a equipe. Equipes que estão saindo de um serviço hospedado encontram mais em Uma alternativa auto-hospedada ao 1Password para equipes. Perguntas são bem-vindas no GitHub Discussions (somente em inglês); empresas podem contratar suporte comercial da MaxZit (somente em inglês).
Bitwarden é uma marca do seu proprietário; Vaultwarden é o nome de um projeto independente. O PassZit e a MaxZit não são afiliados, endossados nem ligados a nenhum dos dois. Os nomes são usados aqui apenas para descrever o que as pessoas pesquisam e qual formato de exportação o PassZit consegue importar.