> A revisão linguística desta tradução está em curso. Em caso de dúvida, consulte o [original em inglês](https://www.sm.ch-j.eu/docs/i18n/en/biometric-unlock.md).

# Autenticação opcional do sistema e bloqueio Cofre

Crie ou desbloqueie o Cofre com sua senha mestra primeiro. Abra o **Settings → Security**, verifique o status do provedor e ative o desbloqueio biométrico. A inscrição solicita autenticação de sistema nova. Depois, a sobreposição de login oferece o desbloqueio Touch ID, Windows Hello ou impressão digital ao lado do formulário de senha mestre. **Desativar e remover inscrição** remove a chave em cache deste aplicativo, nunca as impressões digitais registradas do sistema operacional.

Mantenha a senha mestra: cancelamento, tempo limite, hardware / chave não disponível e inscrição invalidada todos exigem fallback senha. O registro biométrico é local para este usuário, dispositivo e Cofre. Não é um mecanismo de recuperação ou um cópia de segurança. A redefinição do Cofre revoga a inscrição e exclui os perfis criptografados existentes e as impressões digitais do host somente após a confirmação existente do `SMAZAT`.

| Platform | Autenticação e armazenamento | Requisitos e limites |
| --- | --- | --- |
|  macOS  Apple Silicon  | Nativo LocalAutenticação / Touch ID; Security.framework Keychain item com `biometryCurrentSet` e `WhenUnlockedThisDeviceOnly`  | Inscrito Touch ID, sensor disponível e um login utilizável Keychain. As alterações de impressão digital invalidam o item. Use a assinatura estável de ID do desenvolvedor para produção atualização; A assinatura alfa ad hoc pode interromper a confiança do Keychain e o rastreamento de permissões da rede local. |
|  Windows  x64  | WinRT nativo Windows Hello interop desktop anexado ao HWND principal; usuário atual DPAPI chave criptografada em Windows Credential Manager  | Configurado Olá impressão digital, rosto **ou PIN**. Isso é um desbloqueio de conveniência: a aprovação do Hello é imposta pelo aplicativo, enquanto o próprio DPAPI não é fechado biométrico. Outro código em execução como o mesmo usuário pode descriptografar o credenciais. |
|  Ubuntu  x64  | A impressão digital do usuário atual fprintd D-Bus; libsecreto explícito / Secret Service  credenciais armazenamento | Leitor suportado, impressões digitais inscritas, executando o desktop Secret Service e chaveiro padrão. Desbloqueio de conveniência: o chaveiro credenciais não está vinculado criptograficamente à verificação da impressão digital. Nenhum retorno `basic_text` ou de arquivo de texto simples. |

Ligado Ubuntu Os pacotes de tempo de execução opcionais são `python3-gi`, `gir1.2-secret-1`, `gnome-keyring` (ou outro compatível) Secret Service) e `fprintd`. Instale pacotes ausentes usando o gerenciador de pacotes normais do sistema operacional e, em seguida, registre uma impressão digital nas configurações do sistema operacional. Autenticação usa o usuário atual e não requer root ou alterar PAM. Uma sessão SSH sem um keyring de desktop não está disponível; ela não armazena silenciosamente uma chave em outro lugar.

## Regras de bloqueio

O bloqueio automático está desligado para instalações existentes. Habilitando ele seleciona **15 minutos** por padrão; os valores suportados são Nunca, 1, 5, 10, 15, 30 e 60 minutos. A entrada de teclado e mouse nas janelas do aplicativo conta como atividade; a saída SSH recebida não. O bloqueio de foco opcional trata as janelas de plug-in do aplicativo como parte do aplicativo e permite que um prompt de autenticação do sistema em andamento seja concluído. Alterar essas regras requer a senha mestra.

**Cada bloqueio Cofre, incluindo inatividade e bloqueio de foco, desconecta sessões SSH ativas, fecha plugins e pára diagnósticos.** Salvar edições remotas antes de bloquear. Isso preserva o comportamento de bloqueio manual existente; nenhum SSH credenciais permanece disponível para plugins de plano de fundo após um bloqueio.

A política opcional de operação sensível solicita autenticação do sistema para exclusão de perfil, instalação/remoção de plug-ins, lançamento do instalador e redefinição de um Cofre desbloqueado. Comandos remotos de terminal e edições de arquivos de plug-in estão fora desta política. A política não substitui a autorização do servidor SSH. Se o provedor parar de funcionar, desbloqueie com a senha mestra e altere a política usando essa senha. Redefinir permanece disponível a partir da tela de recuperação bloqueada após sua confirmação destrutiva.

## Cofre e design IPC

O v1 Cofre existente permanece AES-256-GCM com scrypt; a inscrição não reescreve seus arquivos ou altera seu esquema. Apenas uma cópia da sua chave ** derivada do 32-byte ** vai para o armazenamento do OS credenciais. A senha mestra do texto simples nunca é armazenada. Os metadados de registro local contêm ID credenciais aleatório, provedor e uma ligação SHA-256 aos metadados imutáveis do Cofre. Uma chave recuperada deve passar pela descriptografia autenticada antes que uma sessão seja aberta. Os buffers do processo principal são limpos após o uso; as cadeias de protocolo nativas são memória de processo transitória, não uma reivindicação de eliminação completa da memória em tempos de execução gerenciados.

O ajudante se comunica através de tubos de stdin / stdout privados limitados, não aceita comandos shell, tem timeouts de autenticação e retorna códigos de erro higienizados. Os ajudantes são empacotados fora da ASAR no `resources/biometrics`; eles são executáveis nativos autônomos, portanto nenhum módulo nativo do Electron ABI é necessário. O ajudante Linux usa o sistema Python e GI. Objetos nativos e chaves derivadas nunca cruzam a ponte renderizador/plugin. O IPC biométrico valida a janela principal ao vivo e seu quadro principal; os plugins não podem invocá-lo. O bloqueio explícito cancela o trabalho de desbloqueio biométrico e de senha pendentes, para que a aprovação tardia não possa reabrir o Cofre. A remoção da inscrição revoga sua vinculação local, mesmo que a loja do sistema operacional esteja offline; uma loja inacessível pode reter um credenciais órfão inutilizável.

## Construção e verificação

`npm run biometrics:build` prepara o ajudante da plataforma host; a preparação para início e lançamento de desenvolvimento invoca-a automaticamente. macOS requer SDK Swift/Apple com segurança e autenticação local; Windows exige ferramentas de compilação do Visual Studio C++, SDK Windows e C++/WinRT; Linux copia o ajudante Python. Não são adicionadas novas dependências de npm. Construa nativamente em cada sistema operacional de destino. O ajudante macOS está incluído na assinatura de pacote recursivo; ele não precisa de direito ao Sandbox App porque este aplicativo para desktop não é sandboxed. A distribuição macOS ainda requer assinatura e notação de ID do desenvolvedor, independentemente da versão OpenPGP assinatura.

Execute `npm test`, `npm run test:biometrics:ui` e `npm run test:diagnostics:ui`. Testes de nó biométrico e o teste isolado de fumaça da IU **adaptador de sistema operacional simulado** para cobrir o sucesso, rejeição/cancelamento, chaves erradas, falta de hardware/inscrição, reset, timeout e resultados atrasados, indisponível Linux keyrings, OS credenciais falhas, Windows  PIN- respostas aprovadas, macOS mudanças de inscrição, existentes Cofre compatibilidade, isolamento IPC e SSH Limpeza. Isso não estabelece autenticação de hardware bem-sucedida.

A compilação nativa foi verificada em macOS arm64 e Windows x64. macOS reporta Touch ID disponível; a VM Windows relata Olá indisponíveis. A inscrição do Fingerprint/face/PIN, a recuperação real da chave protegida, o cancelamento da caixa de diálogo do sistema operacional e a invalidação da alteração da inscrição ainda exigem testes interativos de hardware em cada sistema suportado. O ajudante do Linux também deve ser testado em uma área de trabalho com um leitor fprintd compatível; uma VM sem cabeça não pode estabelecer essa verificação.

Referências da plataforma: [Controle de acesso biométrico da Apple](https://developer.apple.com/documentation/security/secaccesscontrolcreateflags/biometrycurrentset), [Windows desktop Olá interop](https://learn.microsoft.com/en-us/windows/win32/api/userconsentverifierinterop/nf-userconsentverifierinterop-iuserconsentverifierinterop-requestverificationforwindowasync), [fprintd ciclo de vida do dispositivo](https://fprint.freedesktop.org/fprintd-dev/Device.html), [Secret Service especificação](https://specifications.freedesktop.org/secret-service/latest/).

## macOS Acesso à rede local SSH

Se todos os perfis SSH locais falharem com o `connect EHOSTUNREACH`, mas a mesma conexão funcionar no Terminal, verifique as configurações do **System → Privacidade e segurança → Rede local → CH-J Server Manager**. Se já estiver ativado, alterne sua permissão e reinicie. Verifique também o roteamento, Wi-Fi/Ethernet e VPN: o erro por si só não é prova de uma negação de privacidade. Não reinicie as impressões digitais Cofre ou descarte as confiáveis do SSH para este erro.

O aplicativo declara `NSLocalNetworkUsageDescription` e fornece orientação localizada para erros de permissão / rota da rede macOS. Ele não pode conceder a si mesmo permissão. A Apple recomenda uma identidade de assinatura emitida pela Apple para que o macOS possa rastrear a privacidade da rede de forma confiável em todas as compilações; as compilações alfa ad hoc atuais mantêm essa limitação. Ver [Guia de privacidade da rede local da Apple](https://developer.apple.com/documentation/technotes/tn3179-understanding-local-network-privacy).

## ícone de aplicação Ubuntu

Os pacotes Debian instalam o ícone CH-J existente nos tamanhos padrão de hicolor (16–512 px), com uma entrada de área de trabalho correspondente e classe de janela Electron. A janela principal também recebe o ícone quando recriada. Depois de atualizar um lançador antigo já fixado, desligue-o e pixe o aplicativo recém-instalado; um logout/login da área de trabalho pode atualizar um cache do lançador GNOME obsoleto.