Bir kaynak bağlayın
Kaynak, mesajların geldiği yerdir. Bir kaynak bağlamak, entegrasyonu oluşturmak ve ardından ağı ortaya çıkan uç noktaya yönlendirmek demektir.
Entegrasyonu oluşturun
Entegrasyonlar → Yeni entegrasyon, yön Kaynak (sol), sağlayıcıyı seçin.
Sağlayıcı geri arama için kimlik doğrulaması istiyorsa bir kimlik bilgisi
bağlayın — bkz.
Sağlayıcı kimlik bilgileri.
Bir uç nokta seçin
Merkez birden fazla adres verir ve bunlar neyi sabitlediklerine göre farklılaşır. Hepsi aynı yükleri kabul eder.
| Uç nokta | Sabitlediği | Ne zaman |
|---|---|---|
…/ingest/source/{sk_key} | tam olarak bu kaynak | Normal durum. Tahmin yok. |
…/ingest/project/{pk_key} | proje | Birkaç kaynak için tek adres; Merkez hangisi olduğunu çıkarır. |
…/ingest/device/{dk_key} | tek bir cihaz | Gönderen tek bir cihaz adına konuşuyor ve kimliğini yazmıyorsa. |
…/webhooks/{integrationId} | tam olarak bu kaynak | Özgün biçim; anahtarlı adresler genelde daha kullanışlıdır. |
Adresi entegrasyon listesinden veya Akış → Uç nokta ve şema'dan kopyalayın.
Okunabilir adresler
Anlamsız bir sk_7f3a… anahtarı bir makine için uygundur, bir e-postada
zahmetlidir. Bir kısa ad (slug) tanımlarsanız kısa bir bağlantı alırsınız:
https://merkeziniz/i/baylan-hatay-proje1 ← proje kısa adı
https://merkeziniz/i/s/sigfox-hatay-bidir ← kaynak kısa adı
Kısa adlar küçük harf, rakam ve tireden oluşur ve en az altı karakterdir. Proje ve kaynak kısa adları bağımsız alanlardır; aynı sözcük ikisinde de kullanılabilir.
Kısa adlar tasarım gereği tahmin edilebilirdir — amaçları budur. Varsayılan olarak kapalıdırlar ve güvenlik açısından hiçbir şeyi değiştirmezler: yükü yine adaptör doğrular. Anahtarlı adres, kısa adın yanında çalışmaya devam eder.
Nerede: Akış → Uç nokta ve şema, ya da entegrasyon.
Güvenceye alın
Paylaşılan gizli anahtar
Çoğu sağlayıcı her geri aramada bir gizli anahtar gönderebilir ve adaptör bunu denetler. Entegrasyonda tanımlayın, aynı değeri ağın callback ayarında da tanımlayın. Asıl kimlik doğrulaması budur. The Things Stack kaynağında Merkez bunu, kaynağı bağlarken LNS webhook'una kendisi yazar — kopyalanacak bir şey yoktur.
Zorunlu başlıklar
Bir kaynak, her gelen istekte belirli başlıkları zorunlu kılabilir. Bir başlığı zorunlu işaretlerseniz, onu taşımayan istekler başka hiçbir şey olmadan önce reddedilir.
Yükün önünde ikinci bir katman olarak ya da zaten bir yönlendirme başlığı isteyen bir ağ geçidini karşılamak için kullanışlıdır. Zorunlu olmayanlar yalnızca gösterim amaçlıdır — göndereni yapılandıran kişinin ne göndereceğini bilmesi için uç noktanın yanında listelenir.
Anahtar döndürme
Döndür, yeni bir uç nokta anahtarı verir ve eskisini anında geçersiz kılar. Geçiş süresi yoktur; önceki adrese POST etmeye devam eden her arka uç o anda başarısız olmaya başlar.
Bir anahtar fazla geniş paylaşıldıysa veya sızdıysa döndürün. Planlayın: tüm göndericileri aynı bakım aralığında güncelleyin.
Tanımlı bir kısa ad döndürmeden etkilenmez — kısa ad adresi çalışmaya devam eder, çünkü anahtara değil entegrasyona çözümlenir.
Yükü tanımlayın
Uç nokta ve şema ayrıca beklediğiniz yük biçimini kaydetmenizi sağlar. Bu, göndereni yapılandıran kişinin ne göndereceğini görmesi için uç noktanın yanında yayımlanır.
Belgelemedir, doğrulama değildir — Merkez mesajları buna uymadığı için reddetmez.
Ağı buraya yönlendirin
Son olarak sağlayıcı tarafındaki callback'i yapılandırın. Sigfox'ta bu, cihaz tipinin callback'leri üzerindedir; Merkez bunları sizin için de kaydedebilir.
The Things Stack adımı
The Things Stack kaynağının karşılığı, kaynak sihirbazındaki The Things Stack adımıdır (Akış → Kaynak ekle, ya da Entegrasyonlar → Yeni entegrasyon). The Things Stack’e bağla açık kalırsa gözden geçirme adımı, kaynağı oluştururken bağlar — projenin Una LNS'indeki uygulaması (Yeni uygulama oluştur, ya da sahibi ve adıyla seçilen Mevcut bir uygulamayı kullan), o uygulamadan bu kaynağın uç noktasına giden bir webhook ve Merkez'in cihaz kaydetmek ile downlink göndermek için kullandığı uygulama anahtarı. Bağlama, diğer her adım gibi bir görev olarak çalışır ve yeniden denenebilir.
LNS'e dokunmadan kaynağı oluşturmak için kapatın. Daha sonra aynı adımdan ya da proje sayfasının The Things Stack panelinden bağlayabilirsiniz. Akış'ta kaynak kartı bir LNS rozeti taşır — … LNS uygulamasına bağlı ya da Henüz LNS’e bağlı değil — bağlamak için açın — ve adımı açar. Bir projenin tek bir LNS uygulaması ve tek bir webhook'u vardır; ikinci bir kaynak üzerinden bağlamak webhook'u oraya taşır (Yeniden bağla).
LNS konsoluna hiçbir şey yapıştırılmaz: uygulamayı, webhook'u, gizli anahtarını ve API anahtarını Merkez yazar; bağlantı kurulduktan sonra LoRaWAN cihazları, siz oluşturdukça kendileri kaydolur.
Bir test uplink'i gönderin, sonra Analitik'e bakın. Alınan arttıysa
bağlantı çalışıyor demektir.