Bir cihazı kuruluşunuza eklemenin birkaç yolu vardır. Bu sayfa en çok kullandığınız üç yolu kapsar: 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.
| Yol | Kullanım amacı | Gereksinimler |
|---|---|---|
| Elle ekle | Kendiniz kurduğunuz birkaç cihaz | Cihaz oluşturma (Yönetici) |
| Kendi kendine provisioning | Kendilerini kaydeden, aynı türden çok sayıda cihaz | Provisioning yönetimi (Yönetici) |
| Sahiplenme | Fabrika kimliğine sahip lisanslı cihazlar | Cihazları sahiplenme (Yönetici) |
Yeni cihaz çekmecesi
Cihazlar bölümünü açın ve Yeni cihaz seçeneğini seçin. Kuruluşunuzda birden fazla giriş yolu olduğunda çekmece Ne ekliyorsunuz? sorusunu sorar:
| Seçenek | Ekler |
|---|---|
| Lisanslı cihaz seçeneği (“Bulut sayfasındaki kodla: tarayın veya yazın.”) | Lisanslı bir yönlendirici, ağ geçidi veya denetleyici; sahiplenerek |
| Kamera veya kayıt cihazı | Bir IP kamera veya kayıt cihazı. Bkz. Kamera veya kayıt cihazı ekleme. |
| Ağ cihazı | Bir SNMP ajanı veya platformun sorguladığı başka bir kutu. Bkz. Protokol uç noktaları. |
| LoRaWAN ağ geçidi | Bir Basics Station ağ geçidi. Bkz. LoRaWAN ağ geçidi ekleme. |
| LoRaWAN cihazı | Bir LoRaWAN sensörü. Bkz. OTAA cihaz ekleme. |
| Diğer cihaz | Doğrudan MQTT veya HTTP üzerinden bağlanan herhangi bir cihaz |
Bir seçenek yalnızca ilgili modülü açık olduğunuzda ve izinlerine sahip olduğunuzda görünür. Başka bir yol seç seçeneği listeye geri döner.
Cihazı elle ekleme
- Çekmecede Diğer cihaz seçeneğini seçin.
- Bir Ad girin (kuruluşunuz içinde benzersiz, en fazla 128 karakter), isteğe bağlı bir Etiket yazın ve Cihaz profili seçin (hiçbirini seçmezseniz Varsayılan profil).
- Bu cihaz bir ağ geçididir seçeneğini yalnızca diğer cihazlar adına rapor veren bir cihaz için açın.
- Cihaz oluştur seçeneğini seçin.
- Erişim belirtecini şimdi kopyalayın: yalnızca bir kez gösterilir. Bittiğinde Sakladım seçeneğini veya Cihazı aç seçeneğini seçin.
Kuruluşunuzun cihaz ayarları, yeni bir cihaza hemen erişim belirteci verilip verilmeyeceğini belirler: Yeni cihazlar için 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 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 gizli anahtarını bilir. İlk başlatmada kendi kimlik bilgisini Hermetry’den ister; bu yüzden her cihazı önceden tek tek oluşturmanız gerekmez.
Profili ayarlayın
- Profili ve Provisioning sekmesini açın.
- Provisioning stratejisi seçin:
| Strateji | Davranış |
|---|---|
| Devre dışı | Her istek başarısız olur (strategy_disabled). |
| Yeni cihaz oluşturmaya izin ver | Hermetry, cihazın gönderdiği adla bir cihaz oluşturur ve kimlik bilgisini döndürür. Cihaz Karantinada olarak başlar. |
| Yalnızca önceden provizyonlanmış cihazlar | Yalnızca önceden (ada göre) oluşturduğunuz cihazlar provisioning yapabilir. Anahtar yazılımda bulunabileceğinden, toplu satılan cihazlar için önerilir. |
- Kaydedin, ardından Provisioning anahtarları bölümünde Anahtar oluştur seçeneğini seçin. Gizli anahtarı kopyalayın: “Gizli anahtarı ş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 görünür. Anahtar düğmeleri hemen etki eder; Değişiklikleri kaydet işleminin parçası değildir.
Not
Allow creating new devices ile oluşturulan bir cihaz karantinada bekler: bağlanabilir, ancak bir yönetici etkinleştirene kadar verileri atılır. Karantinadaki cihazlar cihaz limitinize dahil edilir. Bkz. Kendini kaydeden cihazlar için karantina.
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ımlayın:
{"deviceName": "boiler-07", "provisionDeviceKey": "pk_8f3b2c1e9d4a7b60", "provisionDeviceSecret": "ps_1c9e7f2a4b6d8e03"}
v1/provision/res üzerindeki yanıt:
{"status": "SUCCESS", "credentialsType": "ACCESS_TOKEN", "credentialsValue": "aZ3…"}
Cihaz bundan sonra yeni kimlik bilgisiyle giriş yapar. HTTPS üzerinden aynı gövdeyi taşıyıcı üstbilgisi olmadan POST /api/v1/provision adresine gönderin; reddedilen istek de 200 ile yanıt verir ve "status": "FAILURE" içerir.
| Red | Anlamı |
|---|---|
device_exists | Bu adla bir cihaz zaten var. Hermetry, var olan bir ad için kimlik bilgisini asla yeniden vermez. |
provision_key_invalid | Bilinmeyen anahtar veya yanlış gizli anahtar. |
provision_key_revoked | Anahtar iptal edildi veya geçiş süresi sona erdi. |
strategy_disabled | Profilin stratejisi Devre dışı. |
rate_limited | Çok fazla istek (aşağıdaki sınırlara bakın). |
Sınırlar: anahtar başına saatte başarılı provisioning (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 gizli anahtar oluşturur. Eski anahtar Eski anahtarın çalışmaya devam edeceği gün sayısı kadar kabul edilmeye devam eder (varsayılan 30, 0 ile 365 arası; 0 hemen durdurur), ardından otomatik olarak iptal edilir. Bundan sonra kurduğunuz 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: gizli anahtar yanlışlıkla paylaşıldı.”). Daha önce kaydolmuş cihazlar çalışmaya devam eder.
Lisanslı bir cihazı sahiplenme
Lisanslı router’lar, gateway’ler ve controller’lar fabrikadan kendi kimlikleriyle çıkar: bir seri numarası, bir sertifika ve bir claim secret. Siz sahiplenmeden önce hiçbir organizasyona ait değildir ve Hermetry verilerini atar.
Sahiplenin
- 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.
- Aynı sayfada Sahiplenme penceresini aç seçeneğine basın. Pencere 15 dakika açık kalır.
- Hermetry’de Cihazlar > Yeni cihaz bölümünü açın ve lisanslı cihaz seçeneğini seçin.
- Kodu nasıl gireceğinizi 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ğin7KQ2-M9XH-D4TB-6WRA-1NZC) yazın.
- Denetle seçeneğini seçin. Eklemeye hazır ekranında bir Cihaz adı girin (boş bırakılırsa seri numarası kullanılır).
- 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şunuz içinde yeniden başlar.
Not
Basılı bir sahiplenme etiketi yoktur. QR kod ve sahiplenme kodu yalnızca cihazın yerel panelinde, oturum açma ekranının arkasında gösterilir.
Sahiplenme başarısız olduğunda
| Mesaj | Anlamı |
|---|---|
| “Cihazdaki sahiplenme penceresi kapalı. …” | Bulut sayfasında Sahiplenme penceresini aç seçeneğine basın, ardından 15 dakika içinde yeniden deneyin. |
| “Bu cihaz başka bir hesaba ait. …” | Satıcıdan veya önceki sahipten cihazı serbest bırakmasını isteyin, ardından yeniden deneyin. |
| “Seri numarası veya sahiplenme kodu doğru değil. …” | Her ikisini cihazın Bulut sayfasında kontrol edin. |
| “Şu an için çok fazla deneme yapıldı. Bir saat bekleyip yeniden deneyin.” | Başarısız sahiplenmeler seri numarası başına 5, kullanıcı başına 20 ve adres başına saatte 30 ile sınırlıdır. |
| “Planınızın cihaz limitine ulaşıldı. …” | Önce bir cihazı kaldırın veya planınızı yükseltin. |
| “Bu cihaz şu anda ekleniyor. …” | Bir an bekleyin ve cihaz listesini kontrol edin. |
| “Bu cihaz zaten bu hesapta.” | Yapılacak bir şey yok. |
API ile talep etme
POST/tenant/{tenantId}/api/iot/claim
Lisanslı bir cihazı seri numarası ve talep kodu ile talep edin. İsteğe bağlı: yeni cihaz için name, cihazı hemen yerleştirmek için iotAssetId ve talep etmeden neyin talep edileceğini kontrol etmek için dryRun (deneme çalıştırması da gerçek talep gibi deneme sınırına sayılır). Talep kodu hiçbir zaman geri döndürülmez. Bir talep reddedildiğinde, details.reason içinde not_claimable, bad_secret, press_claim_button, device_limit veya rate_limited değerlerinden biri yer alır.
İstek gövdesi application/json
{
"serial": "RT420-2610-000123",
"secret": "7KQ2M9XHD4TB6WRA1NZC",
"name": "Pump house router"
}
Örnek curl
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"}'
Yanıtlar
201Oluşturuldu
{
"status": "claimed",
"serial": "RT420-2610-000123",
"deviceId": "…",
"model": "…",
"profileId": "…"
}
200Tamam
{
"status": "claimable",
"serial": "RT420-2610-000123",
"model": "…",
"type": "…",
"hw": "…"
}
400Hatalı İstek
{
"message": "The serial or claim code is not correct.",
"code": "VALIDATION_ERROR",
"details": {
"reason": "bad_secret"
}
}
403Yasak
{
"message": "…",
"code": "FEATURE_NOT_AVAILABLE",
"details": {
"reason": "device_limit"
}
}
409Çakışma
{
"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"
}
}
429Çok Fazla İstek
{
"message": "…",
"code": "RATE_LIMIT_EXCEEDED",
"details": {
"reason": "rate_limited"
}
}
"status": "claimable" içeren 200 yanıtı, bir deneme çalıştırmasını yanıtlar. Kuruluşunuzun zaten sahip olduğu bir cihazın talebi, "status": "claimed" ve "alreadyOwned": true içeren 200 yanıtı verir. Devam eden bir talep {"status": "in_progress", "serial": "…"} yanıtını verir. not_claimable ile birlikte gelen 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ın serbest bırakılması
Talep edilen bir cihazın Sahiplik sekmesi; Seri numarasını, Modeli, Sertifikayı (geçerlilik tarihine kadar) ve cihazın Bu hesaba eklendiği tarihi gösterir. Talep edilmek yerine hesabınızda oluşturulan bir cihaz Fabrika cihazı değil ifadesini gösterir.
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 ayrılır ve bağlantısı kapatılır.
- Verileri bu hesabın geçmişinde kalır.
- Bir sonraki sahibin cihazı eklemek için cihaza fiziksel olarak erişmesi gerekir.
- 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ı olarak bir neden girin. Cihaz fabrika havuzuna geri döner.
Cihaz, kendi Bulut sayfasındaki Serbest bırak düğmesiyle de serbest bırakılabilir. Bu durumda “Bir cihaz hesabınızdan kendiliğinden serbest bırakıldı” bildirimi alırsınız. Ekibinizden biri bunu yapmadıysa destekle iletişime geçin.

