Partager via


Connecter Azure Sphere via un serveur proxy

Vous pouvez configurer un appareil Azure Sphere pour qu’il se connecte à Internet via un serveur proxy à l’aide des bibliothèques d’applications du KIT de développement logiciel (SDK) Azure Sphere ou de l’interface CLI. Lorsque cette fonctionnalité est activée, tout le trafic de l’appareil transite par le proxy. L’appareil peut être configuré pour identifier le serveur proxy à utiliser, le type de serveur et la méthode d’authentification.

Seuls les proxys HTTP sont actuellement pris en charge.

Méthodes d’authentification

Les méthodes d’authentification suivantes sont prises en charge :

  • De base : invite l’utilisateur à entrer un nom d’utilisateur et un mot de passe pour authentifier la connexion.
  • Anonyme : permet aux utilisateurs de se connecter de manière anonyme afin que le nom d’utilisateur et le mot de passe ne soient pas requis lors de l’utilisation de la connexion au serveur proxy.

Configuration du proxy à l’aide de l’interface CLI

Les commandes suivantes gèrent l’utilisation de l’adresse proxy pour la connexion réseau. Pour plus d’informations, consultez az sphere device network proxy.

Opération Description
proxy apply Configure le proxy réseau sur l’appareil attaché.
suppression du proxy Supprime la connexion proxy sur l’appareil attaché.
proxy show Affiche la connexion proxy sur l’appareil attaché.

Configuration du proxy à l’aide de bibliothèques d’applications

Pour configurer la configuration du proxy, votre application doit utiliser l’API réseau des bibliothèques d’applications, qui inclut la prise en charge de l’obtention et de la définition des propriétés de configuration du proxy.

Incluez ce fichier d’en-tête dans votre application :

#include <applibs/networking.h>

Si vous utilisez cURL dans votre application et que vous vous connectez à Internet via un serveur proxy, vous devez également inclure ce fichier d’en-tête :

#include <applibs/networking_curl.h>

Pour plus d’informations sur l’utilisation de cURL, consultez Se connecter à des services web.

Bibliothèques d’applications prises en charge pour la configuration du proxy

Les AppLibs suivants sont pris en charge :

Exigences du manifeste d’application

Le manifeste de l’application doit inclure la fonctionnalité NetworkConfig ou ReadNetworkProxyConfig . La fonctionnalité détermine le degré d’accès de votre application aux paramètres du proxy.

La fonctionnalité NetworkConfig accorde un accès complet à tous les paramètres de configuration réseau. Il permet à votre application de configurer, de récupérer et d’activer ou de désactiver les paramètres de proxy.

"Capabilities": {
  "NetworkConfig": true
}

La fonctionnalité ReadNetworkProxyConfig permet uniquement à votre application de récupérer les paramètres de proxy. Cette fonctionnalité est utilisée pour les applications qui se voient refuser l’accès général aux paramètres réseau, mais qui nécessitent des informations de configuration de proxy.

"Capabilities": {
  "ReadNetworkProxyConfig": true
}

Utiliser MQTT pour se connecter à Azure IoT Hub

Les applications Azure IoT utilisent MQTT basé sur TCP/IP pour se connecter à un hub Azure IoT. Vous devez configurer votre application pour utiliser MQTT sur WebSockets afin que le trafic soit correctement redirigé via le proxy.

Vous pouvez configurer votre application pour communiquer directement avec un IoT Hub ou utiliser azure Device Provisioning Services (DPS) :

Pour plus d’informations sur l’ajout de la prise en charge du proxy, consultez READMEAddWebProxy.md.

Échantillons

Les extraits de code proxy illustrent les éléments suivants :

Les exemples HTTPS illustrent l’utilisation des API HTTPS_Curl_Easy et HTTPS_Curl_Multi pour extraire du contenu via HTTPS. Par défaut, ils configurent le handle cURL pour utiliser un proxy.

L’exemple AzureIoT contient des instructions et du code pour ajouter la prise en charge du proxy web à l’exemple.