Menyambungkan Azure Sphere melalui server proksi
Penting
Ini adalah dokumentasi Azure Sphere (Warisan). Azure Sphere (Warisan) dihentikan pada 27 September 2027, dan pengguna harus bermigrasi ke Azure Sphere (Terintegrasi) saat ini. Gunakan pemilih Versi yang terletak di atas TOC untuk melihat dokumentasi Azure Sphere (Terintegrasi).
Anda dapat mengonfigurasi perangkat Azure Sphere untuk terhubung ke Internet melalui server proksi menggunakan Azure Sphere SDK Application Libraries (Applibs) atau CLI. Ketika fitur ini diaktifkan, semua lalu lintas perangkat mengalir melalui proksi. Perangkat dapat dikonfigurasi untuk mengidentifikasi server proksi yang akan digunakan, jenis server, dan metode autentikasi.
Hanya proksi HTTP yang saat ini didukung.
Metode autentikasi
Berikut adalah metode autentikasi yang didukung:
- Dasar: Meminta nama pengguna dan kata sandi untuk mengautentikasi koneksi.
- Anonim: Memungkinkan pengguna untuk terhubung secara anonim sehingga nama pengguna dan kata sandi tidak diperlukan saat menggunakan koneksi server proksi.
Konfigurasi proksi menggunakan CLI
Perintah berikut mengelola penggunaan alamat proksi untuk koneksi jaringan. Untuk informasi selengkapnya, lihat proksi jaringan perangkat azsphere.
| Operasi | Deskripsi |
|---|---|
| proksi berlaku | Mengonfigurasi proksi jaringan pada perangkat yang terpasang. |
| penghapusan proksi | Menghapus koneksi proksi pada perangkat yang terpasang. |
| peragaan proksi | Menampilkan koneksi proksi pada perangkat yang terpasang. |
Konfigurasi proksi menggunakan Applibs
Untuk menyiapkan konfigurasi proksi, aplikasi Anda harus menggunakan API jaringan Applibs, yang mencakup dukungan untuk mendapatkan dan mengatur properti konfigurasi proksi.
Sertakan file header ini dalam aplikasi Anda:
#include <applibs/networking.h>
Jika Anda menggunakan cURL di aplikasi Anda dan menyambungkan ke Internet melalui server proksi, Anda juga harus menyertakan file header ini:
#include <applibs/networking_curl.h>
Untuk informasi selengkapnya tentang menggunakan cURL, lihat Menyambungkan ke layanan web.
Applibs yang didukung untuk konfigurasi proksi
AppLibs berikut didukung:
- 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
Persyaratan manifes aplikasi
Manifes aplikasi harus menyertakan kemampuan NetworkConfig atau ReadNetworkProxyConfig. Kemampuan menentukan tingkat akses yang dimiliki aplikasi Anda ke pengaturan proksi.
Kemampuan NetworkConfig memberikan akses penuh ke semua pengaturan konfigurasi jaringan. Ini memungkinkan aplikasi Anda untuk mengonfigurasi, mengambil, dan mengaktifkan atau menonaktifkan pengaturan proksi.
"Capabilities": {
"NetworkConfig": true
}
Kemampuan ReadNetworkProxyConfig hanya memungkinkan aplikasi Anda untuk mengambil pengaturan proksi. Kemampuan ini digunakan untuk aplikasi yang ditolak akses umum ke pengaturan jaringan, tetapi memerlukan informasi konfigurasi proksi.
"Capabilities": {
"ReadNetworkProxyConfig": true
}
Menggunakan MQTT untuk menyambungkan ke Azure IoT Hub
Aplikasi Azure IoT menggunakan MQTT berbasis TCP/IP untuk menyambungkan ke hub Azure IoT. Anda harus mengonfigurasi aplikasi untuk menggunakan MQTT melalui WebSockets sehingga lalu lintas dialihkan dengan benar melalui proksi.
Anda dapat mengonfigurasi aplikasi untuk berkomunikasi dengan IoT Hub secara langsung, atau menggunakan Azure Device Provisioning Services (DPS):
Untuk mengonfigurasi aplikasi Anda untuk berkomunikasi dengan hub IoT secara langsung, gunakan kode sampel proksi dalam sampel READMEStartWithIoTHub.md dan ubah seperti yang dijelaskan di Sambungkan ke hub AzureIoT secara langsung.
Untuk mengonfigurasi aplikasi Anda untuk menggunakan Azure DPS, gunakan kode sampel proksi di sampel READMEAddDPS atau READMEStartWithIoTCentral dan ubah seperti yang dijelaskan di Sambungkan melalui layanan provisi perangkat Azure IoT Hub.
Untuk informasi selengkapnya tentang menambahkan dukungan proksi, lihat READMEAddWebProxy.md.
Sampel
Cuplikan kode proksi menunjukkan hal berikut:
- Cuplikan kode Konfigurasi Pengaturan Proksi menunjukkan cara mengonfigurasi pengaturan proksi pada perangkat Azure Sphere.
- Cuplikan kode Dapatkan Pengaturan Proksi menunjukkan cara mengambil pengaturan proksi pada perangkat Azure Sphere.
- Cuplikan kode Aktifkan/Nonaktifkan Proksi yang Dikonfigurasi menunjukkan cara mengaktifkan/menonaktifkan proksi yang sudah dikonfigurasi pada perangkat Azure Sphere.
Sampel HTTPS menunjukkan menggunakan API HTTPS_Curl_Easy dan HTTPS_Curl_Multi untuk mengambil konten melalui HTTPS. Secara default, mereka mengonfigurasi handel cURL untuk menggunakan proksi.
Sampel AzureIoT berisi instruksi dan kode untuk menambahkan dukungan proksi web ke sampel.