> Denne oversættelse er under sproglig gennemgang. Sammenlign uklare afsnit med den [engelske original](https://www.sm.ch-j.eu/docs/i18n/en/biometric-unlock.md).

# Valgfri systemgodkendelse og låsning af boks

Opret eller lås krypten op med sit master password først. Åbn **Settings → Security**, tjek udbyderstatus og aktiver biometriske låse op. Tilmeldingen kræver ny godkendelse af systemet. Bagefter login overlay tilbyder Touch ID, Windows Hej eller fingeraftryk låse op sammen med master-password formular. **Disable og fjerne tilmelding** fjerner denne applikations cachede nøgle, aldrig operativsystemets registrerede fingeraftryk.

Hold hovedadgangskoden: annullering, timeout, utilgængelig hardware / keyring og ugyldig tilmelding alle kræver adgangskode fallback. Biometrisk tilmelding er lokal for denne bruger, enhed og Vault. Det er ikke en inddrivelsesmekanisme eller en backup. Nulstilling af Vault tilbagekalder tilmelding og sletter først eksisterende krypterede profiler og værtsfingeraftryk efter den eksisterende `SMAZAT`-bekræftelse.

| Platform | Autentificering og lagring | Krav og grænser |
| --- | --- | --- |
|  macOS  Apple Silicon  | Native LocalAuthentication / Touch ID; Security.framework Keychain element med `biometryCurrentSet` og `WhenUnlockedThisDeviceOnly`  | Indrullede Touch ID, tilgængelig sensor og en brugbar login keychain. Fingeraftryksændringer ugyldiggør punktet. Brug stabil Developer ID-signering til produktionsopdateringer; ad hoc alfa-signatur kan forstyrre keychain-tillid og sporing af lokale netværkstilladelser. |
|  Windows  x64  | Native WinRT Windows Hej desktop interop knyttet til den vigtigste HWND; nuværende bruger DPAPI krypteret nøgle i Windows Credential Manager | Konfigureret Hello fingeraftryk, ansigt **eller PIN**. Dette er bekvemmelighed låse: Hej godkendelse håndhæves af appen, mens DPAPI selv ikke er biometrisk gated. Andre kode kører som den samme bruger kan dekryptere credential. |
|  Ubuntu  x64  | Nuværende brugers tilmeldte fingeraftryk via fprinted D-Bus; eksplicit libsecret / Secret Service legitimationsoplysninger opbevaring | Understøttet læser, indskrevet fingeraftryk, kører desktop Secret Service og standard nøglering. Komfort låses op: nøglering credential er ikke kryptografisk bundet til fingeraftryk verifikation. Ingen `basic_text` eller plaintext-fil fallback. |

Til Ubuntu de valgfrie runtime pakker er `python3-gi`, `gir1.2-secret-1`, `gnome-keyring` (eller en anden kompatibel Secret Service) og `fprintd`. Installer manglende pakker ved hjælp af den normale OS-pakkehåndtering, og tilmeld derefter et fingeraftryk i OS-indstillinger. Autentificering bruger den nuværende bruger og kræver ikke rod eller ændre PAM. En hovedløs SSH session uden en desktop keyring rapporter utilgængelige; det gemmer ikke lydløst en nøgle andre steder.

## Låseregler

Automatisk låsning er slukket for eksisterende installationer. Aktiverer den markerer **15 minutter** som standard; understøttede værdier er aldrig, 1, 5, 10, 15, 30 og 60 minutter. Tastatur og mus input i applikationsvinduer tæller som aktivitet; indgående SSH output gør ikke. Valgfri fokus låsning behandler programmets plugin vinduer som en del af appen og giver mulighed for en in-progress system autentificering prompt til at afslutte. Ændring af disse regler kræver master password.

**Hver Vault lås, herunder inaktivitet og fokus låsning, afbryder aktive SSH sessioner, lukker plugins og stopper diagnostik.** Gem fjernredigeringer før låsning. Dette bevarer den eksisterende manual-lock adfærd; ingen SSH legitimationsoplysninger forbliver tilgængelige for baggrund plugins efter en lås.

Den valgfri følsomme-operation politik anmoder om frisk systemgodkendelse til profil sletning, plugin installation / fjernelse, installationsprogrammet lancering og nulstilling af en ulåst Vault. Fjernterminalkommandoer og plugin-filredigering er uden for denne politik. Politikken erstatter ikke SSH servergodkendelse. Hvis udbyderen holder op med at arbejde, skal du låse op med master passwordet og ændre politikken ved hjælp af denne adgangskode. Nulstil forbliver tilgængelig fra den låste opsving skærm efter sin destruktive bekræftelse.

## Vault og IPC-design

Den eksisterende v1 Vault forbliver AES-256-GCM med kryptere; tilmelding ikke omskrive sine filer eller ændre sin skema. Kun en kopi af sin ** afledt 32-byte key** går til OS legitimationsoplysninger opbevaring. Den almindelige tekst master password er aldrig gemt. Lokal tilmelding metadata indeholder tilfældige legitimationsoplysninger ID, udbyder og en SHA-256 bindende for Vaults uforanderlige metadata. En gendannet nøgle skal passere autentificeret dekryptering, før en session åbnes. Main-proces buffere ryddes efter brug; indfødte protokolstrenge er forbigående proceshukommelse, ikke en påstand om fuldstændig hukommelse sletning i styrede runtimes.

Hjælperen kommunikerer gennem afgrænset private stdin/stdout rør, accepterer ingen shell kommandoer, har godkendelse timeouts og returnerer sanitized fejlkoder. Hjælpere er pakket uden ASAR i `resources/biometrics`; de er standalone indfødte eksekverbare, så ingen Electron ABI native modul er påkrævet. Linux hjælper bruger systemet Python og GI. Indfødte objekter og afledte nøgler aldrig krydse renderer / plugin broen. Biometrisk IPC validerer det levende hovedvindue og dets vigtigste ramme; plugins kan ikke påberåbe sig det. Eksplicit låsning annullerer verserende biometrisk og adgangskode låse arbejde så sent godkendelse kan ikke genåbne Vault. Fjernelse tilmelding tilbagekalder sin lokale binding, selvom OS-butikken er offline; en utilgængelig butik kan bevare et ubrugeligt forældreløst credential.

## Byg og verifikation

`npm run biometrics:build` forbereder vært-platform hjælper; udvikling start og frigivelse forberedelse påberåbe sig det automatisk. macOS kræver Swift/Apple SDK med sikkerhed og LocalAuthentication; Windows kræves Visual Studio C ++ Build Tools, Windows SDK og C ++ / / WinRT; Linux kopierer Python hjælperen. Ingen nye npm afhængigheder tilføjes. Byg indfødt på hvert mål OS. macOS helper er inkluderet i rekursiv bundle signering; det behøver ingen App Sandbox ret, fordi denne desktop app ikke er sandkasse. Produktion macOS distribution stadig kræver Developer ID signering og notarisering, uafhængig af OpenPGP release signaturer.

Kør `npm test`, `npm run test:biometrics:ui` og `npm run test:diagnostics:ui`. Biometrisk knudetest og isoleret UI-røgtest anvendes a **mock OS-adapter** at dække succes, afvisning / aflysning, forkerte nøgler, manglende hardware / tilmelding, nulstille, timeout og sene resultater, utilgængelig Linux keyrings, OS credential failures Windows PIN-godkendte svar macOS ændringer i tilmelding, eksisterende bokskompatibilitet, IPC-isolation og SSH Rengøring. Dette skaber ikke succesfuld hardware godkendelse.

Native kompilering blev verificeret på macOS arm64 og Windows x64. macOS rapporter Touch ID tilgængelig; Windows VM rapporterer Hej utilgængelige. Fingerprint/face/PIN tilmelding, faktisk beskyttet-nøgle hentning, OS dialog annullering og tilmeldingsændring forlængelse stadig kræver interaktiv hardware test på hvert understøttet system. Linux hjælper skal desuden testes på et skrivebord med en understøttet fprinted læser; en hovedløs VM kan ikke fastslå denne verifikation.

Platformreferencer: [Kontrol af Apples biometriske adgang](https://developer.apple.com/documentation/security/secaccesscontrolcreateflags/biometrycurrentset), [Windows desktop Hello interop](https://learn.microsoft.com/en-us/windows/win32/api/userconsentverifierinterop/nf-userconsentverifierinterop-iuserconsentverifierinterop-requestverificationforwindowasync), [fprinted enhedens livscyklus](https://fprint.freedesktop.org/fprintd-dev/Device.html), [Specifikationer for Secret Service](https://specifications.freedesktop.org/secret-service/latest/).

## macOS SSH lokalnetadgang

Hvis hver lokal SSH-profil fejler med `connect EHOSTUNREACH`, men den samme forbindelse virker i Terminalen, skal du kontrollere **Systemindstillinger → Privatliv og sikkerhed → Lokalt netværk → CH-J Server Manager** give adgang, helt afslutte app og genåbne det. Hvis allerede aktiveret, skiftes dets tilladelse og genstartes. Også tjek routing, Wi-Fi / Ethernet og VPN: fejlen alene er ikke bevis på en benægtelse af privatlivets fred. Du må ikke nulstille Vault eller kassere betroede SSH fingeraftryk for denne fejl.

App'en erklærer `NSLocalNetworkUsageDescription` og leverer lokaliseret vejledning til macOS netværkstilladelse / rute fejl. Den kan ikke give sig selv tilladelse. Apple anbefaler en Apple-udstedt signeringsidentitet, så macOS kan spore netværksfortrolighed pålideligt på tværs af builds; nuværende ad hoc alfa bygger bevarer denne begrænsning. Se [Apple's vejledning om beskyttelse af personlige oplysninger på lokalt plan](https://developer.apple.com/documentation/technotes/tn3179-understanding-local-network-privacy).

## Ubuntu programikon

Debian-pakker installerer det eksisterende CH-J-ikon ved standardhicolorstørrelser (16–512 px), med en matchende skrivebordsindgang og Electron vinduesklasse. Hovedvinduet modtager også ikonet, når genskabt. Efter opdatering af en allerede fastspændt gammel launcher, skal du fjerne pin det og fastgøre den nyligt installerede applikation; et desktop logout / login kan opdatere en gammel GNOME launcher cache.