Freigeben über

Benutzerdefinierte Domänen mit Azure Static Web Apps

  • Artikel

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. 1

Aktion Verwenden... Verwenden...
Einrichten einer Domäne mit der Unterdomäne www Azure DNS Externer Anbieter
Einrichten einer Apex-Domäne Azure DNS Externer Anbieter

1 Einige Registrierungsstellen wie GoDaddy und Google unterstützen keine Domäneneinträge, die sich auf die Konfiguration Ihrer Apex-Domäne auswirken. Erwägen Sie, Azure DNS mit diesen Registrierungsstellen zu verwenden, um Ihre Apex-Domäne einzurichten.

Hinweis

Das Hinzufügen einer benutzerdefinierten Domäne zu einer Vorschauumgebung wird nicht unterstützt. Unicode-Domänen, einschließlich Punycode-Domänen und das Präfix xn-- werden ebenfalls nicht unterstützt.

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 statischen Web-Apps funktioniert, muss das DNS öffentlich auflösbar sein. Nach dem Hinzufügen der Domäne muss eine der folgenden Bedingungen erfüllt sein, damit die automatische Zertifikatverlängerung funktioniert:

  • Stellen Sie sicher, dass der öffentliche Internet-CNAME-DNS-Eintrag, der verwendet wurde, um die benutzerdefinierte Domäne durch CNAME-Validierung zur statischen Web-App hinzuzufügen, vorhanden ist. Diese Option ist nur gültig, wenn die CNAME-Validierung zum Hinzufügen der Domäne zur statischen Web-App verwendet wurde.

  • Stellen Sie sicher, dass die benutzerdefinierte Domäne über das öffentliche Internet in die statische Web-App aufgelöst wird. Diese Option ist unabhängig von der Validierungsmethode gültig, die zum Hinzufügen der Domäne zur Web-App verwendet wurde. Dieser Ansatz ist auch dann gültig, 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.

Nächste Schritte

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