Yeni: Yapay zekâ güvenlik duvarı tüm platformu izliyor ve her olayı sade bir dille açıklıyor. Nasıl çalıştığını görün

Güncellemeler için firmware derleyin ve imzalayın

Hermetry'nin over-the-air güncellemeler için kabul ettiği imza türleri, bir OpenWrt veya ESP32 imajının kabul edilmesi için nasıl imzalanacağı ve Hermetry'nin tam olarak neleri kontrol ettiği.

Bu sayfa, over-the-air güncellemeler için firmware imajı hazırlayan firmware geliştiricilerine yöneliktir. Hermetry’nin kabul ettiği imza türlerini, yüklemenin kabul edilmesi için bir imajın nasıl imzalanacağını ve Hermetry’nin neleri kontrol ettiğini kapsar. Yükleme, atama ve güncellemeleri takip etme işlemleri Firmware updates (OTA) sayfasındadır.

Önemli

Hermetry hiçbir zaman firmware imzalamaz ve hiçbir zaman özel imzalama anahtarı tutmaz. İmajları kendi yayın hattınızda imzalarsınız ve yalnızca genel anahtarları kaydedersiniz.

İmza türleri

Tür (Hermetry’de gösterildiği şekliyle)Kullanım alanıKaydettiğinizYüklediğiniz
usign (OpenWrt)OpenWrt cihazları veya güncelleyicisi usign (Ed25519) imzasını kontrol eden her cihazGenel anahtar dosyasının tamamı (.pub)İmaj ve ayrı imza dosyası (.sig)
ESP32 Secure Boot V2RSA imzalama anahtarı kullanan Secure Boot V2 özellikli ESP32 cihazları64 karakterlik SHA-256 anahtar özetiİmzalanmış imaj; imza imajın içindedir
İmzasızYalnızca test cihazlarıHiçbiriİmaj. Yalnızca profilde Allow unsigned images açık olduğunda atanabilir.

OpenWrt imajını usign ile imzalama

Bir kez anahtar çifti oluşturun ve gizli anahtarı Hermetry’de değil, yalnızca yayın hattınızda saklayın. Ardından her imajı imzalayın ve yüklemeden önce imzayı kontrol edin.

# once: a key pair
usign -G -s release.sec -p release.pub -c "firmware release key"

# for every image
usign -S -m firmware.bin -s release.sec -x firmware.bin.sig

# check before you upload
usign -V -m firmware.bin -x firmware.bin.sig -p release.pub

Hermetry’nin kontrol ettikleri:

  • .sig dosyası bir usign imza dosyasıdır: bir untrusted comment: satırı ve bir base64 satırı içerir, en fazla 1.024 karakterdir.
  • İmzadaki anahtar numarası kayıtlı usign anahtarlarınızdan birini seçer. Eşleşen anahtar yoksa yükleme reddedilir.
  • Ed25519 imzası, yüklediğiniz dosyanın tamamı üzerinde doğrulanır. Son dosyayı imzalayın: imzalamadan sonraki her değişiklik, dolgu bile olsa, imzayı bozar.

Cihazda Hermetry, imzayı fw_sig içinde usign: ardından .sig dosya metninin base64 hâliyle iletir. Bunu bir .sig dosyasına çözün ve indirilen imajı kendi anahtarınızla doğrulayın, örneğin usign -V -m <image> -x <sig> -P <keyring directory>. Ayrıca fw_checksum (SHA-256) değerini kontrol edin.

ESP32 imajını Secure Boot V2 için imzalama

Hermetry, RSA anahtarıyla oluşturulmuş bir Secure Boot V2 imza bloğu içeren imajları kabul eder. Espressif’in espsecure.py aracıyla (esptool’un parçası):

# once: an RSA-3072 signing key
espsecure.py generate_signing_key --version 2 --scheme rsa3072 signing_key.pem

# for every image: append the signature sector
espsecure.py sign_data --version 2 --keyfile signing_key.pem --output app-signed.bin app.bin

# once: the key digest you register in Hermetry (64 hex characters)
espsecure.py digest_sbv2_public_key --keyfile signing_key.pem --output key_digest.bin
xxd -p -c 32 key_digest.bin

Derlemeniz uygulama imajını zaten imzalıyorsa, ürettiği imzalı dosyayı yükleyin.

Hermetry’nin kontrol ettikleri:

  • İmaj tam sayıda 4 KiB sektörden oluşur, en az 8 KiB’tir ve son 4 KiB sektörü imza bloğunu içerir.
  • İlk imza bloğu bir sürüm 2 bloğudur ve içindeki imaj özeti, imza sektöründen önceki her şeyin SHA-256 değerine eşittir.
  • Bu bloktaki genel anahtarın SHA-256 değeri, kayıtlı ESP32 anahtar özetlerinizden birine eşittir. Yalnızca ilk imza bloğu karşılaştırılır: birden fazla anahtarla imzalarsanız, önce imzalayan anahtarı kaydedin.

Hermetry RSA imzasının kendisini doğrulamaz: bunu cihazın bootloader’ı zorunlu kılar. Hermetry’nin kontrolü, yanlış anahtar için üretilmiş bir imajın yayılmasını engeller. Bu imajlar için fw_sig değeri esp-secure-boot olur.

İmzalama anahtarlarını kaydetme

Yalnızca sahipler imzalama anahtarı ekleyebilir veya iptal edebilir.

  1. Firmware ardından Signing keys bölümünü açın.
  2. Add key seçeneğini seçin.
  3. Bir Name (1 ila 120 karakter) verin ve Kind türünü seçin.
  4. Public key alanına yapıştırın: usign için .pub dosyasının tamamı, ESP32 için 64 karakterlik anahtar özeti.
MesajAnlamı
Bu, seçilen türde bir genel anahtar değil.Metin bir usign genel anahtar dosyası değil veya 64 karakterlik onaltılık özet değil
Bu anahtar zaten kayıtlı.Aynı parmak izine sahip, bu türde etkin bir anahtar mevcut

Anahtarları değiştirmek için, bu anahtarla imzalanmış ilk imaj yüklenmeden önce yeni genel anahtarı kaydedin. Bir anahtarı iptal etmek, onunla imzalanmış her paketi iptal eder ve kurulumuna henüz başlanmamış bu paketlerle yapılan güncellemeler durdurulur. Bir anahtarı yalnızca imajlarının artık kurulmaması gerektiğinde iptal edin.

Yüklemede yapılan kontroller

Bir paket yüklediğinizde Hermetry şu sırayla kontrol eder:

  1. Dosyanın SHA-256 değeri, onunla gönderilen sağlama toplamına eşittir. Yükleme formu bunu tarayıcınızda hesaplar; derlemenizin verdiği değerle karşılaştırın.
  2. İmza, seçilen türdeki etkin imzalama anahtarlarınıza karşı.
  3. Virüs taraması. Tarama temiz olduğunda paket Ready olur.

En büyük paket varsayılan olarak 64 MiB’tir. Reddedilen bir imza nedenini şöyle belirtir:

MesajÇözüm
İmza beklenen biçimde değil. Bu imaj için üretilmiş .sig dosyasını seçin.usign -S ile üretilmiş .sig dosyasını veya sonunda imza sektörü bulunan bir ESP32 imajını yükleyin
İmaj, burada kayıtlı olmayan bir anahtarla imzalanmış. Önce “Signing keys” altında genel anahtarını ekleyin.Genel anahtarı (usign) veya anahtar özetini (ESP32) kaydedin, sonra yeniden yükleyin
İmza bu imajla eşleşmiyor. Bu tam dosya için üretilmiş .sig dosyasını seçin.Dosya imzalandıktan sonra değişmiş veya imza başka bir dosyaya ait. Son dosyayı yeniden imzalayın.

Yayın derlemesi için kontrol listesi

  • Pakete, cihazınızın açılıştan sonra current_fw_title ve current_fw_version olarak bildirdiği başlığı ve sürümü verin.
  • Son imajı en son imzalayın; sonrasında değiştirmeyin.
  • Gizli anahtarları yayın hattınızda saklayın. Hermetry yalnızca genel kısmı ister.
  • Not signed seçeneğini yalnızca imzasız imajlara izin veren bir test profilinde kullanın.
  • Cihaz, sağlama toplamı eşleşse bile imzası doğrulanmayan bir imajı reddetmelidir.