Verifică descărcările

Fiecare versiune desktop de pe github.com/codai-ro/codai-desktop/releases poartă două tipuri de dovezi. Pagina asta spune exact ce fișiere primesc ce, ca să știi ce înseamnă de fapt o bifă verde.

latest.json din aceeași versiune este ce citește actualizatorul automat; platforms.windows-x86_64.signature de acolo este conținutul fișierului .exe.sig, așa că actualizatorul și o verificare manuală verifică același lucru.

Checksum-uri (fiecare fișier)

SHA256SUMS listează un SHA-256 în litere mici per artefact, în formatul <hash> <nume-fișier>.

# în folderul unde ai descărcat artefactele
$sums = Get-Content .\SHA256SUMS
Get-ChildItem codai_* | ForEach-Object {
  $h = (Get-FileHash $_.FullName -Algorithm SHA256).Hash.ToLower()
  $ok = $sums -match "^$h  $([regex]::Escape($_.Name))$"
  "{0}  {1}" -f ($(if ($ok) { 'OK ' } else { 'BAD' })), $_.Name
}

Un checksum dovedește că fișierul nu a fost corupt sau înlocuit după publicare. Nu dovedește cine l-a publicat — pentru asta ai nevoie de semnătura de mai jos.

Semnături (installer Windows, AppImage Linux)

Fișierele .sig sunt semnături minisign produse de tauri signer. Cheia publică corespunzătoare este compilată în aplicație și tipărită în src-tauri/tauri.conf.json → plugins.updater.pubkey. Doar un fișier semnat cu jumătatea privată a acelei chei va fi instalat de actualizator — și doar un astfel de fișier ar trebui instalat de tine.

$pub = 'dW50cnVzdGVkIGNvbW1lbnQ6IG1pbmlzaWduIHB1YmxpYyBrZXk6IDFCRERBM0QxMDY4NzYyNjcKUldSbllvY0cwYVBkRzcrYXdNcmFyMnZmTEhTRGJPOWlmZVkzdGZsVjRJWXN1Q0dHTXp6UWJSaGcK'
[Text.Encoding]::UTF8.GetString([Convert]::FromBase64String($pub)) | Set-Content codai-desktop.pub

$v = '0.6.1'
[Text.Encoding]::UTF8.GetString([Convert]::FromBase64String((Get-Content "codai_${v}_x64-setup.exe.sig" -Raw))) | Set-Content "codai_${v}_x64-setup.exe.minisig"

minisign -Vm "codai_${v}_x64-setup.exe" -p codai-desktop.pub -x "codai_${v}_x64-setup.exe.minisig"

Aceiași trei pași se aplică pentru codai_<v>_amd64.AppImage / .AppImage.sig pe versiunile care includ un build Linux.

Ce nu este semnat azi

• Authenticode Windows — installerul nu este semnat cu un certificat de semnare de cod, așa că Windows SmartScreen afișează „Windows protected your PC” prima dată. Este planificat (Azure Artifact Signing); până atunci verificarea minisign de mai sus este modul de a ști că fișierul este al nostru.
• .msi și .zip-ul portabil — au checksum, nu semnătură.
• .deb / .rpm Linux — au checksum, nu semnătură GPG; nu există repo apt/dnf.
• macOS — niciun build publicat, deci nicio notarizare.
• APK Android — semnat cu keystore-ul de release, cum trebuie orice aplicație Android (certificat SHA-256 11:F1:6A:8B…; amprenta completă este în repo-ul codai-phone). Android o verifică la instalare și refuză o actualizare semnată cu altă cheie. Nu există încă un SHA256SUMS separat pentru APK.

Versiuni și rollback

• Versiunile sunt etichetate desktop-v<versiune>; cele trei fișiere de versiune din sursă (package.json, tauri.conf.json, Cargo.toml) sunt mereu în acord cu eticheta.
• Endpoint-ul de actualizare https://codai.ro/api/desktop/latest.json servește cea mai nouă versiune non-pre-release. O versiune defectă este retrasă marcând-o pre-release (sau ștergând-o): cea anterioară redevine „latest” în cinci minute. Actualizatorul nu face niciodată downgrade unei versiuni mai noi deja instalate.
• Cheia privată de semnare nu părăsește niciodată mașina maintainerului și are backup offline; pierderea ei ar orfaniza fiecare client instalat.