Bereitstellen einer statischen Website in Ihrem eigenen Azure Static Web Apps-Konto

Was Ihnen die Verbindung bringt

Durch das Verbinden Ihres eigenen Azure Static Web Apps-Kontos können Sie eine statische Website von Ihrem Zinn®-Dashboard aus auf Ihrem Azure Static Web Apps-Konto veröffentlichen. Sie besitzen das Projekt und tragen die Kosten; wir übernehmen das Deployment, die benutzerdefinierte Domain und die DNS-Einträge.

Bevor Sie beginnen

Ein Azure-Abonnement, eine Ressourcengruppe für die Websites und ein verbundenes GitHub-, GitLab- oder Bitbucket-Konto, das den Code enthält – Azure Static Web Apps erstellt Builds aus einem Repository. Der kostenlose Tarif von Azure erlaubt die kommerzielle Nutzung und zwei benutzerdefinierte Domains pro App.

1. Schlüssel bei Azure Static Web Apps erstellen

Azure bezeichnet dies als Dienstprinzipal. Öffnen Sie im Microsoft Entra Admin Center Entra ID → App-Registrierungen → Neue Registrierung, vergeben Sie einen Namen und klicken Sie auf Registrieren. Kopieren Sie auf der Übersichtsseite der App die Anwendungs-ID (Client-ID) und die Verzeichnis-ID (Mandanten-ID). Öffnen Sie anschließend Zertifikate & Geheimnisse → Geheime Clientschlüssel → Neuer geheimer Clientschlüssel, wählen Sie eine Gültigkeitsdauer und klicken Sie auf Hinzufügen – kopieren Sie den Wert des Schlüssels sofort, da Azure ihn nur einmal anzeigt.

Öffnen Sie im Azure-Portal die Ressourcengruppe, die wir verwenden sollen, und wählen Sie dann Zugriffssteuerung (IAM) → Hinzufügen → Rollenzuweisung hinzufügen. Wählen Sie die Rolle Mitwirkender, weisen Sie sie Benutzer, Gruppe oder Dienstprinzipal zu, suchen Sie anhand des Namens nach der App und klicken Sie auf Überprüfen und zuweisen. Notieren Sie sich den Namen der Ressourcengruppe und die zugehörige Abonnement-ID (suchen Sie im Portal nach Abonnements).

2. Hier verbinden

Öffnen Sie Integrationen in Ihrem Dashboard und wählen Sie Konto verbinden. Wählen Sie Statisches Hosting (Netlify, Vercel) als Gruppe und Azure Static Web Apps als Konto, füllen Sie Client-ID, Geheimer Clientschlüssel, Mandanten-ID, Abonnement-ID sowie Ressourcengruppe aus und klicken Sie auf Konto verbinden.

Wir testen Ihre Eingaben, bevor etwas gespeichert wird. Ein Schlüssel, der nicht funktioniert, wird niemals gespeichert, und die Rückmeldung gibt an, was daran fehlerhaft war. Ein funktionierender Schlüssel wird verschlüsselt in unserem Secrets-Vault aufbewahrt – niemals in unserer Datenbank – und wird nie wieder angezeigt, auch nicht Ihnen selbst.

Was als Nächstes passiert

• Wenn Sie eine statische Website erstellen oder verschieben, erscheint dieses Konto als Deployment-Ziel.

Azure Static Web Apps erstellt Builds aus einem Repository – es gibt keine Möglichkeit, ein hochgeladenes Build zu akzeptieren –, daher muss der Code der Website aus einem verbundenen GitHub-, GitLab- oder Bitbucket-Repository stammen. Verbinden Sie zuerst eines, falls Sie dies noch nicht getan haben.

• Wir erstellen den Dienst in Ihrem Konto, verknüpfen ihn mit dem Repository, binden Ihre benutzerdefinierte Domain ein und lösen Deployments aus. Auf der Seite der Domain werden alle DNS-Einträge aufgeführt, die Azure Static Web Apps benötigt.
• Nutzung und Abrechnung erfolgen über Ihr Konto und sind in Ihrem eigenen Anbieter-Dashboard einsehbar.
• Eine Apex-Domain wird über einen TXT-Eintrag verifiziert und eine Subdomain über ihren CNAME-Eintrag; die Seite der Domain zeigt an, welcher Eintrag für Ihre Domain erforderlich ist.

Wenn keine Verbindung hergestellt werden kann

Azure hat den Dienstprinzipal abgelehnt. Entweder ist der geheime Clientschlüssel abgelaufen – das tun sie immer, entsprechend der von Ihnen gewählten Gültigkeitsdauer – oder die App verfügt in der Ressourcengruppe nicht mehr über die Rolle Mitwirkender. Die beiden Meldungen ähneln sich, prüfen Sie daher die Rollenzuweisung, bevor Sie einen neuen geheimen Schlüssel erstellen.

Es wurde nichts gefunden. Überprüfen Sie, ob die Abonnement-ID und die Ressourcengruppe diejenigen sind, für die Sie die Rolle zugewiesen haben, und ob die Mandanten-ID mit dem Verzeichnis übereinstimmt, in dem die App registriert ist.

Die Meldung besagt, dass der Schlüssel abgelehnt wurde. Meistens liegt es an einem von drei Gründen: Ein Leerzeichen oder Zeilenumbruch wurde mitkopiert, der Schlüssel ist abgelaufen oder er wurde widerrufen bzw. neu generiert, nachdem Sie ihn kopiert haben. Erstellen Sie einen neuen Schlüssel und fügen Sie ihn erneut ein.

Die Verbindung gelingt, aber später schlägt ein Vorgang fehl. Der Schlüssel authentifiziert sich erfolgreich, verfügt jedoch nicht über eine Berechtigung, die für die Aktion erforderlich ist. Erstellen Sie einen neuen Schlüssel mit den oben aufgeführten Berechtigungen, trennen Sie dann die alte Verbindung und verbinden Sie den neuen Schlüssel.

Verbindung trennen

Öffnen Sie Integrationen, suchen Sie das Konto und klicken Sie auf Trennen. Dadurch wird der gespeicherte Schlüssel sofort gelöscht. Jeder Vorgang, der ihn verwendet hat, stoppt bei der nächsten Aktion, und die davon abhängigen Ansichten weisen darauf hin, anstatt stillschweigend fehlzuschlagen.

Das Trennen der Verbindung macht bereits erfolgte Aktionen nicht rückgängig – Einträge, Deployments oder Einstellungen, die wir in Ihrem Konto geändert haben, bleiben unverändert bestehen. Wenn Sie vermuten, dass der Schlüssel kompromittiert wurde, widerrufen Sie ihn zusätzlich beim Anbieter; durch das Trennen wird lediglich unsere Kopie gelöscht, nicht die des Anbieters.