Поделиться через

Подключение Azure Sphere через прокси-сервер

  • Статья

Внимание

Это документация по Azure Sphere (устаревшая версия). Служба Azure Sphere (устаревшая версия) выходит на пенсию 27 сентября 2027 г., и к этому времени пользователи должны перейти в Azure Sphere (интегрированная). Используйте селектор версий, расположенный над toC, чтобы просмотреть документацию по Azure Sphere (интегрированная).

Устройство Azure Sphere можно настроить для подключения к Интернету через прокси-сервер с помощью библиотек приложений пакета SDK Azure Sphere (Applibs) или CLI. Если эта функция включена, весь трафик устройства передается через прокси-сервер. Устройство можно настроить для идентификации прокси-сервера, типа сервера и метода проверки подлинности.

В настоящее время поддерживаются только прокси-серверы HTTP.

методы проверки подлинности;

Поддерживаются следующие методы проверки подлинности:

  • Базовый: запрашивает у пользователя имя пользователя и пароль для проверки подлинности подключения.
  • Анонимный: позволяет пользователям подключаться анонимно, чтобы имя пользователя и пароль не требовались при использовании подключения прокси-сервера.

Конфигурация прокси-сервера с помощью интерфейса командной строки

Следующие команды управляют адресом прокси-сервера, используемым для сетевого подключения. Дополнительные сведения см. в статье azsphere device network proxy.

Операция Description
Применение прокси-сервера Настраивает сетевой прокси-сервер на подключенном устройстве.
удаление прокси-сервера Удаляет прокси-подключение на подключенном устройстве.
прокси-шоу Отображает прокси-подключение на подключенном устройстве.

Настройка прокси-сервера с помощью applibs

Чтобы настроить конфигурацию прокси-сервера, приложение должно использовать сетевой API Applibs, который включает поддержку получения и настройки свойств конфигурации прокси-сервера.

Включите этот файл заголовка в приложение:

#include <applibs/networking.h>

Если вы используете cURL в приложении и подключаетесь к Интернету через прокси-сервер, необходимо также включить этот файл заголовка:

#include <applibs/networking_curl.h>

Дополнительные сведения об использовании cURL см. в разделе "Подключение к веб-службам".

Поддерживаемые приложения для конфигурации прокси-сервера

Поддерживаются следующие приложения:

Требования к манифесту приложения

Манифест приложения должен включать функцию NetworkConfig или ReadNetworkProxyConfig. Эта возможность определяет степень доступа приложения к параметрам прокси-сервера.

Функция NetworkConfig предоставляет полный доступ ко всем параметрам конфигурации сети. Это позволяет приложению настраивать, извлекать и включать или отключать параметры прокси-сервера.

"Capabilities": {
  "NetworkConfig": true
}

Возможность ReadNetworkProxyConfig позволяет приложению получать параметры прокси-сервера. Эта возможность используется для приложений, которым запрещен общий доступ к параметрам сети, но требуются сведения о конфигурации прокси-сервера.

"Capabilities": {
  "ReadNetworkProxyConfig": true
}

Подключение к Центр Интернета вещей Azure с помощью MQTT

Приложения Интернета вещей Azure используют MQTT на основе TCP/IP для подключения к Центру Интернета вещей Azure. Необходимо настроить приложение для использования MQTT через WebSockets, чтобы трафик правильно перенаправлялся через прокси-сервер.

Вы можете настроить приложение для взаимодействия с Центр Интернета вещей напрямую или использовать службы подготовки устройств Azure (DPS):

Дополнительные сведения о добавлении поддержки прокси-сервера см. в READMEAddWebProxy.md.

Примеры

Фрагменты кода прокси-сервера демонстрируют следующее:

Примеры HTTPS демонстрируют использование HTTPS_Curl_Easy и HTTPS_Curl_Multi API для получения содержимого по протоколу HTTPS. По умолчанию они настраивают дескриптор cURL для использования прокси-сервера.

Пример AzureIoT содержит инструкции и код для добавления поддержки веб-прокси в пример.