SDS:POST upload - Historie editací

Adamn v 4. 7. 2024, 15:32

2024-07-04T15:32:01Z

Adamn v 4. 7. 2024, 15:20

2024-07-04T15:20:52Z

Adamn v 23. 10. 2023, 13:33

2023-10-23T13:33:58Z

Adamn v 16. 7. 2023, 08:05

2023-07-16T08:05:55Z

Adamn v 8. 3. 2023, 16:27

2023-03-08T16:27:32Z

Adamn v 8. 3. 2023, 15:58

2023-03-08T15:58:12Z

Adamn v 28. 2. 2023, 09:42

2023-02-28T09:42:01Z

Adamn v 28. 2. 2023, 08:13

2023-02-28T08:13:41Z

Adamn v 28. 9. 2022, 09:04

2022-09-28T09:04:25Z

Adamn v 15. 6. 2022, 06:51

2022-06-15T06:51:43Z

← Starší verze		Verze z 4. 7. 2024, 15:32
Řádek 627:		Řádek 627:

	INFORMACE - oficiální popis Protokolu #2 zde bude brzy uveden. Mezitím pro bližší informace kontaktujte ANE.		INFORMACE - oficiální popis Protokolu #2 zde bude brzy uveden. Mezitím pro bližší informace kontaktujte ANE.
		+
		+
		+	== Celková bezpečnostní konsiderace ==
		+
		+	Využití protokolu HTTP, i přes přítomnost bezpečného způsobu autorizace, přináší riziko tzv. "únosu session" - kdy útočník (MiTM) může počkat, až provedete autorizaci, a pak vymění vaši následnou komunikaci za svou. Toto se mu ale může podařit jen v ten moment, kdy skutečně autorizaci provedete - to ale nijak bezpečnost nezvyšuje, jen nepatrně omezuje možnosti útočníka (pokud má čas čekat, tak se eventuálně dočká, byť sám od sebe se nikam nemůže dostat, musí počkat na vás).
		+
		+	Jedná se tedy o kvalifikovanou úvodní autorizaci přístupu, ale nejedná se o následné pokračující zabezpečení datového tunelu. Toho lze plnĚ dosáhnout až teprve při použití HTTPS, viz dále.
		+
		+	Úroveň zabezpečení HTTP pomocí autorizace hashovaným heslem (algoritmus SHA-256) je na odpovídající úrovni dle očekávaného použití tohoto přístupu - dle Security Requirements zde jde o zamezení přístupu v důvěrném prostředí při neznalosti hesla, tedy především např. zamezení omylu při hromadné konfiguraci a podobné případy. Provozovatel, při použití tohoto HTTP schematu, musí fyzicky zabezpečit celou síťovou trasu a použité prostředky tak, aby nebylo možné provést MiTM útok.
		+
		+	Pro úplné zabezpečení je jednoznačně doporučeno používat pro komunikaci protokol HTTPS, kterým je zařízení SDS BIG vybaveno. Tento protokol pracuje s TLS vrstvou, která zaručuje, že po celou dobu komunikace, vy (jako klient) víte, že se bavíte stále a pouze se serverem (zařízení SDS), a není tak možné provést zmíněné MiTM. To samozřejmě vyžaduje jeden specifický krok na straně klienta, a to ověření certifikátu, kterým se server (SDS) vám jako klientovi prezentuje (ideálně ověření ve vašem důvěryhodném PKI stromu, vůči patřičnému root nebo leaf certifikátu, důvěrně dostupném vám jako klientovi).
		+
		+	Protokol HTTP je v zařízení SDS stále k dispozici, protože u zákazníků jsou požadavky na úvodní provisioning zařízení SDS v důvěrných podmínkách (vlastní bezpečné prostory). Provede se takto nahrání TLS certifikátu/klíčů, a pak už se dále trvale pokračuje jen a pouze přes HTTPS.

← Starší verze		Verze z 4. 7. 2024, 15:20
Řádek 625:		Řádek 625:

	Detaily budou teprve uvedeny. V současné chvíli je komunikace přes aplikační protokol typu #2 implementována ve webovém rozhraní SDS, specificky pro zaslání nových souborů s certifikátem/klíčem do SDS (za účelem konfigurace provozu HTTPS). Tento stejný protokol lze implementovat i ve vaší vlastní aplikaci atd.		Detaily budou teprve uvedeny. V současné chvíli je komunikace přes aplikační protokol typu #2 implementována ve webovém rozhraní SDS, specificky pro zaslání nových souborů s certifikátem/klíčem do SDS (za účelem konfigurace provozu HTTPS). Tento stejný protokol lze implementovat i ve vaší vlastní aplikaci atd.
		+
		+	INFORMACE - oficiální popis Protokolu #2 zde bude brzy uveden. Mezitím pro bližší informace kontaktujte ANE.

@@ Řádek 38: / Řádek 38: @@
 . '''[/wrdf]''' zápis stránky do USER DATA-FLASH
@@ Řádek 329: / Řádek 331: @@
    NTPofs:number         = pevný GMT offset (-11 až +11 hodin)
    NTPuseDST:flag        = daylight saving
-   SNMPwrite:flag        = povolit SNMP write
+   SNMPwrite:flag        = (obsolete): povolit SNMP write pro SNMPv1 komunitu #1 (další komunity viz příkaz "/snmp")
-   SNMPread:flag         = povolit SNMP read
+   SNMPread:flag         = (obsolete): povolit SNMP read pro SNMPv1 komunitu #1 (další komunity viz příkaz "/snmp")
-   SNMPcomm:text         = název SNMP komunity
+   SNMPcomm:text         = (obsolete): název SNMP komunity #1 (další komunity viz příkaz "/snmp")
    WebSDCnolog:flag      = povolit přístup na obsah SDC přes webové rozhraní bez nutnosti se přihlásit
    AutoLogoff:flag       = automatic user logoff
@@ Řádek 609: / Řádek 611: @@
 Pokud pošlete méně než 264 bajtů v rámci obsahu stránky (tedy ne úplnou stránku), je zápis proveden i v takovém případě, ale chybějící data jsou automaticky doplněna do celé velikosti (264B) hodnotou 0xFF. Vybraná stránka v DF je tedy v každém případě přepsána celá !

@@ Řádek 14: / Řádek 14: @@
 Často také chcete svým zákazníkům poskytnout vlastní GUI nebo jiné vlastní prostředky na ovládání SDS - zde je přesně ta možnost jak to otevřeně a bezpečně provést (další možnost pro ovládání je S-UDP protokol, viz jiná část této wiki).
-Pozn. ''Speciální firmware pro BIG-512 bude poskytovat HTTPS POST - nicméně protokol API atd. uvnitř komunikace s webovém serverem v SDS bude stále zcela stejné.''.
+SDS řady 512 (s aktuálním FW) poskytuje i HTTPS POST - nicméně protokol API atd. uvnitř komunikace s webovém serverem v SDS bude stále zcela stejné, jen je tam doplněno TLS.
 === Co se dá přes autorizovaný POST nahrát ===
 . '''[/changeip]''' změna konfigurace (IP atd.)
@@ Řádek 45: / Řádek 49: @@
-=== Zabezpečení ===
+* '''#2: Příkazy bez krypto-autorizace:'''
 Dle průmyslového standardu, je vždy potřeba se, jako klient, vhodným způsobem autorizovat vůči serveru. Metoda také musí odpovídat průmyslovému standardu a být plně auditovatelná uživatelem (proto je i zde popsána). K dispozici jsou i vzorové příklady (např. aplikace se zdrojovým kódem).
@@ Řádek 64: / Řádek 75: @@
-=== Detaily ===
+=== (#1) Detaily ===
 Probíhat může vždy jen jedno spojení. Je to logické, pokud se nahrává program, nelze v prostředku nahrávání začít posílat jiný (musí se počkat až se původní činnost dokončí).
@@ Řádek 71: / Řádek 82: @@
-== Protokol ==
+== (#1) Protokol ==
 Jedná se o standardní komunikaci s webovým serverem, kde je implementován specifický příkazový ping-pong. Na straně klienta ji lze realizovat libovolným způsobem, buď nějakou vaší knihovnou, nebo klidně prostřednictvím vlastního lowlevel kódu nad TCP socketem... důležité je dodržet dále popsanou specifikaci komunikace.
@@ Řádek 188: / Řádek 199: @@
-==== Vzorový záchyt ====
+==== (#1) Vzorový záchyt ====
 Pro tento příklad, Heslo je nastaveno na tyto čtyři písmena:
@@ Řádek 243: / Řádek 254: @@
-==== Autorizační mechanismus ====
+==== (#1) Autorizační mechanismus ====
 Základní popis:
@@ Řádek 269: / Řádek 280: @@
-==== Ukázky autorizace ====
+==== (#1) Ukázky autorizace ====
 Pro tento příklad, Heslo je nastaveno na tyto čtyři písmena:
@@ Řádek 292: / Řádek 303: @@
-==== Vzorová aplikace ====
+==== (#1) Vzorová aplikace ====
 Kontaktujte nás pro zaslání vzorové aplikace ve formě zdrojových kódů projektu (aktuálně dostupné pro Delphi), nebo přeložené spustitelné aplikace (Win32 exe).
@@ Řádek 299: / Řádek 310: @@
-== COMMAND: /changeip ==
+== (#1) COMMAND: /changeip ==
 Určeno k provedení změny konfigurace IP adres a dalších prvků, vše v jednom kroku.
@@ Řádek 380: / Řádek 391: @@
-== COMMAND: /sv ==
+== (#1) COMMAND: /sv ==
 Určeno k zápisu do sdílených proměnných programu FULL-C. ''Pro zařízení s SDS-C použijte jiný příkaz, viz dole.''.
@@ Řádek 422: / Řádek 433: @@
-== COMMAND: /newsdsc ==
+== (#1) COMMAND: /newsdsc ==
 Využito pro nahrání nového SDSC programu - ten je k dispozici formou obsahu .SCB souboru (tento soubor si vytvoříte ve SDSC.exe z vašeho zdrojového SDS-C programu).
@@ Řádek 434: / Řádek 445: @@
-== COMMAND: /newfullc ==
+== (#1) COMMAND: /newfullc ==
 Využito pro nahrání nového FULLC programu - ten je k dispozici formou obsahu .FCB souboru (tento soubor si vytvoříte ve FULLC.exe z vašeho zdrojového FULLC programu).
@@ Řádek 446: / Řádek 457: @@
-== COMMAND: /newuserweb ==
+== (#1) COMMAND: /newuserweb ==
 Využito pro nahrání nového UserWeb projektu - ten je k dispozici formou obsahu .UWB souboru (tento soubor si vytvoříte ve FULLC.exe dle standardního postupu pro sestavení UserWeb projektu).
@@ Řádek 458: / Řádek 469: @@
-== COMMAND: /firmware ==
+== (#1) COMMAND: /firmware ==
 Využito pro nahrání nového firmware pro SDS.
@@ Řádek 505: / Řádek 516: @@
-== COMMAND: /share ==
+== (#1) COMMAND: /share ==
 Určeno k zápisu do sdílených proměnných programu SDS-C. ''Pro zařízení s FULL-C použijte jiný příkaz, viz výše.''.
@@ Řádek 562: / Řádek 573: @@
-== COMMAND: /wrdf ==
+== (#1) COMMAND: /wrdf ==
 Určeno k zápisu celé jedné stránky (tzn. 264B) do uživatelského prostoru v Data-Flash (DF). Číslo stránky určuje klient, spolu se zapisovanými daty.
@@ Řádek 598: / Řádek 609: @@
 Pokud pošlete méně než 264 bajtů v rámci obsahu stránky (tedy ne úplnou stránku), je zápis proveden i v takovém případě, ale chybějící data jsou automaticky doplněna do celé velikosti (264B) hodnotou 0xFF. Vybraná stránka v DF je tedy v každém případě přepsána celá !

@@ Řádek 307: / Řádek 307: @@
   Položky:
    SystPwd:text          = systémové heslo
-   HostIP:ipaddr         = ip adresa zařízení SDS
+   HostIP:ipaddr         = ip adresa zařízení SDS | (restart)
-   NetMask:ipaddr        = síťová maska
+   NetMask:ipaddr        = síťová maska | (restart)
-   GwyIP:ipaddr          = ip adresa brány
+   GwyIP:ipaddr          = ip adresa brány | (restart)
-   DNSIP:ipaddr          = ip adresa DNS serveru
+   DNSIP:ipaddr          = ip adresa DNS serveru | (restart)
-   WebPort:number        = TCP port pro webové rozhraní
+   WebPort:number        = TCP port pro webové rozhraní | (restart)
-   SUDPport:number       = UDP port pro SUDP protokol
+   SUDPport:number       = UDP port pro SUDP protokol | (restart)
-   UseDHCP:number        = použít DHCP (1=broadcast, 4=unicast), nebo statickou ip (nastav 0)
+   UseDHCP:number        = použít DHCP (1=broadcast, 4=unicast), nebo statickou ip (nastav 0) | (restart)
-   DNSfromDHCP:flag      = DNS ip adresa z DHCP nebo statická
+   DNSfromDHCP:flag      = DNS ip adresa z DHCP nebo statická | (restart)
    NTPIP:ipaddr          = ip adresa NTP serveru
    NTPofs:number         = pevný GMT offset (-11 až +11 hodin)
@@ Řádek 329: / Řádek 329: @@
    ipaddr = a.b.c.d
    flag   = 1 / 0
 Zde je uveden náhodný příklad změny několika různých prvků, může to vypadat např. takto:
@@ Řádek 340: / Řádek 345: @@
 Jak lze vidět, změnu konfigurace lze provést hromadně pro více různých prvků - je na vás, jak to zkombinujete.
 Komunikace se serverem v SDS pak, pro tento specifický příklad, vypadá takto:

← Starší verze		Verze z 8. 3. 2023, 15:58
Řádek 340:		Řádek 340:

	Jak lze vidět, změnu konfigurace lze provést hromadně pro více různých prvků - je na vás, jak to zkombinujete.		Jak lze vidět, změnu konfigurace lze provést hromadně pro více různých prvků - je na vás, jak to zkombinujete.
		+
		+	'''POZOR'''
		+	* Změna nastavení MAC a změna nastavení prvků kolem IP adresy, nesmí být kombinovaná ve společné zprávě (provedlo by se jen změnění MAC ale už ne IP).
		+	* Změna nastavení MAC, a změna nastavení prvků kolem IP adresy, způsobí restart zařízení (po odeslání odpovědi o provedení změny) - počítejte s tím !

	Komunikace se serverem v SDS pak, pro tento specifický příklad, vypadá takto:		Komunikace se serverem v SDS pak, pro tento specifický příklad, vypadá takto:

@@ Řádek 561: / Řádek 561: @@
 Určeno k zápisu celé jedné stránky (tzn. 264B) do uživatelského prostoru v Data-Flash (DF). Číslo stránky určuje klient, spolu se zapisovanými daty.
-Tento příkaz je implementován teprve v novějších verzích FW (od 02/2023+).
+Tento příkaz je implementován teprve v novějších verzích FW (od 02/2023+). Firmware, který nemá tento příkaz implementován, odpovídá "Deny:NOT-IMPLEMENTED-YET".
 Uživatel vždy zasílá data o velikost 4 + N bajtů, kde N je 1 až 264 (maximum je 264 bajtů, což je plná velikost jedné stránky v DF). První 4 bajty určují číslo stránky (litte-endian unsigned 32bit), a ihned za tím následuje 1 až 264 bajtů jednotlivých dat pro zápis přímo do vybrané stránky v DF.

@@ Řádek 33: / Řádek 33: @@
 . '''[/share]''' SDS-C zápis do sys[140-149] nebo do share[] - pouze SDS První Produktové Řady !
-. '''[/wrdf]''' zápis stránky do USER DATA-FLASH (teprve bude implementováno)
+. '''[/wrdf]''' zápis stránky do USER DATA-FLASH
@@ Řádek 498: / Řádek 498: @@
 Velikost předávaného souboru, tedy Content-Length, je omezena dle typu SDS. Typicky je pro tento příkaz maximum 2 MB.
 == COMMAND: /share ==
@@ Řádek 554: / Řádek 555: @@
 '''POZOR''' pro tento příkaz je aktivní omezení na hodnotu Content-Length, která je maximálně 512. Pokud budou zaslána data o velikosti větší než 512 znaků (<cr><nl> je samozřejmě započítáno), tak budou všechna data nad 512 znaků IGNOROVÁNA (zahozena) - zařízení SDS zpracuje pouze prvních až 512 příchozích bajtů datového obsahu, více ne.
 == COMMAND: /wrdf ==
-Určeno k zápisu celé jedné stránky (tzn. 264B) do uživatelského prostoru v Data-Flash. Číslo stránky určuje klient, spolu se zapisovanými daty.
+Určeno k zápisu celé jedné stránky (tzn. 264B) do uživatelského prostoru v Data-Flash (DF). Číslo stránky určuje klient, spolu se zapisovanými daty.
-Tento příkaz bude teprve implementován (10/2022+ ).
+Pokud pošlete méně než 264 bajtů v rámci obsahu stránky (tedy ne úplnou stránku), je zápis proveden i v takovém případě, ale chybějící data jsou automaticky doplněna do celé velikosti (264B) hodnotou 0xFF. Vybraná stránka v DF je tedy v každém případě přepsána celá !

← Starší verze		Verze z 28. 9. 2022, 09:04
Řádek 32:		Řádek 32:

	7. '''[/share]''' SDS-C zápis do sys[140-149] nebo do share[] - pouze SDS První Produktové Řady !		7. '''[/share]''' SDS-C zápis do sys[140-149] nebo do share[] - pouze SDS První Produktové Řady !
		+
		+	8. '''[/wrdf]''' zápis stránky do USER DATA-FLASH (teprve bude implementováno)


Řádek 552:		Řádek 554:

	'''POZOR''' pro tento příkaz je aktivní omezení na hodnotu Content-Length, která je maximálně 512. Pokud budou zaslána data o velikosti větší než 512 znaků (<cr><nl> je samozřejmě započítáno), tak budou všechna data nad 512 znaků IGNOROVÁNA (zahozena) - zařízení SDS zpracuje pouze prvních až 512 příchozích bajtů datového obsahu, více ne.		'''POZOR''' pro tento příkaz je aktivní omezení na hodnotu Content-Length, která je maximálně 512. Pokud budou zaslána data o velikosti větší než 512 znaků (<cr><nl> je samozřejmě započítáno), tak budou všechna data nad 512 znaků IGNOROVÁNA (zahozena) - zařízení SDS zpracuje pouze prvních až 512 příchozích bajtů datového obsahu, více ne.
		+
		+	== COMMAND: /wrdf ==
		+
		+	Určeno k zápisu celé jedné stránky (tzn. 264B) do uživatelského prostoru v Data-Flash. Číslo stránky určuje klient, spolu se zapisovanými daty.
		+
		+	Tento příkaz bude teprve implementován (10/2022+ ).

@@ Řádek 507: / Řádek 507: @@
 Zápis číselné hodnoty do sdíleného prostoru v sys[]:
-:hodnota  ->  zapíše 'hodnota'do sys[140]
+  I140:hodnota  ->  zapíše 'hodnota'do sys[140]
   ...
-:hodnota  ->  zapíše 'hodnota'do sys[149]
+  I149:hodnota  ->  zapíše 'hodnota'do sys[149]
 Zápis textového řetězce do sdíleného prostoru ve share[]:
@@ Řádek 523: / Řádek 523: @@
 Příklad (sys[140] zapsat hodnotu 12, sys[145] zapsat hodnotu 34, a do share[] od pozice 123 zapíšeme 'something'):
-:12<cr><nl>
+  I140:12<cr><nl>
-:34<cr><nl>
+  I145:34<cr><nl>
   S123:something<cr><nl>
@@ Řádek 531: / Řádek 531: @@
   [C] POST /share HTTP/1.1
   [C] Host: 192.168.4.250
-  [C] Content-Length: 26
+  [C] Content-Length: 28
   [C]
   [C] NoncePlease
@@ Řádek 539: / Řádek 539: @@
   [C] START:START
   [S] Status:ReadyToWrite
-  [C] 140:12
+  [C] I140:12
-  [C] 145:34
+  [C] I145:34
   [C] S123:something
   [S] Done:0