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

Uzaktan ayarlar için iyi uygulamalar

Uzaktan cihaz ayarlarının ayrıntılı davranışı ve bunların tek bir cihazda ya da çok sayıda cihazda güvenle nasıl değiştirileceği: istenen ve raporlanan değerler, birleştirme kuralları, revizyonlar, drift, gizli bilgiler, job'lar ve eski firmware.

Bu sayfa, cihaz ayarlarını Hermetry üzerinden elle veya API aracılığıyla, tek bir cihazda ya da çok sayıda cihazda değiştiren yöneticiler ve entegratörler içindir. Ayarlar sekmesinin arkasındaki kuralları ve bunların güvenle nasıl kullanılacağını açıklar. Sekmenin nasıl açılacağı, baseline’ların nasıl oluşturulacağı ve işlerin nasıl başlatılacağı Uzaktan cihaz ayarları sayfasında; route’lar ise Firmware ve cihaz ayarları API’si sayfasındadır.

Desired ve reported değerler

Hermetry, bir cihazın her ayar bölümü için iki doküman tutar:

  • Desired: Hermetry’nin cihazdan en son çalıştırmasını istediği ayarlar; her değişiklikle artan bir revizyon numarası taşır.
  • Reported: Cihazın çalıştırdığını bildirdiği ayarlar; uyguladığı revizyonla birlikte.

Her değişiklik, yalnızca değişen anahtarları değil bölümün tamamını cihaza gönderir. Cihaz bir bölümü yalnızca revizyonu uyguladığı son revizyondan yüksekse uygular. Cihazı çok uzun süre bekleyen bir bölüm geri çekilir; cihaz da mevcut ayarlarını korur.

Ayarlar sekmesindeki durumAnlamı
YoldaGönderildi veya cihazın çevrimiçi olması bekleniyor
Cihaz deniyorCihaz değişikliği deneme amaçlı çalıştırır ve buluta yeniden ulaşamazsa kendi kendine geri alır
UygulandıCihaz değişikliği çalıştırıyor
Cihaz tarafından geri alındıCihaz denedi ve eski haline döndü
Cihaz reddettiCihaz kabul etmedi
Cihaz çevrimdışıydıDeğişiklik çok uzun süre bekledi (tek bir değişiklik için 7 gün) ve geri çekildi
Güncelleme sonrası kontrolBir firmware güncellemesi bölümün açıklamasını değiştirdi; bir kişinin gözden geçirip kaydetmesi gerekir
Cihazda değiştirildiDrift: cihaz, Hermetry’nin istediğinden farklı değerler çalıştırıyor (aşağıda)
Buradan değiştirilmediHermetry bu bölümü hiç ayarlamadı; yalnızca cihazın bildirdiğini gösterir

Bir değişiklik nasıl oluşturulur

Bir bölümü yazmanın iki yolu vardır ve dışarıda bıraktığınız şeylere farklı davranırlar.

YolKullananNe gönderirsiniz
Tüm bölümAyarlar sekmesi, PUTBölümün her değeri. Dışarıda bıraktığınız şey yeni bölümün parçası olmaz.
Merge patchPATCH, baseline’lar, ayar işleriYalnızca değişenler, JSON merge patch (RFC 7386) olarak

Bir merge patch tam olarak şu kurallara uyar:

  • Nesneler anahtar anahtar birleştirilir. Adını vermediğiniz bir anahtar değerini korur.
  • null anahtarı kaldırır.
  • Diğer her değer eskisinin yerini bütünüyle alır. Liste her zaman bütünüyle değiştirilir: bir listenin tek bir girdisini değiştirmek için listenin tamamını gönderin.

Patch, cihazın bildirdiğine değil, bölümün son desired dokümanına uygulanır. Yalnızca Hermetry bölümü hiç ayarlamadıysa patch reported değerlerden başlar; cihaz bölümü henüz bildirmediyse de yazma reddedilir (section_not_reported).

İyi uygulama:

  • Baseline’a yalnızca değiştirmek istediklerinizi koyun. Geri kalan her şey her cihazda olduğu gibi kalır.
  • Anahtarın işteki her cihazdan kaybolması gerekmiyorsa baseline’a asla null koymayın.
  • Cihaza özgü listeleri (örneğin sahaya göre değişen adres listeleri) baseline’lara koymayın: baseline’ın listesi her cihazın listesinin yerini alır.
  • Açıklamada yalnızca cihazda değiştirilebilir olarak işaretlenen ayarlar cihazın raporundan korunur. Bunlara yapılan değişiklik reddedilir (remote_forbidden).
  • Hiçbir şey gönderilmeden önce bir değişikliğin hangi ayarlara dokunduğunu ve onay gerektirip gerektirmediğini görmek için ?dryRun=true (veya bir işte Kontrol et) kullanın.

Revizyonlar ve If-Match

Bir bölümü okumak, desired revizyonunu W/"7" biçiminde ETag başlığı olarak döndürür. Her yazma bu revizyonu If-Match içinde geri göndermelidir; "7" ve 7 da kabul edilir.

YanıtAnlamı
428 if_match_requiredYazmada If-Match yoktu
412 rev_mismatchSiz okuduktan sonra biri bölümü değiştirdi

412 durumunda bölümü yeniden okuyun, değişikliğinizi yeni doküman üzerine yeniden oluşturun ve tekrar yazın. Yeni revizyonu başlığa kopyalayıp eski dokümanı yeniden göndermeyin: bu, diğer kişinin değişikliğinin üzerine yazar. Ayarlar sekmesi de aynı kontrolü yapar (“Bu ayarlar siz açtıktan sonra başka biri tarafından değiştirildi. En günceli görmek için yeniden yükleyin.”).

Drift

Cihaz Hermetry’den gelen bir değişikliği uyguladıktan sonra farklı değerler bildiriyorsa, genellikle biri cihazın kendisinde değiştirdiği için, bölüm drift etmiş demektir. Sekme “Cihazda değiştirildi” ifadesini ve nelerin farklı olduğunu gösterir. Hermetry drift’i kendiliğinden düzeltmez. Siz seçersiniz:

EylemEtki
Bizimkini yeniden gönderHermetry’nin desired değerlerini yeni bir revizyon olarak yeniden gönderir
Cihazınkini koruCihazın mevcut değerlerini yeni desired değerler olarak kaydeder

Drift etmiş bir bölümü başka bir yolla değiştirmeden önce drift’i çözün. Bir merge patch ve dolayısıyla bir ayar işi son desired dokümandan başlar; bu yüzden drift eden ayarlar için de Hermetry’nin değerlerini geri gönderir.

Her ayarın kime ait olduğuna karar verin. Sahadaki teknisyenlerin bir şeyi değiştirebilmesi gerekiyorsa onu baseline’ların ve işlerin dışında tutun.

Secret’lar

  • Gizli ayarlar (parolalar, anahtarlar) asla gösterilmez veya döndürülmez. { "set": true } olarak okunurlar.
  • Yeni bir secret cihaza tek kullanımlık bir referans olarak iletilir. Cihaz değeri imzalı bir istekle bir kez alır; alınmayan bir referansın süresi 30 gün sonra dolar. Firmware’i referans alamayan bir cihaz hiç secret almaz: değişiklik reddedilir (secret_ref_unsupported).
  • Cihazın mevcut secret’ını korumak için alanı değiştirmeden bırakın (API’de { "$keep": true }).
  • Baseline’lar secret içeremez (secret_not_allowed). Bunları her cihazda ayarlayın.
  • secret_pending: önceki bir değişiklik, cihazın henüz almadığı bir secret taşıyor. Bekleyin veya secret’ı yeniden girin.
  • Yeniden gönder sırasında secrets_need_rewrite: değişiklik, cihazın artık alamadığı secret’lar taşıyor. Bunları yeniden girip kaydedin.

Ayar işleri

Bir iş, bir baseline’ı veya tek bir değişikliği birçok cihaza dalgalar halinde uygular. İyi uygulama:

  1. Test ettiğiniz model ve firmware’e göre seçin. Kontrol et adımı cihazları model ve firmware’e göre ve bir modelde bulunmayan bölümleri gösterir.
  2. Dalgaları koruyun. Varsayılan %1, sonra %10, sonra geri kalanıdır. İlk dalga, seçilen cihazlardan sabit bir rastgele kesittir.
  3. Gate’i anlayın. Yanıt veren cihazlar arasında en az %95’i değişikliği uyguladıysa ve en fazla %1’i geri aldıysa dalga geçer (varsayılanlar). Reddeden cihazlar yanıt verenler arasında sayılır, bu yüzden uygulanan payı düşürür. Hâlâ çevrimdışı olan cihazlar sayılmaz. Bir dalga, tüm cihazları yanıt verdiğinde ya da başladıktan 30 dakika sonra (varsayılan) o ana kadar yanıt veren cihazlar üzerinden değerlendirilir; diğerleri arka planda devam eder. Geçen bir dalga sonrakini beklemeden hemen başlatır. Hiçbir cihazın yanıt vermediği bir dalga işi duraklatır.
  4. Çakışmada ne olacağını seçin. Bir cihazın bölümünde aynı anda yalnızca bir değişiklik sürebilir. İş, başka bir işin değişikliğini bekler (ve 24 saat sonra cihazı atlar) veya cihazı hemen atlar. İş beklerken bir kişinin yaptığı değişiklik geçerli olur.
  5. Çevrimdışı cihazlar için ne kadar bekleneceğini ayarlayın: varsayılan 7 gün, 1 ile 90 arası.
  6. İptalin geri almadığını unutmayın. Zaten değişen cihazlar yeni ayarlarını korur.

Bir iş, oluşturanın sahip olduğu izinlerle yazar ve tehlikeli ayarları değiştiren bir iş oluşturulurken onaylanmalıdır. Aynı anda en fazla 5 iş çalışabilir veya duraklatılmış halde bekleyebilir, bir iş en fazla 5.000 cihaz içerir ve dakikada en fazla 200 cihaza değişiklik gönderir.

Firmware güncellemeleri ve eski firmware

  • Bir firmware güncellemesinden sonra Hermetry, saklanan istenen değerleri yeni firmware’in ayar tanımına dönüştürür. Güvenli biçimde dönüştürülemeyenler “Güncellemeden sonra kontrol edin” olarak işaretlenir. Bölüm, bir kişi kaydedene kadar bu durumda kalır; cihazdan gelen raporlar bu durumu kapatmaz ve bir job bu tür bir cihazı reddedilmiş sayar.
  • Destek penceresi: ayar yazma işlemleri, ayar tanımında kayıtlı olduğu üzere cihaz firmware’inin yayın tarihinden 24 ay sonra durur. Ayarlar okunabilir kalır (“Salt okunur: ayarları değiştirmek için firmware’i güncelleyin”). Bir yazma isteği, pencerenin bittiği tarihle birlikte 409 firmware_too_old yanıtı verir.
  • Bir job bu tür cihazları önceden dışarıda bırakmaz. Sıraları geldiğinde reddedilirler ve dalganın eşiğine sayılırlar. Önce firmware’lerini güncelleyin ya da bunları seçimin dışında bırakın.

Değişiklik hızı

Settings sekmesinden ve API’den yapılan tekil değişiklikler, Yeniden gönder dahil, kuruluş başına dakikada 600 ile sınırlıdır; bunun üzerinde 429 write_rate_limited döner. Bir job’un kendi cihazlarına yaptığı yazma işlemleri bu sınıra dahil edilmez.