Terapkan situs statis ke akun Azure Static Web Apps Anda sendiri

Manfaat menghubungkannya untuk Anda

Menghubungkan akun Azure Static Web Apps Anda sendiri memungkinkan Anda memublikasikan situs statis ke akun Azure Static Web Apps milik Anda dari dasbor Zinn® Anda. Anda memiliki proyek dan tagihannya; kami menangani proses deployment, domain kustom, dan rekaman DNS.

Sebelum Anda mulai

Langganan Azure, grup sumber daya untuk situs, serta akun GitHub, GitLab, atau Bitbucket terhubung yang menyimpan kodenya — Azure Static Web Apps melakukan proses build dari repositori. Paket gratis Azure mengizinkan penggunaan komersial dan dua domain kustom per aplikasi.

1. Buat kuncinya di Azure Static Web Apps

Azure menyebut ini sebagai service principal. Di pusat admin Microsoft Entra, buka Entra ID → App registrations → New registration, beri nama, lalu klik Register. Pada halaman ikhtisar aplikasi, salin Application (client) ID dan Directory (tenant) ID. Kemudian buka Certificates & secrets → Client secrets → New client secret, pilih durasi, lalu klik Add — langsung salin nilai rahasianya (secret value), Azure hanya menampilkannya satu kali.

Di portal Azure, buka grup sumber daya yang ingin Anda gunakan untuk kami, lalu klik Access control (IAM) → Add → Add role assignment. Pilih peran Contributor, tetapkan ke User, group, or service principal, cari aplikasi berdasarkan namanya, lalu klik Review + assign. Catat nama grup sumber daya dan Subscription ID tempatnya bernaung (cari Subscriptions di portal).

2. Hubungkan di sini

Buka Integrations di dasbor Anda dan pilih Connect an account. Pilih Static hosting (Netlify, Vercel) sebagai grup dan Azure Static Web Apps sebagai akun, isi Client ID, Client secret, Tenant ID, Subscription ID, dan Resource group, lalu tekan Connect account.

Kami menguji apa yang Anda tempelkan sebelum apa pun disimpan. Kunci yang tidak berfungsi tidak akan pernah disimpan, dan jawabannya akan memberi tahu masalahnya. Kunci yang berfungsi akan disimpan terenkripsi di brankas rahasia kami — tidak pernah di basis data kami — dan tidak akan pernah ditampilkan lagi, bahkan kepada Anda.

Apa yang terjadi selanjutnya

• Saat Anda membuat atau memindahkan situs statis, akun ini muncul sebagai target deployment.

Azure Static Web Apps melakukan proses build dari repositori — tidak ada cara untuk menerima build yang diunggah — jadi kode situs harus berasal dari repositori GitHub, GitLab, atau Bitbucket yang terhubung. Hubungkan salah satunya terlebih dahulu jika Anda belum melakukannya.

• Kami membuat layanan di akun Anda, mengarahkannya ke repositori, melampirkan domain kustom Anda, dan memicu deployment. Halaman domain menampilkan setiap rekaman DNS yang dibutuhkan Azure Static Web Apps.
• Penggunaan dan penagihan ada di akun Anda, dapat dilihat di dasbor vendor Anda sendiri.
• Domain apex diverifikasi dengan rekaman TXT dan subdomain dengan CNAME-nya; halaman domain menunjukkan jenis rekaman yang dibutuhkan domain Anda.

Jika tidak terhubung

Azure menolak service principal. Kemungkinan rahasia klien (client secret) telah kedaluwarsa — ini selalu terjadi, sesuai durasi yang Anda pilih — atau aplikasi tidak lagi memiliki peran Contributor pada grup sumber daya. Kedua pesan tersebut tampak serupa, jadi periksa penetapan peran sebelum membuat rahasia baru.

Tidak ada yang ditemukan. Periksa apakah Subscription ID dan Resource group adalah yang Anda tetapkan perannya, dan bahwa Tenant ID adalah direktori tempat aplikasi tersebut didaftarkan.

Tertulis bahwa kunci ditolak. Hampir selalu karena salah satu dari tiga hal: spasi atau jeda baris yang ikut tersalin, kunci yang telah kedaluwarsa, atau kunci yang dicabut atau dibuat ulang setelah Anda menyalinnya. Buat kunci baru dan tempelkan lagi.

Terhubung, tetapi ada yang gagal kemudian. Kunci berhasil diautentikasi tetapi tidak memiliki izin yang dibutuhkan oleh tindakan tersebut. Buat kunci baru dengan izin yang tercantum di atas, lalu putuskan koneksi lama dan hubungkan kunci yang baru.

Memutuskan koneksi

Buka Integrations, temukan akun tersebut, lalu tekan Disconnect. Tindakan tersebut akan langsung menghapus kunci yang disimpan. Apa pun yang menggunakannya akan terhenti pada tindakan berikutnya, dan layar yang bergantung padanya akan memberitahukan hal tersebut, bukan gagal secara diam-diam.

Memutuskan koneksi tidak membatalkan apa yang telah dilakukan — rekaman, deployment, atau pengaturan yang kami ubah di akun Anda akan tetap seperti semula. Jika Anda merasa kunci itu sendiri mungkin telah bocor, cabut juga kunci tersebut di vendor terkait; memutuskan koneksi hanya menghapus salinan kami, bukan milik mereka.