Bagikan melalui


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:

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 informasi selengkapnya tentang menambahkan dukungan proksi, lihat READMEAddWebProxy.md.

Sampel

Potongan kode proksi menunjukkan hal berikut:

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.