Připojení Azure Sphere prostřednictvím proxy serveru

Článek
09/27/2024

Důležité

Toto je dokumentace k Azure Sphere (starší verze). Azure Sphere (starší verze) se vyřazuje 27. září 2027 a uživatelé musí do této doby migrovat do Azure Sphere (integrované). K zobrazení dokumentace k Azure Sphere (integrované) použijte selektor verzí umístěný nad obsahem.

Zařízení Azure Sphere můžete nakonfigurovat pro připojení k internetu přes proxy server pomocí knihoven aplikací sady Azure Sphere SDK (Applibs) nebo rozhraní příkazového řádku. Pokud je tato funkce povolená, veškerý provoz zařízení prochází přes proxy server. Zařízení je možné nakonfigurovat tak, aby identifikovalo proxy server, který se má použít, typ serveru a metodu ověřování.

V současné době se podporují jenom proxy servery HTTP.

Metody ověřování

Podporují se následující metody ověřování:

Základní: Vyzve uživatele k zadání uživatelského jména a hesla k ověření připojení.
Anonymní: Umožňuje uživatelům připojit se anonymně, aby uživatelské jméno a heslo nebyly při použití připojení k proxy serveru vyžadovány.

Konfigurace proxy serveru pomocí rozhraní příkazového řádku

Následující příkazy spravují adresu proxy serveru pro síťové připojení. Další informace najdete v tématu azsphere device network proxy.

Operation	Popis
použít proxy server	Nakonfiguruje síťový proxy server na připojeném zařízení.
odstranění proxy serveru	Odstraní připojení proxy serveru na připojeném zařízení.
zobrazení proxy serveru	Zobrazuje připojení proxy serveru na připojeném zařízení.

Konfigurace proxy serveru pomocí applibs

Pokud chcete nastavit konfiguraci proxy serveru, musí vaše aplikace používat síťové rozhraní API applibs, které zahrnuje podporu pro získání a nastavení vlastností konfigurace proxy serveru.

Do aplikace zahrňte tento hlavičkový soubor:

#include <applibs/networking.h>

Pokud ve své aplikaci používáte cURL a připojujete se k internetu přes proxy server, musíte zahrnout také tento hlavičkový soubor:

#include <applibs/networking_curl.h>

Další informace o používání cURL naleznete v tématu Připojení k webovým službám.

Podporované applibs pro konfiguraci proxy serveru

Podporují se následující knihovny AppLib:

Požadavky manifestu aplikace

Manifest aplikace musí obsahovat funkci NetworkConfig nebo ReadNetworkProxyConfig. Tato funkce určuje stupeň přístupu, který má vaše aplikace k nastavení proxy serveru.

Funkce NetworkConfig uděluje úplný přístup ke všem nastavením konfigurace sítě. Umožňuje vaší aplikaci konfigurovat, načítat a povolovat nebo zakázat nastavení proxy serveru.

"Capabilities": {
  "NetworkConfig": true
}

Funkce ReadNetworkProxyConfig umožňuje aplikaci načíst nastavení proxy serveru. Tato funkce se používá pro aplikace, které mají odepřen obecný přístup k nastavení sítě, ale vyžadují informace o konfiguraci proxy serveru.

"Capabilities": {
  "ReadNetworkProxyConfig": true
}

Použití MQTT pro připojení ke službě Azure IoT Hub

Aplikace Azure IoT používají K připojení k centru Azure IoT protokol MQTT založený na protokolu TCP/IP. Aplikaci musíte nakonfigurovat tak, aby používala MQTT přes WebSockets, aby se provoz přesměroval přes proxy server.

Aplikaci můžete nakonfigurovat tak, aby komunikuje přímo se službou IoT Hub, nebo můžete použít službu Azure Device Provisioning Services (DPS):

Pokud chcete nakonfigurovat aplikaci tak, aby komunikovala s centrem IoT přímo, použijte ukázkový kód proxy serveru v ukázce READMEStartWithIoTHub.md a upravte ji podle popisu v připojení k centru AzureIoT přímo.
Pokud chcete nakonfigurovat aplikaci tak, aby používala Azure DPS, použijte vzorový kód proxy serveru v ukázce READMEAddDPS nebo READMEStartWithIoTCentral a upravte ji podle popisu v tématu Připojení přes službu zřizování zařízení Azure IoT Hubu.

Další informace o přidání podpory proxy serveru najdete v tématu READMEAddWebProxy.md.

Ukázky

Fragmenty kódu proxy ukazují následující:

Fragment kódu konfigurace nastavení proxy serveru ukazuje, jak nakonfigurovat nastavení proxy serveru na zařízení Azure Sphere.
Fragment kódu Get Proxy Settings ukazuje, jak načíst nastavení proxy serveru na zařízení Azure Sphere.
Fragment kódu pro povolení/zakázání nakonfigurovaného proxy serveru ukazuje, jak povolit nebo zakázat již nakonfigurovaný proxy server na zařízení Azure Sphere.

Ukázky HTTPS ukazují použití HTTPS_Curl_Easy a rozhraní API HTTPS_Curl_Multi k načtení obsahu přes HTTPS. Ve výchozím nastavení konfigurují popisovač cURL tak, aby používal proxy server.

Ukázka AzureIoT obsahuje pokyny a kód pro přidání podpory webového proxy serveru do ukázky.

Sdílet prostřednictvím