Cihaz ekleme ve sahiplenme

Cihazı kuruluşunuza eklemenin birkaç yolu vardır. Bu sayfa en çok kullandığınız üç yolu anlatır: cihazı elle eklemek, cihazların profilin provisioning anahtarıyla kendilerini kaydetmesine izin vermek ve lisanslı bir cihazı sahiplenmek. Çok sayıda cihaz içeren dosyalar için Cihazları toplu içe aktarma bölümüne; LoRaWAN sensörleri için OTAA cihaz ekleme bölümüne bakın.

Yeni cihaz çekmecesi

Cihazlar bölümünü açın ve Yeni cihaz seçeneğini seçin. Kuruluşunuzun birden fazla ekleme yolu varsa, çekmece Ne ekliyorsunuz? sorusunu sorar:

Bir seçenek yalnızca modülü açıksa ve ilgili izinlere sahipseniz görünür. Başka yol seçin seçeneği listeye geri döner.

Cihazı elle ekleme

1. Çekmecede Diğer cihaz seçeneğini seçin.
2. Bir Ad girin (kuruluşunuzda benzersiz, en fazla 128 karakter), isteğe bağlı bir Etiket ekleyin ve Cihaz profili seçin (hiçbirini seçmezseniz Varsayılan profil kullanılır).
3. Bu cihaz bir ağ geçididir seçeneğini yalnızca diğer cihazlar adına rapor veren bir cihaz için açın.
4. Cihaz oluştur seçeneğini seçin.
5. Erişim belirtecini (access token) şimdi kopyalayın: yalnızca bir kez gösterilir. Bittiğinde Sakladım veya Cihazı aç seçeneğini seçin.

Yeni bir cihazın hemen erişim belirteci alıp almayacağını kuruluşunuzun cihaz ayarları belirler: Yeni cihazlara erişim belirteci ver (varsayılan olarak açık; Cihazlar > ⋯ > Ayarlar). Cihazlarınız MQTT basic veya X.509 kullanıyorsa bunu kapatın: cihaz bu durumda kimlik bilgisi olmadan oluşturulur ve bunu API üzerinden ayarlarsınız. Bkz. Cihaz kimlik bilgileri.

Provisioning anahtarıyla kendi kendine provisioning

Cihaz, profilinin provisioning anahtarını ve sırrını bilir. İlk başlatmada kendi kimlik bilgisini Hermetry’den ister; bu yüzden her cihazı önceden oluşturmanız gerekmez.

Profili ayarlama

1. Profili ve Provisioning sekmesini açın.
2. Provisioning stratejisi seçin:

1. Kaydedin, ardından Provisioning anahtarları bölümünde Anahtar oluştur seçeneğini seçin. Sırrı kopyalayın: “Sırrı şimdi kopyalayın. Bir daha göremezsiniz.” Ardından Kopyaladım seçeneğini seçin.

Anahtar tablosunda her Anahtar kimliği, Durumu (Kullanımda, Eski, hâlâ kabul ediliyor, İptal edildi), Oluşturulma, Şu tarihe kadar kabul edilir ve Son kullanım bilgileri görünür. Anahtar düğmeleri hemen etki eder; Değişiklikleri kaydet işleminin parçası değildir.

Cihazın gönderdikleri

Kullanıcı adı provision ve boş parolayla TLS üzerinden bağlanın, v1/provision/res konusuna abone olun, ardından v1/provision/req konusuna yayın yapın:

{"deviceName": "boiler-07", "provisionDeviceKey": "pk_8f3b2c1e9d4a7b60", "provisionDeviceSecret": "ps_1c9e7f2a4b6d8e03"}

v1/provision/res üzerindeki yanıt:

{"status": "SUCCESS", "credentialsType": "ACCESS_TOKEN", "credentialsValue": "aZ3…"}

Cihaz ardından yeni kimlik bilgisiyle giriş yapar. HTTPS üzerinden aynı gövdeyi taşıyıcı (bearer) üstbilgisi olmadan POST /api/v1/provision adresine gönderin; ret durumunda da 200 yanıtı döner, "status": "FAILURE" içerir.

Sınırlar: anahtar başına saatte başarılı provisioning sayısı (varsayılan 60), cihaz adı başına saatte 5 istek ve kaynak adresi başına dakikada 10 istek.

Anahtarı değiştirme veya iptal etme

• Anahtarı değiştir yeni bir anahtar ve sır oluşturur. Eski anahtar, Eski anahtarın çalışmaya devam ettiği gün sayısı kadar kabul edilmeye devam eder (varsayılan 30, 0 ile 365 arası; 0 ise hemen durdurur), ardından otomatik olarak iptal edilir. Bundan sonra ayarladığınız cihazlar yeni anahtara ihtiyaç duyar.
• İptal et bir anahtarı hemen ve kalıcı olarak durdurur. Anahtar kimliğini yazar ve bir neden verirsiniz (“Örneğin: sır yanlışlıkla paylaşıldı.”). Daha önce kaydolmuş cihazlar çalışmaya devam eder.

Lisanslı bir cihazı sahiplenme

Lisanslı yönlendiriciler, ağ geçitleri ve denetleyiciler kendi kimlikleriyle fabrikadan çıkar: seri numarası, sertifika ve sahiplenme sırrı. Sahiplenmeden önce hiçbir kuruluşa ait değildir ve Hermetry verilerini atar.

Sahiplenin

1. Cihazın yerel panelinde oturum açın ve Bulut sayfasını açın. Kapalıysa bulut bağlantısını açın; cihaz bunun ardından Hermetry’ye kendiliğinden bağlanır.
2. Aynı sayfada Sahiplenme penceresini aç seçeneğine basın. Pencere 15 dakika açık kalır.
3. Hermetry’de Cihazlar > Yeni cihaz bölümünü açın ve lisanslı cihaz seçeneğini seçin.
4. Kodun nasıl girileceğini seçin:
   • Cihazın ekranındaki kodu tarayın: telefonunuzun kamerasını Bulut sayfasındaki QR koda doğrultun ve gösterilen metni alana kopyalayın.
   • Seri numarası ve kodu yazın: Seri numarasını (6 ila 32 harf, rakam ve tire; örneğin RT420-2610-000123) ve Sahiplenme kodunu (20 karakter; örneğin 7KQ2-M9XH-D4TB-6WRA-1NZC) yazın.
5. Kontrol et seçeneğini seçin. Eklemeye hazır ekranında bir Cihaz adı girin (boş bırakılırsa seri numarası kullanılır).
6. Cihaz ekle seçeneğini seçin. “Cihaz eklendi. Çevrimiçiyse birkaç saniye içinde bağlanır.”

Cihaz, modelinin profilinin bir kopyası ve X.509 sertifika kimlik bilgisiyle eklenir. Bağlantısı kuruluşunuzun içinde yeniden başlar.

Sahiplenme başarısız olduğunda

API ile sahiplenme

{
    "serial": "RT420-2610-000123",
    "secret": "7KQ2M9XHD4TB6WRA1NZC",
    "name": "Pump house router"
}

curl -X POST 'https://<your-host>/tenant/{tenantId}/api/iot/claim' \
  -H 'Content-Type: application/json' \
  -d '{"serial":"RT420-2610-000123","secret":"7KQ2M9XHD4TB6WRA1NZC","name":"Pump house router"}'

{
    "status": "claimed",
    "serial": "RT420-2610-000123",
    "deviceId": "…",
    "model": "…",
    "profileId": "…"
}

{
    "status": "claimable",
    "serial": "RT420-2610-000123",
    "model": "…",
    "type": "…",
    "hw": "…"
}

{
    "message": "The serial or claim code is not correct.",
    "code": "VALIDATION_ERROR",
    "details": {
        "reason": "bad_secret"
    }
}

{
    "message": "…",
    "code": "FEATURE_NOT_AVAILABLE",
    "details": {
        "reason": "device_limit"
    }
}

{
    "message": "Open the claim window on the device's Cloud page (it stays open for 15 minutes), then try again.",
    "code": "CONFLICT",
    "details": {
        "reason": "press_claim_button"
    }
}

{
    "message": "…",
    "code": "RATE_LIMIT_EXCEEDED",
    "details": {
        "reason": "rate_limited"
    }
}

"status": "claimable" ile 200 yanıtı bir deneme çalıştırmasını yanıtlar. Kuruluşunuzun zaten sahip olduğu bir cihazın sahiplenilmesi "status": "claimed" ve "alreadyOwned": true ile 200 döner. Devam eden bir sahiplenme {"status": "in_progress", "serial": "…"} döner. not_claimable ile 409, seri numarasının bilinmediği, kullanımdan kaldırıldığı veya başka bir hesaba ait olduğu anlamına gelir.

Sahiplik sekmesi ve cihazı serbest bırakma

Sahiplenilmiş bir cihazın Sahiplik sekmesi Seri numarasını, Modeli, Sertifikayı (geçerlilik tarihine kadar) ve Bu hesaba eklenme zamanını gösterir. Sahiplenilmek yerine hesabınızda oluşturulan bir cihaz Fabrika cihazı değil olarak belirtilir.

Lisanslı bir cihazı başka bir sahibe devretmek için Sahiplik sekmesinde Cihazı serbest bırak seçeneğini seçin. Bu cihaz serbest bırakılsın mı? iletişim kutusu şunları açıklar:

• Cihaz bu hesaptan çıkar ve bağlantısı kapatılır.
• Verileri bu hesabın geçmişinde kalır.
• Bir sonraki sahibin cihazı eklemek için fiziksel erişime ihtiyacı vardır.
• Cihazın fabrika ayarlarına döndürülmesi onu serbest bırakmaz: yalnızca bu işlem bunu yapar.

Onaylamak için seri numarasını yazın ve isteğe bağlı bir neden girin. Cihaz fabrika havuzuna geri döner.

Bir cihaz, kendi Bulut sayfasındaki Serbest bırak düğmesiyle de serbest bırakılabilir. Bu durumda “Bir cihaz hesabınızdan kendi kendine serbest bırakıldı” bildirimi alırsınız. Ekibinizden kimse bunu yapmadıysa destek ile iletişime geçin.

İlgili

• Lisanslı cihazlar
• Cihaz kimliği ve sahiplenme güvenliği
• Cihazlar listesi ve cihaz sayfası