Azure Sphere'ı ara sunucu üzerinden bağlama
Önemli
Bu, Azure Sphere (Eski) belgeleridir. Azure Sphere (Eski) 27 Eylül 2027'de kullanımdan kaldırılıyor ve kullanıcıların bu zamana kadar Azure Sphere'e (Tümleşik) geçmeleri gerekiyor. Azure Sphere (Tümleşik) belgelerini görüntülemek için İçindekiler tablosu üzerinde bulunan Sürüm seçiciyi kullanın.
Azure Sphere SDK Uygulama Kitaplıklarını (Applibs) veya CLI'yı kullanarak bir Azure Sphere cihazını bir ara sunucu üzerinden İnternet'e bağlanacak şekilde yapılandırabilirsiniz. Bu özellik etkinleştirildiğinde tüm cihaz trafiği ara sunucu üzerinden akar. Cihaz, kullanılacak ara sunucuyu, sunucu türünü ve kimlik doğrulama yöntemini tanımlayacak şekilde yapılandırılabilir.
Şu anda yalnızca HTTP proxy'leri desteklenmektedir.
Kimlik doğrulama yöntemleri
Aşağıdaki kimlik doğrulama yöntemleri desteklenir:
- Temel: Bağlantının kimliğini doğrulamak için kullanıcıdan bir kullanıcı adı ve parola ister.
- Anonim: Ara sunucu bağlantısı kullanılırken kullanıcı adı ve parola gerekmemesi için kullanıcıların anonim olarak bağlanmasına izin verir.
CLI kullanarak ara sunucu yapılandırması
Aşağıdaki komutlar ağ bağlantısı için ara sunucu adresi kullanımını yönetir. Daha fazla bilgi için bkz . azsphere device network proxy.
| Operasyon | Açıklama |
|---|---|
| ara sunucu uygula | Bağlı cihazda ağ proxy'sini yapılandırıyor. |
| proxy silme | Ekli cihazdaki ara sunucu bağlantısını siler. |
| ara sunucu gösterisi | Bağlı cihazda ara sunucu bağlantısını gösterir. |
Applibs kullanarak ara sunucu yapılandırması
Ara sunucu yapılandırmasını ayarlamak için uygulamanızın , ara sunucu yapılandırma özelliklerini alma ve ayarlama desteği içeren Applibs ağ API'sini kullanması gerekir.
Bu üst bilgi dosyasını uygulamanıza ekleyin:
#include <applibs/networking.h>
Uygulamanızda cURL kullanıyor ve ara sunucu üzerinden İnternet'e bağlanıyorsanız, bu üst bilgi dosyasını da eklemeniz gerekir:
#include <applibs/networking_curl.h>
cURL kullanma hakkında daha fazla bilgi için bkz . Web hizmetlerine bağlanma.
Proxy yapılandırması için desteklenen Uygulamalar
Aşağıdaki AppLibs desteklenir:
- 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
Uygulama bildirimi gereksinimleri
Uygulama bildirimi NetworkConfig veya ReadNetworkProxyConfig özelliğini içermelidir. Bu özellik, uygulamanızın ara sunucu ayarlarına erişim derecesini belirler.
NetworkConfig özelliği tüm ağ yapılandırma ayarlarına tam erişim verir. Uygulamanızın ara sunucu ayarlarını yapılandırmasına, almasına ve etkinleştirmesine veya devre dışı bırakmasına olanak tanır.
"Capabilities": {
"NetworkConfig": true
}
ReadNetworkProxyConfig özelliği yalnızca uygulamanızın ara sunucu ayarlarını almasına izin verir. Bu özellik, ağ ayarlarına genel erişimi reddedilen ancak ara sunucu yapılandırma bilgileri gerektiren uygulamalar için kullanılır.
"Capabilities": {
"ReadNetworkProxyConfig": true
}
Azure IoT Hub'a bağlanmak için MQTT kullanma
Azure IoT uygulamaları, bir Azure IoT hub'ına bağlanmak için TCP/IP tabanlı MQTT kullanır. Trafiğin ara sunucu üzerinden düzgün bir şekilde yeniden yönlendirilmesini sağlamak için uygulamanızı WebSockets üzerinden MQTT kullanacak şekilde yapılandırmanız gerekir.
Uygulamanızı bir IoT Hub ile doğrudan iletişim kuracak şekilde yapılandırabilir veya Azure Cihaz Sağlama Hizmetleri'ni (DPS) kullanabilirsiniz:
Uygulamanızı bir IoT hub'ı ile doğrudan iletişim kuracak şekilde yapılandırmak için, READMEStartWithIoTHub.md örneğindeki ara sunucu örnek kodunu kullanın ve AzureIoT hub'ına doğrudan bağlanma bölümünde açıklandığı gibi değiştirin.
Uygulamanızı Azure DPS kullanacak şekilde yapılandırmak için READMEAddDPS veya READMEStartWithIoTCentral örneğindeki ara sunucu örnek kodunu kullanın ve Azure IoT Hub cihazı sağlama hizmeti aracılığıyla bağlanma bölümünde açıklandığı gibi değiştirin.
Ara sunucu desteği ekleme hakkında daha fazla bilgi için bkz . READMEAddWebProxy.md.
Örnekler
Proxy kod parçacıkları aşağıdakileri gösterir:
- Ara Sunucu Ayarlarını Yapılandır kod parçacığı, Bir Azure Sphere cihazında ara sunucu ayarlarının nasıl yapılandırılır gösterir.
- Ara Sunucu Ayarlarını Al kod parçacığı, Bir Azure Sphere cihazında ara sunucu ayarlarının nasıl alınduğunu gösterir.
- Yapılandırılmış Ara Sunucuyu Etkinleştir/Devre Dışı Bırak kod parçacığı, Azure Sphere cihazında önceden yapılandırılmış bir ara sunucuyu etkinleştirmeyi/devre dışı bırakmayı gösterir.
HTTPS örnekleri, HTTPS üzerinden içerik getirmek için HTTPS_Curl_Easy ve HTTPS_Curl_Multi API'lerinin kullanılmasını gösterir. Varsayılan olarak, cURL tutamacını bir ara sunucu kullanacak şekilde yapılandırırlar.
AzureIoT örneği, örneğe web proxy desteği eklemeye yönelik yönergeler ve kod içerir.