Implementeer een statische website in uw eigen Azure Static Web Apps-account

Wat het koppelen voor u doet

Door uw eigen Azure Static Web Apps-account te koppelen, kunt u een statische website publiceren naar uw Azure Static Web Apps-account vanuit uw Zinn®-dashboard. U bent eigenaar van het project en de rekening; wij handelen de implementatie, het aangepaste domein en de DNS-records af.

Voordat u begint

Een Azure-abonnement, een resourcegroep voor de websites en een gekoppeld GitHub-, GitLab- of Bitbucket-account dat de code bevat — Azure Static Web Apps bouwt vanaf een repository. Het gratis abonnement van Azure staat commercieel gebruik en twee aangepaste domeinen per app toe.

1. Maak de sleutel aan in Azure Static Web Apps

Azure noemt dit een service-principal. Open in het Microsoft Entra-beheercentrum Entra ID → App-registraties → Nieuwe registratie, geef deze een naam en Registreer deze. Kopieer op de overzichtspagina van de app de Toepassings-id (client) en de Map-id (tenant). Open vervolgens Certificaten en geheimen → Clientgeheimen → Nieuw clientgeheim, kies een duur en Voeg toe — kopieer de waarde van het geheime geheim direct, Azure toont dit maar één keer.

Open in de Azure-portal de resourcegroep die u wilt dat wij gebruiken, en vervolgens Toegangsbeheer (IAM) → Toevoegen → Roltoewijzing toevoegen. Kies de rol Inzender, wijs deze toe aan Gebruiker, groep of service-principal, zoek naar de app op naam en kies Controleren + toewijzen. Noteer de naam van de resourcegroep en de Abonnements-id waar deze bij hoort (zoek naar Abonnementen in de portal).

2. Koppel het hier

Open Integraties in uw dashboard en kies Account koppelen. Kies Statische hosting (Netlify, Vercel) als de groep en Azure Static Web Apps als het account, vul Client-id, Clientgeheim, Tenant-id, Abonnements-id en Resourcegroep in en druk op Account koppelen.

We testen wat u plakt voordat er iets wordt opgeslagen. Een sleutel die niet werkt wordt nooit opgeslagen, en het antwoord vermeldt wat er mis mee was. Een sleutel die werkt wordt versleuteld bewaard in onze geheimenkluis — nooit in onze database — en wordt nooit meer getoond, zelfs niet aan u.

Wat er hierna gebeurt

• Wanneer u een statische website aanmaakt of verplaatst, verschijnt dit account als een implementatiedoel.

Azure Static Web Apps bouwt vanaf een repository — het heeft geen manier om een geüploade build te accepteren — dus de code van de website moet afkomstig zijn van een gekoppelde GitHub-, GitLab- of Bitbucket-repository. Koppel er eerst een als u dat nog niet hebt gedaan.

• We maken de service aan op uw account, wijzen deze naar de repository, koppelen uw aangepaste domein

en starten implementaties. De pagina van het domein toont elk DNS-record dat Azure Static Web Apps nodig heeft.

• Gebruik en facturering zijn voor uw rekening en zijn zichtbaar in uw eigen leveranciersdashboard.
• Een apex-domein wordt geverifieerd door een TXT-record en een subdomein door het CNAME-record; de pagina van het domein toont

welk record uw domein nodig heeft.

Als het niet lukt om te koppelen

Azure heeft de service-principal geweigerd. Ofwel is het clientgeheim verlopen — dat doen ze altijd, op basis van de duur die u hebt gekozen — ofwel heeft de app niet langer de rol Inzender op de resourcegroep. De twee berichten lijken op elkaar, dus controleer de roltoewijzing voordat u een nieuw geheim aanmaakt.

Er wordt niets gevonden. Controleer of de Abonnements-id en Resourcegroep de objecten zijn waaraan u de rol hebt toegewezen, en of de Tenant-id de map is waarin de app is geregistreerd.

Er wordt gemeld dat de sleutel is geweigerd. Vrijwel altijd een van drie dingen: een spatie of een regeleinde dat is mee gekopieerd, een sleutel die is verlopen, of een sleutel die is ingetrokken of opnieuw is gegenereerd nadat u deze hebt gekopieerd. Maak een nieuwe aan en plak deze opnieuw.

Verbinding verbreken

Open Integraties, zoek het account en druk op Verbinding verbreken. Daardoor wordt de opgeslagen sleutel onmiddellijk verwijderd. Alles wat hiervan gebruik maakte stopt bij de volgende actie, en de schermen die ervan afhankelijk waren geven dat aan in plaats van stilletjes te falen.

Het verbreken van de verbinding maakt niet ongedaan wat al is gedaan — records, implementaties of instellingen die wij op uw account hebben gewijzigd, blijven zoals ze zijn. Als u denkt dat de sleutel zelf mogelijk is gelekt, trek deze dan ook in bij de leverancier; het verbreken van de verbinding verwijdert onze kopie, niet die van hen.