Azure Sphere verbinden via een proxyserver

U kunt een Azure Sphere-apparaat configureren om verbinding te maken met internet via een proxyserver met behulp van de Azure Sphere SDK-toepassingsbibliotheken (Applibs) of de CLI. Wanneer deze functie is ingeschakeld, stroomt al het apparaatverkeer via de proxy. Het apparaat kan worden geconfigureerd om de te gebruiken proxyserver, het type server en de verificatiemethode te identificeren.

Alleen HTTP-proxy's worden momenteel ondersteund.

Verificatiemethoden

De volgende verificatiemethoden worden ondersteund:

• Basic: vraagt de gebruiker om een gebruikersnaam en wachtwoord om de verbinding te verifiëren.
• Anoniem: hiermee kunnen gebruikers anoniem verbinding maken, zodat gebruikersnaam en wachtwoord niet vereist zijn bij het gebruik van de proxyserververbinding.

Proxyconfiguratie met behulp van de CLI

Met de volgende opdrachten beheert u het proxyadresgebruik voor de netwerkverbinding. Zie az sphere device network proxy voor meer informatie.

Bewerking	Beschrijving
proxy toepassen	Hiermee configureert u de netwerkproxy op het gekoppelde apparaat.
proxy verwijderen	Hiermee verwijdert u de proxyverbinding op het gekoppelde apparaat.
proxyvoorstelling	Hiermee wordt de proxyverbinding op het gekoppelde apparaat weergegeven.

Proxyconfiguratie met behulp van Applibs

Als u proxyconfiguratie wilt instellen, moet uw toepassing gebruikmaken van de Applibs-netwerk-API, die ondersteuning biedt voor het ophalen en instellen van proxyconfiguratie-eigenschappen.

Neem dit headerbestand op in uw toepassing:

#include <applibs/networking.h>

Als u cURL gebruikt in uw toepassing en verbinding maakt met internet via een proxyserver, moet u ook dit headerbestand opnemen:

#include <applibs/networking_curl.h>

Zie Verbinding maken met webservices voor meer informatie over het gebruik van cURL.

Ondersteunde Applibs voor proxyconfiguratie

De volgende AppLibs worden ondersteund:

• 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

Vereisten voor toepassingsmanifest

Het toepassingsmanifest moet de mogelijkheid NetworkConfig of ReadNetworkProxyConfig bevatten. De mogelijkheid bepaalt de mate van toegang van uw toepassing tot de proxy-instellingen.

De mogelijkheid NetworkConfig verleent volledige toegang tot alle netwerkconfiguratie-instellingen. Hiermee kan uw toepassing proxy-instellingen configureren, ophalen en in- of uitschakelen.

"Capabilities": {
  "NetworkConfig": true
}

Met de mogelijkheid ReadNetworkProxyConfig kan uw toepassing alleen proxy-instellingen ophalen. Deze mogelijkheid wordt gebruikt voor toepassingen waarvoor algemene toegang tot netwerkinstellingen is geweigerd, maar waarvoor proxyconfiguratiegegevens zijn vereist.

"Capabilities": {
  "ReadNetworkProxyConfig": true
}

MQTT gebruiken om verbinding te maken met Azure IoT Hub

Azure IoT-toepassingen gebruiken MQTT op basis van TCP/IP om verbinding te maken met een Azure IoT-hub. U moet uw toepassing configureren voor het gebruik van MQTT via WebSockets, zodat verkeer correct wordt omgeleid via de proxy.

U kunt uw toepassing configureren om rechtstreeks met een IoT Hub te communiceren of de Azure Device Provisioning Services (DPS) gebruiken:

• Als u uw toepassing wilt configureren om rechtstreeks met een IoT-hub te communiceren, gebruikt u de proxyvoorbeeldcode in het READMEStartWithIoTHub.md voorbeeld en wijzigt u deze zoals beschreven in Rechtstreeks verbinding maken met AzureIoT-hub.

• Als u uw toepassing wilt configureren voor het gebruik van Azure DPS, gebruikt u de voorbeeldcode van de proxy in het voorbeeld READMEAddDPS of READMEStartWithIoTCentral en wijzigt u deze zoals beschreven in Verbinding maken via Azure IoT Hub apparaatinrichtingsservice.

Zie READMEAddWebProxy.md voor meer informatie over het toevoegen van proxyondersteuning.

Monsters

De proxycodefragmenten laten het volgende zien:

• Het codefragment Proxyinstellingen configureren laat zien hoe u de proxy-instellingen op een Azure Sphere-apparaat configureert.
• Het codefragment Proxyinstellingen ophalen laat zien hoe u de proxy-instellingen op een Azure Sphere-apparaat ophaalt.
• Het codefragment Geconfigureerde proxy in-/uitschakelen laat zien hoe u een al geconfigureerde proxy op een Azure Sphere-apparaat inschakelt/uitschakelt.

De HTTPS-voorbeelden laten zien hoe u de HTTPS_Curl_Easy- en HTTPS_Curl_Multi-API's gebruikt om inhoud via HTTPS op te halen. Standaard configureren ze de cURL-ingang om een proxy te gebruiken.

Het AzureIoT-voorbeeld bevat instructies en code voor het toevoegen van ondersteuning voor webproxy's aan het voorbeeld.