Co vám propojení přinese
Propojení vašeho vlastního účtu Azure Static Web Apps vám umožní publikovat statický web na váš účet Azure Static Web Apps přímo z vašeho ovládacího panelu Zinn®. Vy vlastníte projekt i vyúčtování; my se postaráme o nasazení, vlastní doménu a DNS záznamy.
Než začnete
Předplatné Azure, skupina prostředků pro weby a propojený účet GitHub, GitLab nebo Bitbucket, který obsahuje kód — Azure Static Web Apps provádí sestavení z repozitáře. Bezplatný plán Azure umožňuje komerční využití a dvě vlastní domény na aplikaci.
1. Vytvoření klíče v Azure Static Web Apps
Azure tento prvek označuje jako instanční objekt (service principal). V centru pro správu Microsoft Entra otevřete Entra ID → Registrace aplikací → Nová registrace, zadejte název a zvolte Registrovat. Na stránce s přehledem aplikace zkopírujte ID aplikace (klienta) a ID adresáře (tenanta). Poté otevřete Certifikáty a tajné klíče → Tajné klíče klienta → Nový tajný klíč klienta, zvolte dobu platnosti a klikněte na Přidat — hodnotu tajného klíče ihned zkopírujte, Azure ji zobrazí pouze jednou.
Na portálu Azure otevřete skupinu prostředků, kterou máme použít, a poté přejděte na Řízení přístupu (IAM) → Přidat → Přidat přiřazení role. Vyberte roli Přispěvatel (Contributor), přiřaďte ji k možnosti Uživatel, skupina nebo instanční objekt, vyhledejte aplikaci podle názvu a zvolte Zkontrolovat a přiřadit. Poznamenejte si název skupiny prostředků a ID předplatného, do kterého patří (vyhledejte Předplatná na portálu).
2. Propojení zde
Otevřete Integrace ve svém ovládacím panelu a zvolte Propojit účet. Jako skupinu vyberte Statický hosting (Netlify, Vercel) a jako účet Azure Static Web Apps, vyplňte ID klienta, Tajný klíč klienta, ID tenanta, ID předplatného a Skupina prostředků a stiskněte Propojit účet.
Před uložením čehokoli zadané údaje otestujeme. Klíč, který nefunguje, se nikdy neuloží a v odpovědi se dozvíte, co s ním bylo v nepořádku. Klíč, který funguje, je uchováván v šifrované podobě v našem trezoru tajných klíčů — nikdy v naší databázi — a již se nikdy znovu nezobrazí, a to ani vám.
Co následuje
- Když vytvoříte nebo přesunete statický web, tento účet se zobrazí jako cíl
nasazení. Azure Static Web Apps sestavuje z repozitáře — neumožňuje přijmout nahrané sestavení —, takže kód webu musí pocházet z propojeného repozitáře GitHub, GitLab nebo Bitbucket. Pokud jste tak dosud neučinili, nejprve jej propojte.
- Vytvoříme službu na vašem účtu, nasměrujeme ji na repozitář, připojíme vaši vlastní doménu
a spustíme nasazení. Na stránce domény se zobrazí všechny DNS záznamy, které Azure Static Web Apps vyžaduje.
- Využití a vyúčtování jsou vedeny na vašem účtu a jsou viditelné ve vašem vlastním ovládacím panelu poskytovatele.
- Apex doména se ověřuje pomocí záznamu TXT a subdoména pomocí svého záznamu CNAME; stránka domény uvádí,
který z nich vaše doména potřebuje.
Pokud se propojení nezdaří
Azure odmítl instanční objekt. Buď vypršela platnost tajného klíče klienta — k čemuž vždy dojde podle zvolené doby platnosti —, nebo aplikace již nemá oprávnění Přispěvatel pro danou skupinu prostředků. Obě hlášení vypadají podobně, proto před vytvořením nového tajného klíče zkontrolujte přiřazení role.
Nebylo nic nalezeno. Zkontrolujte, zda jsou ID předplatného a Skupina prostředků shodné s těmi, kde jste přiřadili roli, a zda je ID tenanta adresářem, ve kterém je aplikace registrována.
Hlášení uvádí, že klíč byl odmítnut. Téměř vždy jde o jednu ze tří věcí: mezera nebo konec řádku zkopírovaný spolu s ním, klíč s vypršenou platností, nebo klíč, který byl po zkopírování odvolán či znovu vygenerován. Vytvořte nový a vložte jej znovu.
Propojení proběhne, ale následně se něco nezdaří. Klíč se úspěšně ověří, ale postrádá oprávnění, které daná akce vyžaduje. Vytvořte nový klíč s výše uvedenými oprávněními, poté odpojte staré propojení a připojte nový klíč.
Odpojení
Otevřete Integrace, najděte daný účet a stiskněte Odpojit. Tím se uložený klíč okamžitě smaže. Cokoli, co jej využívalo, se zastaví při své další akci a obrazovky, které na něm závisely, tuto skutečnost oznámí, namísto tichého selhání.
Odpojení nevrátí zpět to, co již bylo provedeno — záznamy, nasazení nebo nastavení, která jsme na vašem účtu změnili, zůstanou beze změny. Pokud máte podezření, že došlo k úniku samotného klíče, odvolejte jej také u poskytovatele; odpojením se odstraní naše kopie, nikoli jejich.