Implementirajte statičku web-lokaciju na vlastiti Azure Static Web Apps račun

Što vam ovo povezivanje omogućuje

Povezivanjem vlastitog Azure Static Web Apps računa možete objaviti statičnu web-lokaciju na svoj Azure Static Web Apps račun s vaše Zinn® upravljačke ploče. Vi ste vlasnik projekta i računa; mi upravljamo objavom, prilagođenom domenom i DNS zapisima.

Prije nego što počnete

Pretplata na Azure, grupa resursa za web-lokacije i povezani račun za GitHub, GitLab ili Bitbucket na kojem se nalazi kôd — Azure Static Web Apps gradi se iz repozitorija. Azureov besplatni plan omogućuje komercijalnu upotrebu i dvije prilagođene domene po aplikaciji.

1. Stvorite ključ na usluzi Azure Static Web Apps

Azure to naziva servisnim principalom (engl. service principal). U administrativnom centru Microsoft Entra otvorite Entra ID → Registracije aplikacija → Nova registracija, unesite naziv i Registrirajte je. Na stranici s pregledom aplikacije kopirajte ID aplikacije (klijenta) i ID direktorija (zakupnika). Zatim otvorite Certifikati i tajne → Tajne klijenta → Nova tajna klijenta, odaberite trajanje i Dodajte je — odmah kopirajte vrijednost tajne jer je Azure prikazuje samo jednom.

Na Azure portalu otvorite grupu resursa koju želite da koristimo, zatim Kontrola pristupa (IAM) → Dodaj → Dodaj dodjelu uloge. Odaberite ulogu Suradnik (engl. Contributor), dodijelite je stavci Korisnik, grupa ili servisni principal, potražite aplikaciju prema nazivu i kliknite Pregledaj i dodijeli. Zabilježite naziv grupe resursa i ID pretpate kojoj pripada (potražite Pretplate na portalu).

2. Povežite ga ovdje

Otvorite Integracije na svojoj upravljačkoj ploči i odaberite Poveži račun. Odaberite Statično hostiranje (Netlify, Vercel) kao grupu i Azure Static Web Apps kao račun, unesite ID klijenta, Tajnu klijenta, ID zakupnika, ID pretplate i Grupu resursa, te pritisnite Poveži račun.

Testiramo ono što zalijepite prije nego što se bilo što spremi. Ključ koji ne radi nikada se ne pohranjuje, a poruka o pogrešci navodi što s njim nije u redu. Ključ koji radi čuva se šifriran u našem trezoru tajni — nikada u našoj bazi podataka — i više se nikada ne prikazuje, čak ni vama.

Što se događa nakon toga

• Kada stvorite ili premjestite statičnu web-lokaciju, ovaj se račun pojavljuje kao odredište za objavu.

Azure Static Web Apps gradi se iz repozitorija — nema mogućnost prihvaćanja učitane objave — stoga kôd web-lokacije mora potjecati iz povezanog repozitorija na platformi GitHub, GitLab ili Bitbucket. Povežite ga najprije ako to još niste učinili.

• Stvaramo uslugu na vašem računu, usmjeravamo je na repozitorij, pridružujemo vašu prilagođenu domenu i pokrećemo objave. Stranica domene prikazuje sve DNS zapise koje Azure Static Web Apps treba.
• Upotreba i naplata su na vašem računu, vidljivi na vašoj vlastitoj korisničkoj upravljačkoj ploči.
• Apex domena potvrđuje se TXT zapisom, a poddomena putem CNAME zapisa; stranica domene pokazuje koji od njih vaša domena treba.

Ako se ne poveže

Azure je odbio servisni principal. Ili je tajna klijenta istekla — one uvijek istječu nakon trajanja koje ste odabrali — ili aplikacija više nema ulogu Suradnika na grupi resursa. Te dvije poruke izgledaju slično, stoga provjerite dodjelu uloge prije stvaranja nove tajne.

Ništa nije pronađeno. Provjerite jesu li ID pretplate i Grupa resursa oni na kojima ste dodijelili ulogu te je li ID zakupnika direktorij u kojem je aplikacija registrirana.

Piše da je ključ odbijen. Gotovo uvijek je u pitanju jedno od troje: s ključem je kopiran razmak ili prijelom retka, ključ je istekao ili je ključ opozvan odnosno ponovno generiran nakon što ste ga kopirali. Stvorite novi i ponovno ga zalijepite.

Povezivanje uspije, ali nešto kasnije ne radi. Ključ se provjerava, ali nedostaje mu dozvola koja je potrebna za radnju. Stvorite novi ključ s gore navedenim dozvolama, zatim prekinite vezu sa starim i povežite novi ključ.

Prekidanje veze

Otvorite Integracije, pronađite račun i pritisnite Prekidi vezu. Time se spremljeni ključ odmah briše. Sve što ga je koristilo zaustavlja se pri sljedećoj radnji, a zasloni koji su o njemu ovisili to jasno prikazuju umjesto da tiho otkažu.

Prekidanje veze ne poništava ono što je već učinjeno — zapisi, objave ili postavke koje smo promijenili na vašem računu ostaju kakvi jesu. Ako smatrate da je sam ključ možda kompromitiran, opozovite ga i kod davatelja usluge; prekidanjem veze briše se naša kopija, ali ne i njihova.