Conectar Azure Sphere a través de un servidor proxy
Puede configurar un dispositivo Azure Sphere para conectarse a Internet a través de un servidor proxy mediante las bibliotecas de aplicaciones (Applibs) del SDK de Azure Sphere o la CLI. Cuando esta característica está habilitada, todo el tráfico del dispositivo fluye a través del proxy. El dispositivo se puede configurar para identificar el servidor proxy que se va a usar, el tipo de servidor y el método de autenticación.
Actualmente solo se admiten servidores proxy HTTP.
Métodos de autenticación
Se admiten los siguientes métodos de autenticación:
- Básico: solicita al usuario un nombre de usuario y una contraseña para autenticar la conexión.
- Anónimo: permite a los usuarios conectarse de forma anónima para que el nombre de usuario y la contraseña no sean necesarios cuando se usa la conexión del servidor proxy.
Configuración de proxy mediante la CLI
Se admiten los siguientes comandos para administrar el uso de direcciones de proxy para la conexión de red. Para más información, consulte azsphere device network proxy.
| Operación | Descripción |
|---|---|
| proxy apply | Configura el proxy de red en el dispositivo conectado. |
| proxy delete | Elimina la conexión de proxy en el dispositivo conectado. |
| proxy show | Muestra la conexión de proxy en el dispositivo conectado. |
Configuración de proxy mediante applibs
Para configurar la configuración de proxy, la aplicación debe usar la API de red applibs, que incluye compatibilidad para obtener y establecer propiedades de configuración de proxy.
Incluya este archivo de encabezado en la aplicación:
#include <applibs/networking.h>
Si usa cURL en la aplicación y se conecta a Internet a través de un servidor proxy, también debe incluir este archivo de encabezado:
#include <applibs/networking_curl.h>
Para obtener más información sobre el uso de cURL, vea Conectar a los servicios web.
El manifiesto de aplicación debe incluir la funcionalidad NetworkConfig o ReadNetworkProxyConfig. La funcionalidad determina el grado de acceso de la aplicación a la configuración del proxy.
La funcionalidad NetworkConfig permite que la aplicación configure, recupere y habilite o deshabilite la configuración del proxy.
"Capabilities": {
"NetworkConfig": true
}
La funcionalidad ReadNetworkProxyConfig solo permite que la aplicación recupere la configuración del proxy.
"Capabilities": {
"ReadNetworkProxyConfig": true
}
Applibs admitidos para la configuración de proxy
Se admiten las siguientes 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
Ejemplos
- El fragmento de código Configuración proxy muestra cómo configurar los valores de proxy en un Azure Sphere dispositivo.
- El fragmento de Configuración código get proxy muestra cómo recuperar la configuración de proxy en un Azure Sphere dispositivo.
- El fragmento de código Habilitar o deshabilitar proxy configurado muestra cómo habilitar o deshabilitar un proxy ya configurado en un Azure Sphere configurado.