Připojení Azure Sphere přes proxy server

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. Když 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 pro ověření připojení.
• Anonymní: Umožňuje uživatelům připojit se anonymně, aby při použití připojení k proxy serveru nebylo vyžadováno uživatelské jméno a heslo.

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

Následující příkazy spravují použití adresy proxy serveru pro připojení k síti. Další informace najdete v tématu az sphere device network proxy.

Operace	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í.
proxy show	Zobrazuje připojení proxy serveru na připojeném zařízení.

Konfigurace proxy serveru s využitím applibs

Pokud chcete nastavit konfiguraci proxy serveru, vaše aplikace musí 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 soubor hlaviček:

#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 soubor hlaviček:

#include <applibs/networking_curl.h>

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

Podporovaná applibs pro konfiguraci proxy serveru

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

• Networking_Curl_SetDefaultProxy
• Networking_Proxy_Create
• Networking_Proxy_Destroy
• Networking_Proxy_Apply
• Networking_Proxy_Get
• Networking_Proxy_SetProxyOptions
• Networking_Proxy_SetProxyAddress
• Networking_Proxy_SetAnonymousAuthentication
• Networking_Proxy_SetBasicAuthentication
• Networking_Proxy_SetProxyNoProxyAddresses
• Networking_Proxy_GetProxyOptions
• Networking_Proxy_GetProxyAddress
• Networking_Proxy_GetProxyPort
• Networking_Proxy_GetProxyType
• Networking_Proxy_GetProxyUsername
• Networking_Proxy_GetProxyPassword
• Networking_Proxy_GetAuthType
• Networking_Proxy_GetNoProxyAddresses
• Networking_Proxy_GetProxyStatus
• Networking_ProxyConfig
• Networking_ProxyOptions
• Networking_ProxyType
• Networking_ProxyAuthType
• Networking_ProxyStatus

Požadavky manifestu aplikace

Manifest aplikace musí obsahovat funkci NetworkConfig nebo ReadNetworkProxyConfig. Schopnost 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 vaší aplikaci jenom načíst nastavení proxy serveru. Tato funkce se používá pro aplikace, kterým byl odepřen obecný přístup k nastavení sítě, ale vyžadují informace o konfiguraci proxy serveru.

"Capabilities": {
  "ReadNetworkProxyConfig": true
}

Připojení k Azure IoT Hub pomocí MQTT

Aplikace Azure IoT používají protokol MQTT založený na protokolu TCP/IP pro připojení ke službě Azure IoT Hub. Aplikaci musíte nakonfigurovat tak, aby používala MQTT přes webSockety, aby byl provoz přes proxy server správně přesměrován.

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

• Pokud chcete nakonfigurovat aplikaci tak, aby komunikovala přímo se službou IoT Hub, použijte ukázkový kód proxy serveru v ukázce READMEStartWithIoTHub.md a upravte ho podle pokynů v tématu Přímé připojení k centru AzureIoT.

• Pokud chcete aplikaci nakonfigurovat tak, aby používala Azure DPS, použijte ukázkový kód proxy serveru v ukázce READMEAddDPS nebo READMEStartWithIoTCentral a upravte ho podle popisu v tématu Připojení přes službu Azure IoT Hub zřizování zařízení.

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

Vzorky

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

• Fragment kódu Konfigurace nastavení proxy ukazuje, jak nakonfigurovat nastavení proxy serveru na zařízení Azure Sphere.
• Fragment kódu Get Proxy Settings (Získat nastavení proxy serveru ) ukazuje, jak načíst nastavení proxy serveru na zařízení Azure Sphere.
• Fragment kódu 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í rozhraní API HTTPS_Curl_Easy a HTTPS_Curl_Multi k načtení obsahu přes PROTOKOL HTTPS. Ve výchozím nastavení nakonfigurují 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.