Implementirajte statično web-mjesto na vlastiti račun za Azure Static Web Apps

Što vam povezivanje omogućuje

Povezivanje vlastitog Azure Static Web Apps računa omogućuje vam objavljivanje statičnog web-mjesta na vaš Azure Static Web Apps račun s vaše Zinn® upravljačke ploče. Vi ste vlasnik projekta i računa za uslugu; mi upravljamo postavljanjem, prilagođenom domenom i DNS zapisima.

Prije nego što započnete

Azure pretplata, grupa resursa za web-mjesta i povezani GitHub, GitLab ili Bitbucket račun koji sadrži kôd — Azure Static Web Apps gradi iz repozitorija. Azureov besplatni paket dopušta komercijalnu upotrebu i dvije prilagođene domene po aplikaciji.

1. Stvorite ključ na servisu Azure Static Web Apps

Azure to naziva service principal. U Microsoft Entra admin centeru otvorite Entra ID → App registrations → New registration, dodijelite naziv i odaberite Register. Na stranici s pregledom aplikacije kopirajte Application (client) ID i Directory (tenant) ID. Zatim otvorite Certificates & secrets → Client secrets → New client secret, odaberite trajanje i kliknite Add — odmah kopirajte vrijednost tajnog ključa, Azure je prikazuje samo jednom.

Na Azure portalu otvorite grupu resursa koju želite da koristimo, zatim Access control (IAM) → Add → Add role assignment. Odaberite ulogu Contributor, dodijelite je za User, group, or service principal, potražite aplikaciju po nazivu i odaberite Review + assign. Zabilježite naziv grupe resursa i Subscription ID kojem pripada (pretražite Subscriptions na portalu).

2. Povežite ga ovdje

Otvorite Integrations na svojoj upravljačkoj ploči i odaberite Connect an account. Odaberite Static hosting (Netlify, Vercel) kao grupu i Azure Static Web Apps kao račun, unesite Client ID, Client secret, Tenant ID, Subscription ID i Resource group, pa pritisnite Connect account.

Prije spremanja testiramo ono što zalijepite. Ključ koji ne radi nikada se ne pohranjuje, a odgovor navodi u čemu je bio problem. 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 slijedi

• Kada stvorite ili premjestite statično web-mjesto, ovaj se račun pojavljuje kao odredište za

postavljanje. Azure Static Web Apps gradi iz repozitorija — ne postoji mogućnost prihvaćanja prenesene međuverzije — stoga kôd web-mjesta mora dolaziti iz povezanog GitHub, GitLab ili Bitbucket repozitorija. Prvo povežite jedan ako to još niste učinili.

• Mi stvaramo uslugu na vašem računu, usmjeravamo je prema repozitoriju, povezujemo vašu prilagođenu domenu

i pokrećemo postavljanja. Stranica domene prikazuje sve DNS zapise koje Azure Static Web Apps zahtijeva.

• Potrošnja i naplata vode se na vašem računu te su vidljivi na vašoj upravljačkoj ploči kod pružatelja usluge.
• Vršna (apex) domena verificira se TXT zapisom, a poddomena svojim CNAME zapisom; stranica domene prikazuje

koji je od njih potreban vašoj domeni.

Ako se ne povezuje

Azure je odbio service principal. Ili je tajni ključ klijenta istekao — oni uvijek isteknu, u skladu s trajanjem koje ste odabrali — ili aplikacija više nema ulogu Contributor na grupi resursa. Te dvije poruke izgledaju slično, stoga provjerite dodjelu uloge prije stvaranja novog tajnog ključa.

Ništa nije pronađeno. Provjerite jesu li Subscription ID i Resource group oni kojima ste dodijelili ulogu, te je li Tenant ID direktorij u kojem je aplikacija registrirana.

Piše da je ključ odbijen. Gotovo uvijek radi se o jednoj od tri stvari: razmak ili prijelom retka kopiran s njim, ključ koji je istekao ili ključ koji je opozvan ili ponovno generiran nakon što ste ga kopirali. Stvorite novi i ponovno ga zalijepite.

Povezuje se, ali nešto kasnije ne uspijeva. Ključ se autentificira, ali mu nedostaje dopuštenje koje radnja zahtijeva. Stvorite novi ključ s gore navedenim dopuštenjima, zatim prekinite staru vezu i povežite novi ključ.

Prekidanje veze

Otvorite Integrations, pronađite račun i pritisnite Disconnect. To odmah briše pohranjeni ključ. Sve što ga je koristilo zaustavlja se pri sljedećoj radnji, a zasloni koji su ovisili o njemu to jasno navode umjesto neprimjetnog zakazivanja.

Prekidanje veze ne poništava ono što je već učinjeno — zapisi, postavljanja ili postavke koje smo promijenili na vašem računu ostaju kakvi jesu. Ako smatrate da je sam ključ možda procurio, također ga opozovite kod pružatelja usluge; prekidanje veze uklanja našu kopiju, a ne njihovu.