Protokoly a formáty

Každá distribuce Data Push kombinuje dvě nezávislé volby:

• Protokol spojení - jak Dronetag posílá data do vašeho systému.
• Výstupní formát - jak je zakódovaná každá telemetrická zpráva.

Většina formátů je technicky nezávislá na přenosu, ne každá kombinace má ale v praxi smysl. Protokol vyberte podle toho, jak váš systém data přijímá, a formát podle toho, co umí váš cílový systém zpracovat.

Doporučené kombinace

Produkt / název integrace	Doporučený protokol	Doporučený výstupní formát	Obvyklé nastavení
Vlastní HTTP API nebo webhook	HTTP Webhooks	DUMP JSON, DUMP JSON Typed nebo partnerský socketový formát	Použijte cílovou URL s HTTPS, podle potřeby HTTP Basic Authentication nebo OAuth 2.0 a vlastní hlavičky pro klíče API nebo ID tenantů.
Vlastní telemetrický kanál přes MQTT	MQTT Client	DUMP JSON, DUMP JSON Typed nebo partnerský socketový formát	Pokud je to možné, použijte MQTT přes TLS, ověřování jménem a heslem, QoS podle požadavků vašeho brokeru a {msgtype} v tématu (topic), pokud chcete zprávy směrovat podle typu.
Vlastní kanál přes TCP socket	TCP Socket	DUMP JSON, DUMP JSON Typed nebo partnerský socketový formát	Při přenosu přes veřejné sítě použijte TLS nebo mTLS. Vložená metadata zapněte, jen pokud s obálkou váš přijímač počítá.
Vlastní kanál přes UDP socket	UDP Socket	DUMP JSON nebo DUMP JSON Typed nebo partnerský socketový formát	Použijte jen tehdy, když je ztráta paketů přijatelná. Pokud to přijímač podporuje a síťová cesta není důvěryhodná, přidejte šifrování obsahu AES.
TAK Server / kanál CoT	TCP Socket	Cursor on Target XML	Pokud nasazení TAK vyžaduje klientské certifikáty, použijte TCP s mTLS.
Kanál SAPIENT	TCP Socket	SAPIENT	Nastavte režim protokolu TCP na sapient, podle potřeby nastavte interval stavových zpráv (heartbeat) a pokud přijímající uzel vyžaduje zabezpečení certifikáty, použijte TLS/mTLS.

Matice kompatibility

Výstupní formát	HTTP Webhooks	MQTT Client	TCP Socket	UDP Socket	Poznámky
DUMP JSON	Doporučeno	Doporučeno	Podporováno	Podporováno	Nejlepší výchozí volba pro vlastní integrace.
DUMP JSON Typed	Doporučeno	Doporučeno	Podporováno	Podporováno	Stejné jako DUMP JSON, navíc s polem $type v obsahu zprávy.
Cursor on Target XML	Možné	Nepodporováno	Doporučeno	Možné	Používají ho systémy kompatibilní s TAK.
SAPIENT	Nepodporováno	Nepodporováno	Doporučeno	Nepodporováno	Vyžaduje režim protokolu TCP SAPIENT.

Názvy produktů

Některé integrace jsou známější pod názvem produktu nebo ekosystému než pod svým protokolem a formátem:

Protokol + formát	Produkt / název integrace
HTTP Webhooks + DUMP JSON	Vlastní webhook / vlastní integrace API
MQTT + DUMP JSON	Vlastní integrace MQTT
TCP nebo UDP + Cursor on Target XML	Integrace TAK Server
TCP + SAPIENT	Integrace SAPIENT

Názvy v portálu a možnosti zabezpečení

Portál integrací používá tyto názvy typů spojení:

Typ spojení v portálu	Kompatibilní způsoby ověřování	Zabezpečení přenosu a obsahu
HTTP Webhooks	HTTP Basic Authentication, OAuth 2.0	Cílová URL s HTTPS
MQTT Client	HTTP Basic Authentication	MQTT přes TLS, šifrování dat AES
TCP Socket	Žádné	TLS/mTLS, šifrování dat AES
UDP Socket	Žádné	Šifrování dat AES

Pokud váš přijímač ověřování nevyžaduje, můžete ho nechat prázdné. V této tabulce jsou HTTPS, MQTT over TLS a TLS/mTLS možnosti zabezpečení přenosu a AES data encryption je šifrování obsahu zprávy, nikoli způsob přihlášení. Popisek HTTP Basic Authentication se v portálu používá i pro jméno a heslo k MQTT.

Nastavení mTLS portál zobrazuje jen u distribucí typu TCP Socket. Portál přijímá buď samostatné soubory PEM, nebo balíčky PKCS#12 .p12:

• PEM: certifikát CA, klientský certifikát, soukromý klíč klienta a volitelné heslo ke klíči klienta.
• PKCS#12: truststore .p12 s jedním nebo více certifikáty pro ověření serveru a klientský .p12 s klientským certifikátem a odpovídajícím soukromým klíčem. Každý balíček může mít vlastní volitelné heslo. Portál oba balíčky před použitím v integraci převede do formátu PEM.
• Verify host ověřuje název hostitele serveru proti certifikátu TLS.

Zvolený Data Source (zdroj dat) určuje, které zprávy smí cíl distribuce dostávat, ještě před převodem protokolu nebo formátu. Které typy zpráv umí jednotlivé výstupní formáty odeslat, popisuje stránka Pokrytí zpráv.

Portál nabízí také nastavení doručování:

• Keep reliable určuje chování, když zprávy nelze doručit.
• Throttle messages omezuje, jak často vám Dronetag data posílá.
• Allow mixed content povoluje více typů zpráv v jednom požadavku, pokud to zvolený výstupní formát podporuje.
• Send empty payloads posílá v intervalu omezení prázdný požadavek i tehdy, když nejsou k dispozici žádná nová telemetrická data. Vyžaduje zapnuté omezování (throttling).

Obvyklé sady nastavení

HTTP Webhooks API

Použijte pro vlastní API, webhooky a většinu integrací s API partnerů.

Obvyklé nastavení:

• Cílová URL začíná https://.
• Ověřování je HTTP Basic Authentication, OAuth 2.0, způsob specifický pro partnera nebo vlastní HTTP hlavičky.
• Další hlavičky mohou nést klíče API, identifikátory tenantů nebo volbu prostředí.

MQTT Client

Použijte, když vaše infrastruktura očekává telemetrii v tématech (topics) MQTT.

Obvyklé nastavení:

• Cílová URI a port ukazují na váš broker MQTT.
• Přenos je tcp nebo websockets podle vašeho brokeru.
• Pokud to broker vyžaduje, je nastavené ověřování jménem a heslem.
• Téma může obsahovat {msgtype} pro směrování DUMP JSON.
• QoS je obvykle 0 nebo 1 podle toho, zda je důležitější nízká latence, nebo potvrzení doručení.

TAK / CoT

Použijte pro TAK Server, ATAK, WinTAK, iTAK nebo middleware kompatibilní s TAK.

Obvyklé nastavení:

• Výstupní formát je Cursor on Target XML.
• Protokol je obvykle TCP nebo UDP socket.
• TCP je vhodnější, když potřebujete stav spojení a spolehlivější doručování.
• UDP je běžné u jednoduchých kanálů CoT, kde občasná ztráta paketu nevadí.
• Pokud váš TAK Server vyžaduje klientské certifikáty, lze u TCP zapnout mTLS.

SAPIENT

Použijte jen pro systémy, které SAPIENT výslovně implementují.

Obvyklé nastavení:

• Protokol je TCP Socket.
• Výstupní formát je SAPIENT.
• Režim protokolu TCP je sapient.
• Pokud to přijímající uzel vyžaduje, je nastavený interval stavových zpráv (heartbeat).
• Pokud to nasazení SAPIENT vyžaduje, je zapnuté TLS nebo mTLS.

Poznámky k protokolům

HTTP Webhooks

HTTP je nejlepší volba, pokud váš systém poskytuje endpoint API. Dronetag posílá na vaši cílovou URL požadavky POST. URL musí začínat http:// nebo https://.

Nešifrované HTTP používejte jen při vývoji a testování. Pro produkční prostředí důrazně doporučujeme HTTPS.

HTTP může přenášet metadata v hlavičkách, například typ obsahu, typ zprávy, client ID integrace a viditelnost veřejných dat. Pro distribuci můžete nastavit i další vlastní HTTP hlavičky.

HTTP používejte pro formáty API specifické pro partnery, například Altitude Angel, ASTRA, Highlander a podobné integrace.

MQTT Client

MQTT je nejlepší volba, pokud váš systém už provozuje broker MQTT a očekává telemetrii v tématech. Dronetag se připojí jako klient MQTT a převedené zprávy publikuje do nastaveného tématu.

MQTT se dobře hodí pro obsah ve formátu JSON. Pokud používáte DUMP JSON, můžete do názvu tématu vložit {msgtype} a směrovat tak telemetrii UA, telemetrii operátora, systémovou telemetrii a změny operací do samostatných témat.

TCP Socket

TCP se hodí, když cílový systém očekává trvalé socketové spojení. Je to také doporučený protokol pro SAPIENT a jeden z doporučených protokolů pro TAK Server.

Pro SAPIENT nastavte režim protokolu TCP na sapient. Tím se zapne registrační postup SAPIENT a binární zprávy s délkovou předponou.

TCP může také používat TLS nebo vzájemné TLS (mutual TLS), pokud váš cíl vyžaduje zabezpečení certifikáty.

UDP Socket

UDP se hodí pro jednoduché doručování bez potvrzení (fire-and-forget), zejména při integraci se systémy, které už kanály UDP přijímají, například některá nasazení TAK.

Protože UDP nepotvrzuje doručení, použijte TCP nebo HTTP, pokud vaše integrace vyžaduje spolehlivější doručování.

Metadata

HTTP posílá metadata v hlavičkách požadavku. MQTT, TCP a UDP mohou u formátů, kde je to užitečné, metadata volitelně vkládat do obsahu zprávy.

Vložená metadata obalí obsah zprávy objektem s poli data a metadata. Používejte je jen tehdy, když je váš přijímač napsaný tak, aby tuto obálku zpracoval.

Když si nejste jisti

U vlastních integrací začněte takto:

1. HTTP Webhooks + DUMP JSON, pokud vaše služba může poskytnout endpoint HTTPS.
2. MQTT + DUMP JSON, pokud vaše infrastruktura už MQTT používá.
3. TCP + Cursor on Target XML, pokud se napojujete na TAK Server.
4. TCP + SAPIENT, pokud váš cílový systém SAPIENT výslovně vyžaduje.