Menyambungkan Azure Sphere melalui server proksi
Anda dapat mengonfigurasi perangkat Azure Sphere untuk tersambung ke Internet melalui server proksi menggunakan Azure Sphere SDK Application Libraries (Applibs) atau CLI. Ketika fitur ini diaktifkan, semua arus lalu lintas perangkat melalui proksi. Perangkat dapat dikonfigurasi untuk mengidentifikasi server proksi yang akan digunakan, tipe server, dan metode autentikasi.
Hanya proksi HTTP yang saat ini didukung.
Metode autentikasi
Metode autentikasi berikut ini didukung:
- Dasar: Meminta nama pengguna dan kata sandi untuk mengautentikasi koneksi.
- Anonim: Memungkinkan pengguna untuk tersambung secara anonim sehingga nama pengguna dan kata sandi tidak diperlukan saat menggunakan koneksi server proksi.
Konfigurasi proksi menggunakan CLI
Perintah berikut ini mengelola penggunaan alamat proksi untuk koneksi jaringan. Untuk informasi selengkapnya, lihat proksi jaringan perangkat bola az.
| Operasi | Deskripsi |
|---|---|
| proksi berlaku | Mengonfigurasi proksi jaringan pada perangkat yang terlampir. |
| penghapusan proksi | Menghapus koneksi proksi pada perangkat yang terlampir. |
| peragaan proksi | Memperlihatkan koneksi proksi pada perangkat yang dilampirkan. |
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 dalam aplikasi 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 ini 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 kapabilitas NetworkConfig atau ReadNetworkProxyConfig. Kapabilitas menentukan tingkat akses aplikasi Anda ke pengaturan proksi.
Kapabilitas 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 mengambil pengaturan proksi. Kapabilitas 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 agar berkomunikasi dengan hub IoT secara langsung, gunakan kode sampel proksi dalam sampel READMEStartWithIoTHub.md dan ubah seperti yang dijelaskan di Hubungkan ke hub AzureIoT secara langsung.
Untuk mengonfigurasi aplikasi Anda agar menggunakan Azure DPS, gunakan kode sampel proksi dalam sampel READMEAddDPS atau READMEStartWithIoTCentral dan ubah seperti yang dijelaskan di Connect melalui layanan penyediaan perangkat Azure IoT Hub.
Untuk informasi selengkapnya tentang menambahkan dukungan proksi, lihat READMEAddWebProxy.md.
Sampel
Potongan kode proksi menunjukkan hal berikut:
- Cuplikan kode Konfigurasi Pengaturan Proksi menunjukkan cara mengonfigurasi pengaturan proksi di perangkat Azure Sphere.
- Cuplikan kode Dapatkan Pengaturan Proksi menunjukkan cara mengambil pengaturan proksi di perangkat Azure Sphere.
- Cuplikan kode Aktifkan/Nonaktifkan Proksi yang Dikonfigurasi menunjukkan cara mengaktifkan/menonaktifkan proksi yang sudah dikonfigurasi di perangkat Azure Sphere.
Sampel HTTPS menunjukkan penggunaan HTTPS_Curl_Easy dan API HTTPS_Curl_Multi untuk mengambil konten melalui HTTPS. Secara default, mereka mengonfigurasi gagang cURL untuk menggunakan proksi.
Sampel AzureIoT berisi instruksi dan kode untuk menambahkan dukungan proksi web ke sampel.