Conectar o Azure Sphere por meio de um servidor proxy

Você pode configurar um dispositivo do Azure Sphere para se conectar à Internet por meio de um servidor proxy usando as Bibliotecas de Aplicativos do SDK do Azure Sphere (Applibs) ou a CLI. Quando esse recurso é habilitado, todo o tráfego do dispositivo flui pelo proxy. O dispositivo pode ser configurado para identificar o servidor proxy a ser usado, o tipo de servidor e o método de autenticação.

Atualmente, há suporte apenas para proxies HTTP.

Métodos de autenticação

Há suporte para os seguintes métodos de autenticação:

• Básico: solicita ao usuário um nome de usuário e senha para autenticar a conexão.
• Anônimo: permite que os usuários se conectem anonimamente para que o nome de usuário e a senha não sejam necessários ao usar a conexão do servidor proxy.

Configuração de proxy usando a CLI

Os comandos a seguir gerenciam o uso de endereço proxy para conexão de rede. Para obter mais informações, consulte proxy de rede de dispositivo do azsphere.

Operação	Descrição
proxy aplicar	Configura o proxy de rede no dispositivo anexado.
exclusão de proxy	Exclui a conexão proxy no dispositivo anexado.
proxy show	Mostra a conexão de proxy no dispositivo anexado.

Configuração de proxy usando Applibs

Para configurar a configuração de proxy, seu aplicativo deve usar a API de rede applibs, que inclui suporte para obter e definir propriedades de configuração de proxy.

Inclua este arquivo de cabeçalho em seu aplicativo:

#include <applibs/networking.h>

Se você estiver usando cURL em seu aplicativo e se conectando à Internet por meio de um servidor proxy, também deverá incluir este arquivo de cabeçalho:

#include <applibs/networking_curl.h>

Para obter mais informações sobre como usar cURL, consulte Conectar-se aos serviços Web.

Applibs com suporte para configuração de proxy

Há suporte para os seguintes 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

Requisitos de manifesto do aplicativo

O manifesto do aplicativo deve incluir o recurso NetworkConfig ou ReadNetworkProxyConfig . A funcionalidade determina o grau de acesso que seu aplicativo tem às configurações de proxy.

A funcionalidade NetworkConfig concede acesso total a todas as configurações de rede. Ele permite que seu aplicativo configure, recupere e habilite ou desabilite as configurações de proxy.

"Capabilities": {
  "NetworkConfig": true
}

A funcionalidade ReadNetworkProxyConfig só permite que seu aplicativo recupere as configurações de proxy. Essa funcionalidade é usada para aplicativos que têm acesso geral negado às configurações de rede, mas exigem informações de configuração de proxy.

"Capabilities": {
  "ReadNetworkProxyConfig": true
}

Usar o MQTT para se conectar ao Hub IoT do Azure

Os aplicativos IoT do Azure usam o MQTT baseado em TCP/IP para se conectar a um hub IoT do Azure. Você deve configurar seu aplicativo para usar o MQTT em WebSockets para que o tráfego seja redirecionado corretamente por meio do proxy.

Você pode configurar seu aplicativo para se comunicar diretamente com um Hub IoT ou usar o DPS (Serviços de Provisionamento de Dispositivos do Azure):

• Para configurar seu aplicativo para se comunicar diretamente com um hub IoT, use o código de exemplo de proxy no exemplo READMEStartWithIoTHub.md e modifique-o conforme descrito no hub Connect to AzureIoT diretamente.

• Para configurar seu aplicativo para usar o DPS do Azure, use o código de exemplo de proxy no exemplo READMEAddDPS ou READMEStartWithIoTCentral e modifique-o conforme descrito em Conectar por meio Hub IoT do Azure serviço de provisionamento de dispositivos.

Para obter mais informações sobre como adicionar suporte a proxy, consulte READMEAddWebProxy.md.

Amostras

Os snippets de código proxy demonstram o seguinte:

• O snippet de código Configurar Configurações de Proxy demonstra como configurar as configurações de proxy em um dispositivo do Azure Sphere.
• O snippet de código Obter Configurações de Proxy demonstra como recuperar as configurações de proxy em um dispositivo do Azure Sphere.
• O snippet de código Enable/Disable Configured Proxy demonstra como habilitar/desabilitar um proxy já configurado em um dispositivo do Azure Sphere.

Os exemplos HTTPS demonstram o uso das APIs HTTPS_Curl_Easy e HTTPS_Curl_Multi para buscar conteúdo por HTTPS. Por padrão, eles configuram o identificador cURL para usar um proxy.

O exemplo do AzureIoT contém instruções e código para adicionar suporte a proxy Web ao exemplo.