Fügt der Azure Front Door-Instanz eine benutzerdefinierte Domäne hinzu

Gilt für: ✔️ Front Door (klassisch)

Important

Azure Front Door (klassisch) unterstützt die Profilerstellung, das Onboarding neuer Domänen oder verwaltete Zertifikate nicht und wird auf March 31, 2027 eingestellt. Um Dienstunterbrechungen zu vermeiden, migrieren Sie zu Azure Front Door Standard oder Premium. Weitere Informationen finden Sie unter Azure Front Door (klassisch) Außerbetriebnahme.

In diesem Artikel erfahren Sie, wie Sie Ihrer Azure Front Door Service-Konfiguration eine benutzerdefinierte Domäne hinzufügen. Wenn Sie Azure Front Door für die Anwendungsbereitstellung verwenden, ist eine benutzerdefinierte Domäne erforderlich, sofern Ihr eigener Domänenname in Ihren Endbenutzeranforderungen sichtbar sein soll. Die Verwendung eines sichtbaren Domänennamens kann für Ihre Kunden komfortabel und für Branding-Zwecke hilfreich sein.

Nachdem Sie ein Front-Door-Profil erstellt haben, ist der Standard-Front-End-Host eine Unterdomäne von azurefd.net. Dieser Name ist standardmäßig in der URL für die Bereitstellung von Front Door-Inhalten an Ihr Back-End enthalten. Beispiel: https://contoso-frontend.azurefd.net. Azure Front Door bietet Ihnen die Möglichkeit, dem Endpunkt eine benutzerdefinierte Domäne zuzuordnen. Mit dieser Funktion können Sie Ihre Inhalte mit Ihrer URL statt mit dem Standarddomänennamen der Front Door bereitstellen, z. B. https://www.contoso.com/photo.png.

Wenn Sie nicht über ein Azure-Konto verfügen, erstellen Sie ein kostenloses Konto , bevor Sie beginnen.

Note

Für Front Door werden benutzerdefinierte Domänen mit Punycode-Zeichen nicht unterstützt.

Prerequisites

Erstellen eines CNAME-DNS-Eintrags

Bevor Sie eine benutzerdefinierte Domäne mit Ihrer Front Door verwenden können, müssen Sie zunächst einen kanonischen Namenseintrag (CNAME) bei Ihrem Domänenanbieter erstellen, der auf den Front-End-Standardhost von Front Door verweist. Ein CNAME-Eintrag ist eine Art von DNS-Eintrag, mit dem ein Quelldomänenname einem Zieldomänennamen zugeordnet wird. In Azure Front Door ist der Quelldomänenname Ihr benutzerdefinierter Domänenname und der Zieldomänenname der Name Ihres Azure Front Door-Standardhosts. Sobald Front Door überprüft hat, dass der CNAME-Eintrag erstellt wurde, wird der Datenverkehr zur benutzerdefinierten Quelldomäne an den angegebenen Front Door-Standard-Frontend-Host weitergeleitet.

Eine benutzerdefinierte Domäne kann jeweils nur mit einem Front Door-Profil verknüpft werden. Sie können jedoch verschiedene Unterdomänen einer Apex-Domäne in demselben oder einem anderen Front Door-Profil haben.

Zuordnen der temporären Unterdomäne „afdverify“

Berücksichtigen Sie beim Zuordnen einer vorhandenen Domäne, die sich in der Produktion befindet, die Auswirkungen. Während Sie Ihre benutzerdefinierte Domäne im Azure-Portal registrieren, kann es für die Domäne möglicherweise zu einer kurzen Ausfallzeit kommen. Um Unterbrechungen des Webdatenverkehrs zu vermeiden, ordnen Sie Ihre benutzerdefinierte Domäne Ihrem Front Door-Standard-Frontend-Host zu, indem Sie zuerst die unterdomäne Azure afdverify verwenden, um eine temporäre CNAME-Zuordnung zu erstellen. Ihre Benutzer können ohne Unterbrechung auf Ihre Domäne zugreifen, während die DNS-Zuordnung durchgeführt wird.

Wenn Sie Ihre benutzerdefinierte Domäne zum ersten Mal ohne Produktionsdatenverkehr verwenden, können Sie die benutzerdefinierte Domäne auch direkt Ihrer Azure Front Door Service-Konfiguration zuordnen. Sie können direkt zu Zuordnen der permanenten benutzerdefinierten Domäne springen.

So erstellen Sie einen CNAME-Eintrag mithilfe der Afdverify-Unterdomäne:

  1. Melden Sie sich bei der Website des Domänenanbieters für Ihre benutzerdefinierte Domäne an.

  2. Suchen Sie die Seite zum Verwalten von DNS-Einträgen, indem Sie die Dokumentation des Anbieters konsultieren oder nach Bereichen der Website mit der Bezeichnung "Domain Name", "DNS" oder " Name Server Management" suchen.

  3. Erstellen Sie einen CNAME-Eintrag für Ihre benutzerdefinierte Domäne, und füllen Sie die Felder wie in der folgenden Tabelle gezeigt aus (Feldnamen können variieren):

    Source Type Destination
    afdverify.www.contoso.com CNAME afdverify.contoso-frontend.azurefd.net
    • Quelle: Geben Sie Ihren benutzerdefinierten Domänennamen einschließlich der afdverify Unterdomäne im folgenden Format ein: afdverify.<custom domain name> Beispiel: afdverify.www.contoso.com. Wenn Sie eine Wildcard-Domäne zuordnen, wie z. B. *.contoso.com, ist der Quellwert derselbe wie ohne die Wildcard: afdverify.contoso.com.

    • Typ: Geben Sie CNAME ein.

    • Ziel: Geben Sie Ihren standardmäßigen Front Door-Frontend-Host ein, einschließlich der Afdverify-Unterdomäne, im folgenden Format: afdverify.<endpoint name>.azurefd.net. Beispiel: afdverify.contoso-frontend.azurefd.net.

  4. Speichern Sie die Änderungen.

Für die Domänenregistrierungsstelle GoDaddy gilt beispielsweise folgende Vorgehensweise:

  1. Melden Sie sich an, und wählen Sie die gewünschte benutzerdefinierte Domäne aus.

  2. Wählen Sie im Abschnitt "Domänen" die Option "Alle verwalten" und dann "DNS Manage | Zones" aus.

  3. Geben Sie für "Domänenname" Ihre benutzerdefinierte Domäne ein, und wählen Sie dann " Suchen" aus.

  4. Wählen Sie auf der Seite "DNS-Verwaltung" "Hinzufügen" und dann in der Typliste"CNAME" aus.

  5. Füllen Sie für den CNAME-Eintrag die folgenden Felder aus:

    • Typ: Lassen Sie CNAME ausgewählt.

    • Host: Geben Sie die gewünschte Unterdomäne Ihrer benutzerdefinierten Domäne ein (einschließlich des Unterdomänennamens „afdverify“). Beispiel: afdverify.www.

    • Verweist auf: Geben Sie den Hostnamen Ihres Standard-Front-End-Hosts von Azure Front Door ein, einschließlich des Unterdomänennamens „afdverify“. Beispiel: afdverify.contoso-frontend.azurefd.net.

    • Gültigkeitsdauer: Eine Stunde ausgewählt lassen.

  6. Wählen Sie Speichern aus.

    Der CNAME-Eintrag wird der Tabelle mit den DNS-Einträgen hinzugefügt.

Ordnen Sie die benutzerdefinierte Domäne Ihrem Front Door zu.

Nachdem Sie Ihre benutzerdefinierte Domäne registriert haben, fügen Sie sie Ihrer Front Door hinzu.

  1. Melden Sie sich beim Azure-Portal an, und navigieren Sie zu Azure Front Door mit dem Frontend-Host, den Sie einer benutzerdefinierten Domäne zuordnen möchten.

  2. Wählen Sie auf der + aus, um eine benutzerdefinierte Domäne hinzuzufügen.

  3. Wählen Sie Benutzerdefinierte Domäne aus.

  4. Für Frontend-Host wird der Frontend-Host, der als Zieldomäne Ihres CNAME-Eintrags verwendet werden soll, aus Ihrer Front Door bestimmt und vorgegeben: <default hostname>.azurefd.net. Sie können diese Einstellung nicht ändern.

  5. Geben Sie unter Benutzerdefinierter Hostname Ihre benutzerdefinierte Domäne (einschließlich Unterdomäne) ein, die als Quelldomäne Ihres CNAME-Eintrags verwendet werden soll. Beispiel: „www.contoso.com“ oder „cdn.contoso.com“. Verwenden Sie nicht den Unterdomänennamen „afdverify“.

  6. Wählen Sie Hinzufügen aus.

    Azure überprüft, ob der CNAME-Eintrag für den eingegebenen Namen der benutzerdefinierten Domäne vorhanden ist. Wenn der CNAME-Eintrag korrekt ist, wird Ihre benutzerdefinierte Domäne überprüft.

Warning

Sie müssen sicherstellen, dass jedem Front-End-Host (einschließlich benutzerdefinierter Domänen) in Ihrer Azure Front Door Service-Konfiguration eine Routingregel mit einem Standardpfad („/*“) zugeordnet ist. Das bedeutet, dass für alle Ihre Routingregeln mindestens eine Routingregel für jeden Ihrer Front-End-Hosts unter dem Standardpfad („/*“) definiert sein muss. Wenn Sie diese Einstellung nicht konfigurieren, wird ihr Endbenutzerdatenverkehr möglicherweise nicht ordnungsgemäß weitergeleitet.

Überprüfen der benutzerdefinierten Domäne

Überprüfen Sie nach dem Registrieren Ihrer benutzerdefinierten Domäne, ob diese auf Ihren Azure Front Door Service-Front-End-Standardhost verweist.

Öffnen Sie im Browser die Adresse der Datei mithilfe der benutzerdefinierten Domain. Wenn Ihre benutzerdefinierte Domäne z. B. robotics.contoso.com ist, sollte die URL der zwischengespeicherten Datei mit der folgenden URL vergleichbar sein: http://robotics.contoso.com/my-public-container/my-file.jpg Vergewissern Sie sich, dass das Ergebnis dasselbe ist wie beim direkten Zugriff auf <Front Door host>.azurefd.net.

Dauerhafte benutzerdefinierte Domäne zuordnen

Um die benutzerdefinierte Domäne direkt Ihrem standardmäßigen Front Door-Frontend-Host zuzuordnen, stellen Sie zuerst sicher, dass die Afdverify-Unterdomäne erfolgreich Ihrer Front Door zugeordnet ist. Nach der Überprüfung können Sie mit der Zuordnung der benutzerdefinierten Domäne fortfahren.

Erstellen Sie wie folgt einen CNAME-Eintrag für Ihre benutzerdefinierten Domäne:

  1. Melden Sie sich bei der Website des Domänenanbieters für Ihre benutzerdefinierte Domäne an.

  2. Suchen Sie die Seite zum Verwalten von DNS-Einträgen, indem Sie die Dokumentation des Anbieters konsultieren oder nach Bereichen der Website mit der Bezeichnung "Domain Name", "DNS" oder "Name Server Management" suchen.

  3. Erstellen Sie einen CNAME-Eintrag für Ihre benutzerdefinierte Domäne, und füllen Sie die Felder wie in der folgenden Tabelle gezeigt aus (Feldnamen können variieren):

    Source Type Destination
    <www.contoso.com> CNAME contoso-frontend.azurefd.net
    • Quelle: Geben Sie den Namen Ihrer benutzerdefinierten Domäne ein (z.B. „www.contoso.com“).

    • Typ: Geben Sie CNAME ein.

    • Ziel: Geben Sie ihren Standard-Front Door-Frontend-Host ein. Der Host muss im folgenden Format angegeben werden: <hostname> .azurefd.net. Beispiel: contoso-frontend.azurefd.net.

  4. Speichern Sie die Änderungen.

  5. Wenn Sie zuvor einen temporären CNAME-Eintrag für die Unterdomäne „afdverify“ erstellt haben, löschen Sie diesen Eintrag.

  6. Falls Sie diese benutzerdefinierte Domäne erstmals in der Produktion verwenden, führen Sie die Schritte unter Zuordnen der benutzerdefinierten Domäne zu Ihrer Azure Front Door Service-Konfiguration und Überprüfen der benutzerdefinierten Domäne aus.

Für die Domänenregistrierungsstelle GoDaddy gilt beispielsweise folgende Vorgehensweise:

  1. Melden Sie sich an, und wählen Sie die gewünschte benutzerdefinierte Domäne aus.

  2. Wählen Sie im Abschnitt "Domänen" die Option "Alle verwalten" und dann "DNS Manage | Zones" aus.

  3. Geben Sie für "Domänenname" Ihre benutzerdefinierte Domäne ein, und wählen Sie dann " Suchen" aus.

  4. Wählen Sie auf der Seite "DNS-Verwaltung" "Hinzufügen" und dann in der Typliste"CNAME" aus.

  5. Füllen Sie die Felder für den CNAME-Eintrag aus:

    • Typ: Lassen Sie CNAME ausgewählt.

    • Host: Geben Sie die Unterdomäne der gewünschten benutzerdefinierten Domäne ein. Beispiel: „www“ oder „profile“.

    • Geben Sie den Standardhostnamen Ihrer Front Door ein. Beispiel: contoso.azurefd.net.

    • Gültigkeitsdauer: Eine Stunde ausgewählt lassen.

  6. Wählen Sie Speichern aus.

    Der CNAME-Eintrag wird der Tabelle mit den DNS-Einträgen hinzugefügt.

  7. Wenn Sie über einen afdverify CNAME-Eintrag verfügen, wählen Sie das Stiftsymbol daneben aus, und wählen Sie dann das Papierkorbsymbol aus.

  8. Wählen Sie Löschen, um den CNAME-Eintrag zu löschen.

Bereinigen von Ressourcen

In den vorherigen Schritten haben Sie Ihrer Front Door eine benutzerdefinierte Domäne hinzugefügt. Wenn Sie Ihre Front Door nicht mehr einer benutzerdefinierten Domäne zuordnen möchten, entfernen Sie die benutzerdefinierte Domäne, indem Sie die folgenden Schritte ausführen:

  1. Wechseln Sie zu Ihrem DNS-Anbieter, und löschen Sie entweder den CNAME-Eintrag für die benutzerdefinierte Domäne, oder aktualisieren Sie den CNAME-Eintrag für die benutzerdefinierte Domäne auf einen Nicht-Front Door-Endpunkt.

    Important

    Um hängende DNS-Einträge und die dadurch entstehenden Sicherheitsrisiken zu verhindern, erfordert Azure Front Door ab dem 9. April 2021 das Entfernen der CNAME-Einträge bei Front Door-Endpunkten, bevor Sie die Ressourcen löschen können. Zu den Ressourcen gehören benutzerdefinierte Front Door-Domänen, Front Door-Endpunkte oder Azure Ressourcengruppen mit aktivierten benutzerdefinierten Front Door-Domänen.

  2. Wählen Sie im Frontdoor-Designer die benutzerdefinierte Domäne aus, die Sie entfernen möchten.

  3. Wählen Sie im Kontextmenü für die benutzerdefinierte Domäne Löschen aus. Die benutzerdefinierte Domäne wird aus Ihrem Endpunkt entfernt.

Nächster Schritt