Kiracılar ve projeler

Merkez'deki hemen her şey bir kiracıya ve genelde onun içindeki bir projeye aittir. Bunları baştan doğru kurmak önemlidir; sonradan taşımak, baştan doğru yerleştirmekten zordur.

Kiracılar

Kiracı bir kurumdur. Kiracılar iç içe geçer: bir operatör bayileri, bayiler son müşterileri barındırabilir. Bir kiracı kendini ve altındaki her şeyi görür; üstündekini ve yanındakini görmez.

Una (operatör)
├── Bayi A
│   ├── Su İdaresi
│   └── Tesis Yönetimi
└── Bayi B
    └── Belediye

Bayi A, Su İdaresi'ni ve Tesis Yönetimi'ni görür. Bayi B'yi göremez; Su İdaresi de kardeşini göremez.

Aktif kiracı

Kenar çubuğu aktif kiracıyı gösterir. Bu bir süs değildir — oluşturduğunuz her şeyin nereye düşeceğine ve her listede ne göreceğinize karar verir.

Birden fazla kiracıya üyeyseniz, bir şey oluşturmadan önce kontrol edin. Yanlış kiracıda oluşturulan bir cihaz, doğru kiracıdan görünmez.

Kiracının ağ tarafı

Bir kiracının, kendisine tanınan her ağda bir de yuvası vardır: bir Sigfox grubu, bir The Things Stack organizasyonu, bir ChirpStack kiracısı. Kiracı oluşturma her teknoloji için bir adımla biter ve aynı paneller sonradan kiracı sayfasında durur. Her biri iki yol sunar — Merkez'den oluşturmak ya da ağda zaten var olanla başlamak (canlı listeden seçilir; canlı okuma kapalıysa id ile). Var olanla başlamak ağa hiçbir şey yazmaz; Merkez id'yi kaydeder ve altındaki her şeyi oraya asar.

The Things Stack'te kiracı sağlaması bir şey daha yapar. Merkez, o organizasyon üzerinde una-center adlı bir organizasyon API anahtarı üretir — yalnızca ihtiyaç duyduğu haklarla, asla "tüm haklar"la — ve kiracının yönetilen kimlik bilgisi tts-auto olarak saklar. O andan itibaren kiracının LNS'e yaptığı her çağrı kendi organizasyon anahtarıyla çıkar; kiracıyı kaydetmek adını organizasyona yazar; panel anahtarın hâlâ LNS'te olup olmadığını gösterir ve Organizasyon anahtarını döndür seçeneğini sunar. Başka bir kiracının zaten üzerinde çalıştığı bir organizasyon seçicide gösterilir ama sunulmaz.

Kimse kiracı başına anahtar yapıştırmaz. Platform (ya da bayi) kiracısı tek bir The Things Stack kimlik bilgisi tutar — organizasyon ve uygulama hakları olan kişisel ya da organizasyon API anahtarı — ve bir alt kiracı üst kiracısının (ya da platformun) anahtarıyla sağlanır: üstteki anahtar alttakini üretir; tıpkı Sigfox'un alt kiracıları platform ana anahtarıyla sağlaması gibi.

Projeler

Proje bir dağıtımdır: bir grup cihaz, konuştukları entegrasyonlar ve aralarındaki yönlendirme ile kurallar. Cihazlar, entegrasyonlar, yönlendirmeler ve kurallar tam olarak bir projeye aittir.

Nasıl bölünür

İşe yarayan soru şudur: "bu cihazlar aynı veri hattını mı paylaşıyor?"

• Aynı proje, cihazlar aynı hedeflere aynı biçimde veri gönderiyorsa. Tek bir faturalama sistemine rapor veren yirmi apartman bloğu tek projedir.
• Farklı projeler, yönlendirme farklıysa. Test uç noktasına gönderen bir pilot ile üretime gönderen bir yaygınlaştırma, aynı müşteri için bile iki projedir.

Bundan daha ince bölmek, aynı yönlendirme ve kuralları birden çok yerde tekrarlamak ve elle senkron tutmak demektir.

Sağlayıcı varsayılanları

Bir proje sağlayıcı varsayılanları tutabilir — yeni cihazların her seferinde yeniden yazılmak yerine devraldığı ayarlar. Sigfox için bu, yeni cihazların oluşturulacağı varsayılan cihaz tipidir; LoRaWAN için yeni cihazların kaydolduğu radyo varsayılanları — frekans planı, LoRaWAN sürümü, sınıf ve MAC ayarları.

Bir cihaz devraldığı değeri geçersiz kılabilir. Varsayılan bir kolaylıktır, kısıt değil.

Nerede: Projeler → projeniz → Sağlayıcı varsayılanları.

Proje başına tek LNS uygulaması

The Things Stack kaynağı olan bir proje, kiracının organizasyonu altında LNS'te tam olarak tek bir uygulamaya karşılık gelir. Bağlama — kaynak sihirbazından ya da projenin The Things Stack panelinden — uygulamayı oluşturur (ya da mevcut birini seçer), oradan projenin kaynağına giden bir webhook ve o kaynakta tutulan bir una-center uygulama anahtarı kurar. Panel bağlantıyı, webhook olaylarını, anahtarın hâlâ LNS'te olup olmadığını gösterir ve webhook kaydığında uyarır — Yeniden uygula düzeltir; Uygulama anahtarını döndür bir sonraki uygulamada yeni bir anahtar üretir.

Uygulamayı değiştir, projeyi başka bir uygulamaya yöneltir; önce mevcut olanın bağlantısı kaldırılır ve kendisi korunur. Bağlantıyı kaldır, webhook'u ve Merkez'in anahtarını uygulamadan alır, projenin cihaz varsayılanlarını korur — LNS’teki uygulamayı da sil seçeneğini yalnızca başka hiçbir şeyin kullanmadığı bir uygulama için işaretleyin; uç cihazları da onunla gider. Projeyi ya da The Things Stack kaynağını silmek aynı biçimde bağlantıyı kaldırır ve uygulamayı korur.

Ne nereye ait

Profiller ve çözücüler bilerek kiracı düzeyindedir: bir cihaz modeli, başka bir yere kurdunuz diye değişmez; bir kez tanımlar, her projede kullanırsınız.

Sırada