Dukungan API di Azure Static Web Apps dengan Azure App Service
Azure App Service adalah platform terkelola untuk menghosting aplikasi web yang menjalankan kode di server. Azure App Service mendukung banyak runtime dan kerangka kerja termasuk Node.js, ASP.NET Core, PHP, Java, dan Python.
Saat Anda menautkan aplikasi web Azure App Service ke aplikasi web statis, permintaan apa pun ke aplikasi web statis Anda dengan rute yang dimulai dengan /api diproksikan ke rute yang sama di aplikasi Azure App Service.
Secara default, saat aplikasi App Service ditautkan ke aplikasi web statis, aplikasi App Service hanya menerima permintaan yang diproksi melalui aplikasi web statis yang ditautkan. Aplikasi Azure App Service hanya dapat ditautkan ke satu aplikasi web statis pada satu waktu.
Semua paket hosting Azure App Service tersedia untuk digunakan dengan Azure Static Web Apps.
Opsi API untuk Static Web Apps mencakup layanan Azure berikut:
Lihat gambaran umum API untuk informasi selengkapnya.
Catatan
Integrasi dengan Azure App Service memerlukan paket Static Web Apps Standard.
Integrasi backend tidak didukung pada lingkungan permintaan penarikan Static Web Apps.
Prasyarat
Untuk menautkan App Service ke aplikasi web statis, Anda harus memiliki sumber daya App Service yang sudah ada dan aplikasi web statis.
| Sumber daya | Deskripsi |
|---|---|
| Azure App Service | Jika Anda belum memilikinya, ikuti langkah-langkah dalam panduan Membuat aplikasi web di Azure . |
| Aplikasi web statis yang ada | Jika Anda belum memilikinya, ikuti langkah-langkah dalam panduan memulai untuk membuat aplikasi web statis Tanpa Kerangka Kerja . |
Contoh
Pertimbangkan instans Azure App Service yang sudah ada yang mengekspos titik akhir melalui lokasi berikut.
https://my-web-app.azurewebsites.net/api/getProducts
Setelah ditautkan, Anda dapat mengakses titik akhir yang sama melalui jalur api dari aplikasi web statis Anda, seperti yang ditunjukkan dalam URL contoh ini.
https://red-sea-123.azurestaticapps.net/api/getProducts
Kedua URL menunjuk ke titik akhir API yang sama. Titik akhir pada App Service harus memiliki /api awalan, karena Static Web Apps cocok dengan permintaan yang dibuat dan /api menproksi seluruh jalur ke sumber daya yang ditautkan.
Menautkan Aplikasi Web Azure App Service
Untuk menautkan aplikasi web sebagai backend API untuk aplikasi web statis, ikuti langkah-langkah berikut:
Di portal Azure, buka aplikasi web statis.
Pilih API dari menu navigasi.
Temukan lingkungan yang ingin Anda tautkan instans API Management. Pilih Tautkan.
Di Jenis sumber daya backend, pilih Aplikasi Web.
Di Langganan, pilih langganan yang berisi aplikasi Azure App Service yang ingin Anda tautkan.
Di Nama sumber daya, pilih aplikasi Azure App Service.
Pilih Tautkan.
Ketika proses penautan selesai, permintaan ke rute yang dimulai dengan /api diproksikan ke aplikasi App Service yang ditautkan.
Mengelola akses ke Azure App Service
Aplikasi App Service Anda dikonfigurasi dengan idP bernama Azure Static Web Apps (Linked) yang hanya mengizinkan lalu lintas yang diproksi melalui aplikasi web statis. Untuk membuat aplikasi App Service Anda dapat diakses oleh aplikasi lain, perbarui konfigurasi autentikasinya untuk menambahkan penyedia identitas lain atau mengubah pengaturan keamanan untuk memungkinkan akses yang tidak diautentikasi.
Membatalkan tautan aplikasi Azure App Service
Membatalkan tautan App Service dari Static Web Apps
Untuk membatalkan tautan aplikasi web dari aplikasi web statis, ikuti langkah-langkah berikut:
Di portal Azure, buka aplikasi web statis.
Pilih API dari menu navigasi.
Temukan lingkungan yang ingin Anda batalkan tautannya dan pilih nama aplikasi web.
Pilih Batalkan tautan.
Saat proses pembatalan tautan selesai, permintaan ke rute yang dimulai dengan /api tidak lagi diproksikan ke aplikasi App Service Anda.
Catatan
Untuk mencegah secara tidak sengaja mengekspos aplikasi App Service Anda ke lalu lintas anonim, idP yang dibuat oleh proses penautan tidak dihapus secara otomatis. Anda dapat menghapus penyedia identitas bernama Azure Static Web Apps (Tertaut) dari pengaturan autentikasi aplikasi App Service.
Menghapus autentikasi dari sumber daya App Service
Untuk mengaktifkan sumber daya App Service Anda untuk menerima lalu lintas anonim, ikuti langkah-langkah berikut untuk menghapus penyedia identitas:
Di portal Azure, navigasikan ke sumber daya App Service.
Pilih Autentikasi dari menu navigasi.
Dari daftar Penyedia identitas, hapus idP yang terkait dengan sumber daya Static Web Apps.
Pilih Hapus autentikasi untuk menghapus autentikasi dan mengizinkan lalu lintas anonim ke sumber daya App Service Anda.
Sumber daya App Service Anda sekarang dapat menerima lalu lintas anonim.