> Ir-reviżjoni lingwistika ta’ din it-traduzzjoni għadha għaddejja. Jekk xi silta mhijiex ċara, ara t-[test oriġinali bl-Ingliż](https://www.sm.ch-j.eu/docs/i18n/en/biometric-unlock.md).

# L-awtentikazzjoni tas-sistema fakultattiva u l-imblukkar tal-arja

Oħloq jew iftaħ il-Vault bil-password prinċipali tagħha l-ewwel. Open **Settings → Sigurtà**, iċċekkja l-istatus fornitur, u jippermettu l-ftuħ bijometriku. Ir-reġistrazzjoni titlob awtentikazzjoni tas-sistema ġdida. Wara l-overlay login joffri Touch ID, Windows Hello jew marki tas-swaba 'ftuħ ħdejn il-formola master-password. **Disable u tneħħi r-reġistrazzjoni ** tneħħi ċ-ċavetta cached ta' din l-applikazzjoni, qatt il-marki tas-swaba' rreġistrati tas-sistema operattiva.

Żomm il-password kaptan: kanċellazzjoni, timeout, hardware mhux disponibbli / keyring u reġistrazzjoni invalidati kollha jeħtieġu password fallback. Reġistrazzjoni bijometrika hija lokali għal dan l-utent, apparat u Vault. Mhuwiex mekkaniżmu ta' rkupru jew riżerva. L-istabbiliment mill-ġdid tal-Vault jirrevoka r-reġistrazzjoni u jħassar il-profili kriptati eżistenti u l-marki tas-swaba' ospitanti biss wara l-konferma eżistenti `SMAZAT`.

| Pjattaforma | Awtentikazzjoni u ħażna | Rekwiżiti u limiti |
| --- | --- | --- |
|  macOS  Apple Silicon  | Native LocalAutentication / Touch ID; Sigurtà.qafas keychain element ma " `biometryCurrentSet` kif ukoll `WhenUnlockedThisDeviceOnly`  | Iskritt Touch ID, sensor disponibbli u login keychain li jistgħu jintużaw. Il-marka tas-swaba' tibdel l-oġġett. Uża l-iffirmar tal-ID tal-iżviluppatur stabbli għall-aġġornamenti tal-produzzjoni; l-iffirmar ad hoc tal-alfa jista' jfixkel il-fiduċja fil-katina ewlenija u t-traċċar tal-permessi tan-netwerk lokali. |
|  Windows  x64  | WinRT Nattiv Windows Hello desktop interop mehmuża ma 'l-HWND prinċipali; DPAPI utent attwali encrypted key in Windows Maniġer Kummerċjali | Marka tas-swaba' ta' Hello, wiċċ ikfigurat **jew PIN**. Dan huwa konvenjenza miftuħa: Hello approvazzjoni hija infurzata mill-app, filwaqt DPAPI innifsu mhuwiex gated bijometriku. Kodiċi ieħor li jaħdem bħala l-istess utent jista 'jiddeċifra l-credential. |
|  Ubuntu  x64  | Il-marki tas-swaba' rreġistrati tal-utent attwali permezz ta' D-Bus fprintjat; libsecrete / Secret Service credential storage | qarrej appoġġjat, marki tas-swaba rreġistrati, tħaddim desktop Sigriet Servizz u keyring default. Il-konvenjenzja miftuħa: il-kredenial kruċjali mhuwiex marbut b'mod kriptografiku mal-verifika tal-marki tas-swaba'. Nru `basic_text` jew sempliċitext-file-back. |

Fuq Ubuntu il-pakketti mhux obbligatorji ta' runtime huma `python3-gi`, `gir1.2-secret-1` u `gnome-keyring` (jew servizz sigriet kompatibbli ieħor) u `fprintd`. Installa pakketti neqsin bl-użu tal-maniġer normali pakkett OS, imbagħad irreġistra marki tas-swaba f'settings OS. Awtentikazzjoni juża l-utent attwali u ma teħtieġx għeruq jew bidla PAM. A sessjoni SSH mingħajr ras mingħajr keyring desktop rapporti mhux disponibbli; ma sieket a key x'imkien ieħor.

## Regoli dwar l-imblukkar

L-illokkjar awtomatiku huwa mitfi għall-installazzjonijiet eżistenti. Jippermettuha tagħżel **15 minuti** b'mod awtomatiku; il-valuri sostnuti qatt m'huma, 1, 5, 10, 15, 30 kif ukoll 60 minuti. Keyboard u input maws fit-twieqi applikazzjoni jgħoddu bħala attività; produzzjoni SSH deħlin ma. Is-sokra b'fokus fakultattiv tittratta t-twieqi tal-plugin tal-applikazzjoni bħala parti mill-app u tippermetti awtentikazzjoni tas-sistema fil-pront biex tintemm. Il-bdil ta' dawn ir-regoli jeħtieġ il-password prinċipali.

**Ever Vault lock, inklużi inattività u lock fokus, skonnettja sessjonijiet SSH attivi, jagħlaq plugins u tieqaf dijanjostiċi.** Ħlief editjar remot qabel l-illokkjar. Dan jippreserva l-imġiba manwali-lock eżistenti; ebda kredenzjali SSH jibqgħu disponibbli għall-plugins sfond wara lock.

Il-politika mhux obbligatorja ta' operazzjoni sensittiva titlob awtentikazzjoni ġdida tas-sistema għat-tħassir tal-profil, l-installazzjoni/tneħħija tal-plugin, it-tnedija u r-risettjar ta' Vault miftuħ. Kmandi terminal Remote u plugin fajls editjaturi huma barra din il-politika. Il-politika ma tissostitwixxix SSH awtorizzazzjoni server. Jekk il-fornitur jieqaf jaħdem, iftaħ il-password prinċipali u biddel il-politika billi tuża dik il-password. Ir-reset jibqa' disponibbli mill-iskrin ta' rkupru msakkar wara l-konferma distruttiva tiegħu.

## Id-disinn tal-Vult u l-IPC

Il v1 Vault eżistenti jibqa 'AES-256-GCM bi scrypt; reġistrazzjoni ma jikteb mill-ġdid fajls tagħha jew jibdlu schema tiegħu. Kopja biss tal-kodiċi ** derivat minn 32-byte ** tmur għall-ħażna kredentijali tal-OS. Il-password kaptan plaintext qatt ma tinħażen. Metadejta ta' reġistrazzjoni lokali fiha identità kredential każwali, fornitur u SHA-256 li jorbot mal-metadata immutable tal-Vault. Ċavetta rkuprata għandha tgħaddi minn decryption awtentikata qabel ma tinfetaħ sessjoni. Il-buffers tal-proċess prinċipali jiġu approvati wara l-użu; il-kordi tal-protokoll nattivi huma memorja ta' proċess tranżitorju, mhux dikjarazzjoni ta' tħassir komplet tal-memorja f'runtimes ġestiti.

Il-helper jikkomunika permezz ta 'pajpijiet stdin/stdout privati magħluqa, taċċetta l-ebda kmandi qoxra, għandha timeouts awtentikazzjoni u jirritorna kodiċijiet żball sanitazed. Dawk li jgħinu huma ppakkjati barra ASAR fil `resources/biometrics`; dawn huma eżekutibbli nattivi indiġenu, sabiex l-ebda modulu nattiv Electron ABI huwa meħtieġ. Il-helper Linux juża sistema Python u GI. Oġġetti nattivi u ċwievet derivati qatt jaqsmu l-pont former / plugin. IPC bijometriku jivvalida l-tieqa prinċipali live u l-qafas ewlieni tagħha; plugins ma tistax tinvoka dan. L-għeluq espliċitu jikkanċella sakemm isir xogħol bijometriku u ta' password biex b'hekk l-approvazzjoni ma tkunx tista' terġa' tinfetaħ il-Vault. It-tneħħija tar-reġistrazzjoni tirrevoka r-rabta lokali tagħha anke jekk il-maħżen tal-OS ikun offline; maħżen li ma jistax jintlaħaq jista' jżomm kredential orfni li ma jkunx jista' jintuża.

## Bini u verifika

`npm run biometrics:build` jipprepara l-helper host-pjattaforma; iżvilupp bidu u rilaxx preparazzjoni jinvokaw dan awtomatikament. macOS teħtieġ Switt/Apple SDK b'Sigurtà u LokaliAutentication; Windows jeħtieġ Visual Studio C++ Jibnu Għodod, Windows DDK u C++ / WinRT; Linux kopji tal-helper Python. M'huma miżjuda l-ebda dipendenti npm ġodda. Jibnu n-natura tagħhom fuq kull OS fil-mira. Il-helper macOS huwa inkluż fl-iffirmar tal-pakkett repetittiv; jeħtieġ l-ebda intitolament App Sandbox għaliex din l-applikazzjoni desktop mhix sandboxed. Id-distribuzzjoni ta' macOS tal-produzzjoni għadha teħtieġ l-iffirmar u n-notifikar tal-ID tal-iżvilupp, indipendentement mill-firem tar-rilaxx OpenPGP.

Ġirja `npm test`, `npm run test:biometrics:ui` kif ukoll `npm run test:diagnostics:ui`. Testijiet tan- Nodu Bijometriċi u t- test tad- duħħan UI iżolata a **adapter mock OS** biex tkopri s-suċċess, iċ-ċaħda/kanċellazzjoni, iċ-ċwievet ħżiena, il-hardware/ir-reġistrazzjoni nieqsa, ir-risettjar, it-timeout u r-riżultati tard, mhux disponibbli Linux ċwievet, fallimenti kredentili tal-OS, Windows Reazzjonijiet approvati mill-PIN, macOS Bidliet fir-reġistrazzjoni, kompatibilità eżistenti tal-Vault, iżolament tal-IPC u SSH tindif. Dan ma jistabbilixxix awtentikazzjoni hardware suċċess.

Il-kumpilazzjoni nattiva ġiet ivverifikata fuq macOS arm64 u Windows x64. macOS jirrapporta Touch ID disponibbli; iż-Windows VM tirrapporta Hello mhux disponibbli. Ir-reġistrazzjoni ta' fingerprint/face/PIN, l-irkupru protett reali, il-kanċellazzjoni ta' dialog OS u l-invalidazzjoni tal-bidla fir-reġistrazzjoni għadhom jeħtieġu ttestjar interattiv tal-hardware fuq kull sistema appoġġata. Barra minn hekk, il-persuna li tgħin Linux għandha tiġi ttestjata fuq desktop b'qarrej fprintd appoġġjat; VM mingħajr ras ma tistax tistabbilixxi dik il-verifika.

Referenzi tal-pjattaforma: [Kontroll tal-aċċess bijometriku Apple](https://developer.apple.com/documentation/security/secaccesscontrolcreateflags/biometrycurrentset), [Windows Interop desktop Hello](https://learn.microsoft.com/en-us/windows/win32/api/userconsentverifierinterop/nf-userconsentverifierinterop-iuserconsentverifierinterop-requestverificationforwindowasync), [f Iċ-ċiklu tal-ħajja tal-apparat stampat](https://fprint.freedesktop.org/fprintd-dev/Device.html), [Speċifikazzjoni tas-Servizz Sigriet](https://specifications.freedesktop.org/secret-service/latest/).

## macOS SSH aċċess għan-netwerk lokali

Jekk kull lokali SSH Insuffiċjenza tal-profil `connect EHOSTUNREACH` iżda l-istess xogħlijiet konnessjoni fit-Terminal, kontroll **Settings tas-Sistema → Privatezza & Sigurtà → Netwerk Lokali → CH-J Server Manager**, jippermettu aċċess, tieqaf kompletament l-applikazzjoni u terġa' tiftaħha. Jekk ikun diġà permess, igglejżja l-permess tiegħu u erġa' ibda. Barra minn hekk iċċekkja r-rotta, Wi-Fi/Ethernet u VPN: l-iżball waħdu mhuwiex prova ta 'ċaħda tal-privatezza. Terġax tissettja l-Vault jew tarmi marki tas-swaba' ta' SSH fdati għal dan l-iżball.

L-applikazzjoni tiddikjara `NSLocalNetworkUsageDescription` u tipprovdi gwida lokalizzata għall-permessi tan-netwerk macOS/żbalji fir-rotot. Ma jistax jagħti l-permess lilu nnifsu. Apple tirrakkomanda identità ta' firma maħruġa minn Apple sabiex macOS tkun tista' tittraċċja l-privatezza tan-netwerk b'mod affidabbli tul il-bini; il-bini attwali ad hoc alpha jżomm dik il-limitazzjoni. Ara [Gwida dwar il-privatezza tan-netwerk lokali ta' Apple](https://developer.apple.com/documentation/technotes/tn3179-understanding-local-network-privacy).

## L-ikona tal-applikazzjoni Ubuntu

Il-pakketti debjani jinstallaw l-ikona eżistenti CH-J f'daqsijiet standard tal-kulur hiscolor (16–512 px), b'entrata desktop li taqbel u l-klassi tat-tieqa Electron. Il-tieqa prinċipali tirċievi wkoll l-ikona meta rekreated. Wara l-aġġornament ta 'launcher qadim diġà pinned, unpin dan u pin l-applikazzjoni ġdida installata; logout desktop / login jista 'jisserraħ cache launcher GNOME stale.