Benutzerdefinierte Domänen mit Azure Static Web Apps

Standardmäßig stellt Azure Static Web Apps einen automatisch generierten Domainnamen für Ihre Website bereit, aber Sie können eine benutzerdefinierte Domain auf Ihre Website verweisen. Kostenlose SSL/TLS-Zertifikate werden automatisch für den automatisch generierten Domänennamen und alle benutzerdefinierten Domänen erstellt, die Sie möglicherweise hinzufügen.

Wenn Sie einer statischen Web-App eine benutzerdefinierte Domäne zuordnen, stehen Ihnen einige Optionen zur Verfügung, darunter das Konfigurieren von Unterdomänen und einer Apex-Domäne.

Die folgende Tabelle enthält Links zu Artikeln, die veranschaulichen, wie ein auf benutzerdefinierten Domänen basierender Anbietertyp konfiguriert wird. ¹

¹ Einige Registrierungen wie GoDaddy unterstützen keine Domäneneinträge, die sich darauf auswirken, wie Sie Ihre Apex-Domäne konfigurieren. Erwägen Sie, Azure DNS mit diesen Registrierungsstellen zu verwenden, um Ihre Apex-Domäne einzurichten.

Informationen zu Domänen

Das Einrichten einer Apex-Domäne ist ein gängiges Szenario, das konfiguriert werden muss, sobald Ihr Domänenname eingerichtet ist. Das Erstellen einer Apex-Domäne wird durch Konfigurieren eines ALIAS- oder ANAME-Eintrags oder durch CNAME-Vereinfachung erreicht. Einige Domänenregistrierungsstellen wie GoDaddy und Squarespace (ehemals Google) unterstützen diese DNS-Einträge nicht. Wenn Ihre Domänenregistrierungsstelle nicht alle benötigten DNS-Einträge unterstützt, erwägen Sie die Verwendung von Azure DNS, um Ihre Domäne zu konfigurieren.

Alternativ können Sie für Domänenregistrierungsstellen, die keine ALIAS-Datensätze, ANAME-Datensätze oder CNAME-Vereinfachung unterstützen, einen A-Eintrag für Ihre statische Web-App konfigurieren. Diese Konfiguration leitet Datenverkehr an einen einzelnen regionalen Host Ihrer statischen Web-App weiter. Die Verwendung von A-Datensätzen wird nicht empfohlen, da Ihre Anwendung nicht länger von der globalen Verteilung profitiert. Dieses Setup kann sich auf die Anwendungsleistung auswirken, wenn Ihr Datenverkehr global verteilt ist.

Die folgenden Begriffe können Ihnen beim Einrichten einer benutzerdefinierten Domäne begegnen.

• Apex- oder Stammdomänen: Ausgehend von der Domäne www.example.com wird das www-Präfix als Unterdomäne bezeichnet, während das verbleibende Segment example.com als Apex-Domäne bezeichnet wird.

• Domänenregistrierungsstelle: Eine Registrierungsstelle überprüft die Verfügbarkeit einer Domäne und verkauft die Rechte zum Erwerb eines Domänennamens.

• DNS-Zone: Eine DNS-Zone (Domain Name System) hostet die DNS-Einträge, die einer bestimmten Domäne zugeordnet sind. Es sind verschiedene Einträge verfügbar, die Datenverkehr für verschiedene Zwecke umleiten. Beispielsweise kann die Domäne example.com mehrere DNS-Einträge enthalten. Ein Eintrag verarbeitet Datenverkehr für mail.example.com (für einen E-Mail-Server) und ein anderer www.example.com (für eine Website).

• DNS-Hosting: Ein DNS-Host verwaltet DNS-Server, die einen Domänennamen in eine bestimmte IP-Adresse auflösen.

• Namenserver: Ein Namenserver ist für das Speichern der DNS-Einträge für eine Domäne verantwortlich.

Damit die Überprüfung der benutzerdefinierten Domäne mit Static Web Apps funktioniert, muss das DNS öffentlich auflösbar sein. Damit die automatische Verlängerung des Zertifikats funktioniert, muss die angepasste Domäne über das öffentliche Internet auf die statische Web-App aufgelöst werden. Die automatische Verlängerung von Zertifikaten wird auch dann unterstützt, wenn Sie private Endpunkte aktivieren. Der Zweck eines privaten Endpunkts für Static Web Apps besteht darin, den Internetzugriff auf die Websiteinhalte, jedoch nicht die Internet-DNS-Auflösung für die Website zu blockieren.

Migration ohne Downtime

Eventuell wollen Sie eine benutzerdefinierte Domäne migrieren, die derzeit eine Produktionswebsite zu Ihrer statischen Web-App mit null Ausfallzeiten bedient. DNS-Anbieter akzeptieren nicht mehrere Einträge für denselben Namen und denselben Host, sodass Sie den Besitz der Domäne separat überprüfen und den Datenverkehr an Ihre Web-App weiterleiten können.

1. Öffnen Sie Ihre statische Web-App im Azure-Portal.

2. Fügen Sie einen TXT-Eintrag für Ihre benutzerdefinierte Domäne (APEX oder Subdomäne) hinzu. Anstatt den Host-Wert wie angezeigt einzugeben, geben Sie den Host wie folgt in Ihrem DNS-Anbieter ein:

   • Geben Sie für APEX-Domänen _dnsauth.www.<YOUR-DOMAIN.COM> ein.
   • Geben Sie für Unterdomänen _dnsauth.<SUBDOMAIN>.<YOUR-DOMAIN.COM> ein.

3. Nachdem Ihre Domäne überprüft wurde, können Sie Ihren Datenverkehr zu Ihrer statischen Web-App migrieren, indem Sie Ihren CNAME-, ALIAS- oder A-Datensatz so aktualisieren, dass er auf Ihren Standardhostnamen verweist.

Migrieren von Domänen zwischen Instanzen

Azure Static Web Apps erlauben nur die Bindung einer eindeutigen Domäne an eine einzelne Ressource innerhalb eines Datenschnitts. Wenn Sie versuchen, eine Domäne zu binden, die bereits an eine andere Ressource gebunden ist, ohne sie erst von der ursprünglichen Ressource zu lösen, kommt es zu einem Fehler.

Das Segment, in dem Ihre Ressource platziert wird, kann durch Prüfen der ihm zugewiesenen Standard-URL bestimmt werden:

<random-prefix>.<slice>.azurestaticapps.net

Beispielsweise wurde eine Statische Web App-Website mit der Standard-URL orange-pond-0a04b7203.2.azurestaticapps.net in Segment 2 platziert.

Wenn sich die statische App, von der und zu der Sie die Domäne migrieren, im selben Slice befinden, müssen Sie entweder:

• Entfernen Sie die Domäne aus einer Instanz, und fügen Sie sie ihrer neuen Instanz hinzu. Dies führt zu einigen Ausfallzeiten.
• Löschen sie die neue Instanz, und stellen Sie sie erneut bereit, bis die resultierende Ressource in einem Segment platziert wird, das sich von der Quellinstanz unterscheidet.

Nächste Schritte

Unter den folgenden Links finden Sie Schritte zum Einrichten Ihrer Domäne, basierend auf Ihrem Anbieter.

• Verwenden von Azure DNS
• Verwenden eines externen DNS-Anbieters