Milyen előnyökkel jár a csatlakoztatása
Saját Azure Static Web Apps-fiókja csatlakoztatásával közvetlenül a Zinn® vezérlőpultjáról tehet közzé statikus webhelyet a saját Azure Static Web Apps-fiókjában. A projekt és a számla az Ön tulajdonában marad; mi kezeljük a telepítést, az egyéni domaint és a DNS-rekordokat.
Mielőtt elkezdené
Szüksége lesz egy Azure-előfizetésre, egy erőforráscsoportra a webhelyek számára, valamint egy csatlakoztatott GitHub-, GitLab- vagy Bitbucket-fiókra, amely a kódot tárolja — az Azure Static Web Apps egy adattárból (repository) végzi a buildelést. Az Azure ingyenes díjcsomagja engedélyezi az üzleti célú használatot és alkalmazásonként két egyéni domaint biztosít.
1. Hozza létre a kulcsot az Azure Static Web Apps szolgáltatásban
Az Azure ezt szolgáltatásnévnek (service principal) nevezi. A Microsoft Entra felügyeleti központban nyissa meg az Entra ID → App registrations → New registration menüpontot, adjon meg egy nevet, majd kattintson a Register gombra. Az alkalmazás áttekintő oldalán másolja ki az Application (client) ID és a Directory (tenant) ID azonosítókat. Ezután nyissa meg a Certificates & secrets → Client secrets → New client secret lehetőséget, válasszon egy érvényességi időt, majd kattintson az Add gombra — azonnal másolja ki a titkos kulcs (secret) értékét, mivel az Azure csak egyszer jeleníti meg.
Az Azure Portalon nyissa meg a használni kívánt erőforráscsoportot, majd lépjen az Access control (IAM) → Add → Add role assignment menüpontra. Válassza ki a Contributor szerepkört, rendelje hozzá a User, group, or service principal típushoz, keresse meg az alkalmazást név alapján, majd kattintson a Review + assign gombra. Jegyezze fel az erőforráscsoport nevét és a hozzá tartozó Subscription ID azonosítót (keressen a Subscriptions kifejezésre a portálon).
2. Csatlakoztassa itt
Nyissa meg az Integrations menüpontot a vezérlőpultján, és válassza a Connect an account lehetőséget. Válassza a Static hosting (Netlify, Vercel) csoportot és az Azure Static Web Apps fiókot, töltse ki a Client ID, Client secret, Tenant ID, Subscription ID és Resource group mezőket, majd kattintson a Connect account gombra.
Mielőtt bármit elmentenénk, teszteljük a beillesztett adatokat. A nem működő kulcsokat soha nem tároljuk, és a hibaüzenetből kiderül, mi volt a probléma. A működő kulcsokat titkosítva tároljuk a biztonsági tárhelyünkön (secrets vault) — soha nem az adatbázisunkban —, és soha többé nem jelenítjük meg őket, még Önnek sem.
Mi történik ezután
- Amikor létrehoz vagy áthelyez egy statikus webhelyet, ez a fiók megjelenik telepítési
célként. Az Azure Static Web Apps adattárból buildel — nem támogatja a feltöltött buildek fogadását —, így a webhely kódjának egy csatlakoztatott GitHub-, GitLab- vagy Bitbucket-adattárból kell származnia. Ha még nem tette meg, először csatlakoztasson egyet.
- Létrehozzuk a szolgáltatást az Ön fiókjában, az adattárhoz irányítjuk, hozzárendeljük az Ön egyéni domainjét,
és elindítjuk a telepítéseket. A domain oldala megjeleníti az összes olyan DNS-rekordot, amelyre az Azure Static Web Apps szolgáltatásnak szüksége van.
- A használat és a számlázás az Ön fiókjában történik, és a szolgáltató saját vezérlőpultján látható.
- A fődomaint (apex domain) egy TXT-rekord, míg az aldomaint a CNAME-rekordja igazolja vissza; a domain oldala mutatja,
hogy az Ön domainjéhez melyik szükséges.
Ha a csatlakozás sikertelen
Az Azure elutasította a szolgáltatásnevet (service principal). Vagy lejárt a kliens titkos kulcsa (client secret) — mindig lejárnak a választott érvényességi idő végén —, vagy az alkalmazás már nem rendelkezik Contributor jogosultsággal az erőforráscsoporton. A két üzenet hasonlóan néz ki, ezért egy új titkos kulcs létrehozása előtt ellenőrizze a szerepkör-hozzárendelést.
Semmi sem található. Ellenőrizze, hogy a Subscription ID és a Resource group valóban azok-e, amelyekhez a szerepkört hozzárendelte, valamint hogy a Tenant ID az a címtár-e, amelyben az alkalmazást regisztrálta.
A kulcs elutasításra került. Szinte mindig a következő három dolog egyike okozza: egy véletlenül kimásolt szóköz vagy sortörés, egy lejárt kulcs, vagy egy olyan kulcs, amelyet a kimásolása után visszavontak vagy újrageneráltak. Hozzon létre egy újat, és illessze be újra.
Csatlakozik, de később valami hibát jelez. A kulcs hitelesítése sikeres, de hiányzik egy olyan engedély, amely a művelethez szükséges. Hozzon létre egy új kulcsot a fent felsorolt engedélyekkel, majd bontsa le a régi kapcsolatot, és csatlakoztassa az új kulcsot.
Lekapcsolás
Nyissa meg az Integrations menüpontot, keresse meg a fiókot, majd kattintson a Disconnect gombra. Ez azonnal törli a tárolt kulcsot. Minden olyan folyamat, amely ezt használta, leáll a következő műveletnél, és a tőle függő képernyők ezt egyértelműen jelezni fogják, ahelyett hogy némán hibát okoznának.
A lekapcsolás nem vonja vissza a már elvégzett módosításokat — az Ön fiókjában általunk módosított rekordok, telepítések és beállítások változatlanok maradnak. Ha úgy véli, hogy maga a kulcs kiszivároghatott, vonja vissza a szolgáltatónál is; a kapcsolat bontása a mi másolatunkat távolítja el, nem az övéket.