Az Azure Sphere csatlakoztatása proxykiszolgálón keresztül

Az Azure Sphere-eszközöket konfigurálhatja úgy, hogy proxykiszolgálón keresztül csatlakozzanak az internethez az Azure Sphere SDK alkalmazáskódtáraival (Applibs) vagy a parancssori felülettel. Ha ez a funkció engedélyezve van, az összes eszközforgalom áthalad a proxyn. Az eszköz konfigurálható a használni kívánt proxykiszolgáló, a kiszolgáló típusa és a hitelesítési módszer azonosítására.

Jelenleg csak a HTTP-proxyk támogatottak.

Hitelesítési módszerek

A következő hitelesítési módszerek támogatottak:

• Alapszintű: Felhasználónév és jelszó megadását kéri a felhasználótól a kapcsolat hitelesítéséhez.
• Névtelen: Lehetővé teszi, hogy a felhasználók névtelenül csatlakozzanak, hogy a proxykiszolgáló-kapcsolat használatakor ne legyen szükség felhasználónévre és jelszóra.

Proxykonfiguráció a parancssori felület használatával

Az alábbi parancsok a hálózati kapcsolat proxycím-használatát kezelik. További információ: az sphere-eszköz hálózati proxyja.

Művelet	Leírás
proxyalkalmazás	Konfigurálja a hálózati proxyt a csatlakoztatott eszközön.
proxy törlése	Törli a proxykapcsolatot a csatlakoztatott eszközön.
proxy show	Proxykapcsolatot jelenít meg a csatlakoztatott eszközön.

Proxykonfiguráció az Applibs használatával

A proxykonfiguráció beállításához az alkalmazásnak az Applibs hálózati API-t kell használnia, amely támogatja a proxykonfigurációs tulajdonságok lekérését és beállítását.

Adja meg ezt a fejlécfájlt az alkalmazásban:

#include <applibs/networking.h>

Ha cURL-t használ az alkalmazásban, és proxykiszolgálón keresztül csatlakozik az internethez, a fejlécfájlt is tartalmaznia kell:

#include <applibs/networking_curl.h>

További információ a cURL használatáról: Csatlakozás webszolgáltatásokhoz.

Támogatott Applibs proxykonfigurációhoz

A következő AppLibs-adatbázisok támogatottak:

• 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

Alkalmazásjegyzékre vonatkozó követelmények

Az alkalmazásjegyzéknek tartalmaznia kell a NetworkConfig vagy a ReadNetworkProxyConfig képességet. A képesség határozza meg, hogy az alkalmazás milyen mértékű hozzáféréssel rendelkezik a proxybeállításokhoz.

A NetworkConfig képesség teljes hozzáférést biztosít az összes hálózati konfigurációs beállításhoz. Lehetővé teszi az alkalmazás számára a proxybeállítások konfigurálását, lekérését és engedélyezését vagy letiltását.

"Capabilities": {
  "NetworkConfig": true
}

A ReadNetworkProxyConfig képesség csak a proxybeállítások lekérését teszi lehetővé az alkalmazás számára. Ez a képesség olyan alkalmazásokhoz használható, amelyek nem férnek hozzá általánosan a hálózati beállításokhoz, de proxykonfigurációs információkat igényelnek.

"Capabilities": {
  "ReadNetworkProxyConfig": true
}

Csatlakozás Azure IoT Hub az MQTT használatával

Az Azure IoT-alkalmazások TCP/IP-alapú MQTT használatával csatlakoznak egy Azure IoT Hubhoz. Konfigurálnia kell az alkalmazást úgy, hogy az MQTT-t WebSocketeken keresztül használja, hogy a forgalom megfelelően legyen átirányítva a proxyn keresztül.

Az alkalmazást konfigurálhatja úgy, hogy közvetlenül kommunikáljon egy IoT Hub, vagy használja az Azure Device Provisioning Services (DPS) szolgáltatást:

• Ha úgy szeretné konfigurálni az alkalmazást, hogy közvetlenül kommunikáljon egy IoT Hubbal, használja a proxy mintakódot a READMEStartWithIoTHub.md mintában, és módosítsa azt a Csatlakozás az AzureIoT Hubhoz közvetlenül című cikkben leírtak szerint.

• Ha az alkalmazást az Azure DPS használatára szeretné konfigurálni, használja a READMEAddDPS vagy a READMEStartWithIoTCentral mintaproxy-mintakódot, és módosítsa a Csatlakozás Azure IoT Hub eszközregisztrációs szolgáltatáson keresztül című cikkben leírtak szerint.

További információ a proxytámogatás hozzáadásáról: READMEAddWebProxy.md.

Minták

A proxykódrészletek a következőket mutatják be:

• A Proxybeállítások konfigurálása kódrészlet bemutatja, hogyan konfigurálhatja a proxybeállításokat egy Azure Sphere-eszközön.
• A Proxybeállítások lekérése kódrészlet bemutatja, hogyan lehet lekérni a proxybeállításokat egy Azure Sphere-eszközön.
• A Konfigurált proxykódrészlet engedélyezése/letiltása bemutatja, hogyan engedélyezhet/tilthat le egy már konfigurált proxyt egy Azure Sphere-eszközön.

A HTTPS-minták azt mutatják be, hogy az HTTPS_Curl_Easy és a HTTPS_Curl_Multi API-k használatával szeretné lekérni a tartalmakat HTTPS-en keresztül. Alapértelmezés szerint proxy használatára konfigurálják a cURL-leírót.

Az AzureIoT-minta útmutatást és kódot tartalmaz a webproxy-támogatás mintához való hozzáadásához.