Freigeben über

Einrichten einer Apex-Domäne in Azure Static Web Apps

  • Artikel

Domänennamen ohne Unterdomäne werden als Apex- oder Stammdomänen (root) bezeichnet. Die Domäne www.example.com ist beispielsweise die Unterdomäne www, die mit der Apex-Domäne example.com verknüpft ist.

Einige Domänenregistrierungsstellen (z. B. Google und GoDaddy) ermöglichen es Ihnen nicht, die Apex-Domäne auf eine vorhandene URL zu verweisen. Wenn Ihre Registrierungsstelle ALIAS- oder ANAME-Datensätze nicht unterstützt oder die CNAME-Vereinfachung nicht zulässt, sollten Sie die folgenden Optionen in Betracht ziehen:

  • Konfigurieren Ihrer Domäne mit Azure DNS
  • Weiterleiten der Apex-Domäne an die www-Unterdomäne
  • Verwenden eines A-Datensatzes

Die Verwendung eines A-Datensatzes leitet Ihren Datenverkehr an einen einzelnen regionalen Host Ihrer statischen Web-App weiter. Wenn diese Option aktiviert ist, profitiert Ihre statische Web-App nicht mehr von der globalen Verteilung, und dies kann sich auf die Anwendungsleistung auswirken. Erwägen Sie die Verwendung eines ALIAS-, ANAME- oder CNAME-Datensatzes für APEX-Domänen, um die beste Leistung zu erzielen.

In diesem Leitfaden werden drei Optionen zum Konfigurieren einer Apex-Domäne veranschaulicht.

  • Verwenden Sie die Schritte zum Einrichten mit einem ALIAS-Eintrag, wenn Ihre Domänenregistrierungsstelle den DNS-Eintrag ALIAS unterstützt.

    Wenn Ihre Registrierungsstelle keine ALIAS-Einträge unterstützt, aber ANAME-Einträge oder CNAME-Vereinfachung unterstützt, finden Sie Konfigurationseinstellungen in deren jeweiliger Dokumentation.

  • Verwenden Sie die Schritte unter Weiterleiten an die www-Unterdomäne, wenn Ihre Domänenregistrierungsstelle den DNS-Eintrag ALIAS nicht unterstützt.

  • Führen Sie die Schritte aus, um einen A-Datensatz einzurichten, wenn die oben genannten Optionen nicht geeignet sind. Mit einem A-Datensatz wird Ihr Datenverkehr an einen einzelnen Static Web Apps-Host geleitet, und Ihre App profitiert nicht mehr von den Leistungsverbesserungen, die aus der globalen Verteilung resultieren.

Hinweis

Der CNAME-Datensatz ordnet einen Domänennamen einer anderen Domäne (oder Unterdomäne) zu, während der A-Datensatz einen Domänennamen einer IP-Adresse zuordnet. Wenn sich die IP-Adresse ändert, ist ein CNAME-Datensatz weiterhin gültig, im Gegensatz zu einem A-Datensatz.

Einrichten mit einem ALIAS-Eintrag

Bevor Sie den ALIAS-Eintrag erstellen, müssen Sie zunächst überprüfen, ob Sie die Domäne besitzen.

Überprüfen des Besitzes

  1. Öffnen Sie das Azure-Portal.

  2. Navigieren Sie zu Ihrer statischen Web-App.

  3. Kopieren Sie im Fenster Übersicht die generierte URL Ihrer Website, und legen Sie sie zur zukünftigen Verwendung in einem Text-Editor ab.

  4. Wählen Sie unter Einstellungen die Option Benutzerdefinierte Domänen aus.

  5. Wählen Sie + Hinzufügen aus.

  6. Geben Sie auf der Registerkarte Domäne eingeben Ihren Apex-Domänennamen ein.

    Wenn Ihr Domänenname beispielsweise example.com lautet, geben Sie example.com in dieses Feld ein (ohne Unterdomänen).

  7. Wählen Sie Weiter aus.

  8. Geben Sie auf der Registerkarte Überprüfen und konfigurieren die folgenden Werte ein.

    Einstellung Wert
    Domänenname Dieser Wert sollte mit dem Domänennamen übereinstimmen, den Sie im vorherigen Schritt eingegeben haben.
    Typ des Hostnamenseintrags Wählen Sie TXT aus.

  9. Wählen Sie Code generieren aus.

    Warten Sie, bis der Code generiert wurde. Dies kann ungefähr eine Minute dauern.

  10. Nachdem der TXT-Eintragswert generiert wurde, wählen Sie Kopieren (neben dem generierten Wert) aus, um den Code in die Zwischenablage zu kopieren.

  11. Wählen Sie Schließen aus.

  12. Öffnen Sie eine neue Browserregisterkarte, und melden Sie sich bei Ihrem Domänenregistrierungsstellenkonto an.

  13. Navigieren Sie zu den DNS-Konfigurationseinstellungen Ihres Domänennamens zurück.

  14. Fügen Sie einen neuen TXT-Eintrag mit den folgenden Werten hinzu.

    Einstellung Wert
    type TXT
    Host Geben Sie @ ein
    Wert Fügen Sie den generierten Codewert ein, den Sie aus dem Azure-Portal kopiert haben.
    TTL (falls zutreffend) Als Standardwert übernehmen.

  15. Speichern Sie die Änderungen an Ihrem DNS-Eintrag.

Einrichten eines ALIAS-Eintrags

  1. Kehren Sie zu den DNS-Konfigurationseinstellungen Ihres Domänennamens zurück.

  2. Fügen Sie einen neuen ALIAS-Eintrag mit den folgenden Werten hinzu.

    Einstellung Wert
    type ALIAS
    Host Geben Sie @ ein
    Wert Fügen Sie die generierte URL ein, die Sie aus dem Azure-Portal kopiert haben. Stellen Sie sicher, dass Sie das Präfix https:// aus Ihrer URL entfernen.
    TTL (falls zutreffend) Als Standardwert übernehmen.

  3. Speichern Sie die Änderungen an Ihrem DNS-Eintrag.

    Da DNS-Einstellungen verteilt werden müssen, kann dieser Vorgang einige Zeit dauern.

  4. Öffnen Sie eine neue Browserregisterkarte, und navigieren Sie zu Ihrer Apex-Domäne.

    Nachdem die DNS-Einträge aktualisiert wurden, sollte Ihre statische Web-App im Browser angezeigt werden. Überprüfen Sie außerdem den Standort, um zu überprüfen, ob Ihre Website mithilfe von https sicher bedient wird.

Weiterleiten an die www-Unterdomäne

Jede Domänenregistrierungsstelle verfügt über einen anderen Prozess zum Verwalten von Domänennamen. Nachdem Sie sich bei Ihrem Konto bei Ihrer Registrierungsstelle angemeldet haben, suchen Sie nach Optionen für die Domänenweiterleitung. Bei einigen Registrierungsstellen ist diese Funktion unter DNS-Optionen aufgeführt, während andere Registrierungsstellen sie den Websiteoptionen zugeordnet haben.

Stellen Sie beim Einrichten der Weiterleitung sicher, dass Sie die Weiterleitung an die Unterdomäne www nur für die Apex-Domäne konfigurieren.

Weitere Informationen finden Sie in der Dokumentation Ihrer Registrierungsstelle.

Einrichten mit einem A-Datensatz

Bevor Sie den A-Eintrag erstellen, müssen Sie zunächst überprüfen, ob Sie die Domäne besitzen.

Überprüfen des Besitzes

  1. Öffnen Sie das Azure-Portal.

  2. Navigieren Sie zu Ihrer statischen Web-App.

  3. Wählen Sie im Fenster Übersicht in der oberen rechten Ecke des Abschnitts Zusammenfassung die Option JSON-Ansicht aus.

  4. Kopieren Sie den Wert der stableInboundIP-Eigenschaft, und legen Sie ihn in einem Text-Editor für die zukünftige Verwendung fest. Dies ist die IP-Adresse Ihres regionalen Static Web Apps-Hosts.

  5. Wählen Sie unter Einstellungen die Option Benutzerdefinierte Domänen aus.

  6. Wählen Sie + Hinzufügen aus.

  7. Geben Sie auf der Registerkarte Domäne eingeben Ihren Apex-Domänennamen ein.

    Wenn Ihr Domänenname beispielsweise example.com lautet, geben Sie example.com in dieses Feld ein (ohne Unterdomänen).

  8. Wählen Sie Weiter aus.

  9. Geben Sie auf der Registerkarte Überprüfen und konfigurieren die folgenden Werte ein.

    Einstellung Wert
    Domänenname Dieser Wert sollte mit dem Domänennamen übereinstimmen, den Sie im vorherigen Schritt eingegeben haben.
    Typ des Hostnamenseintrags Wählen Sie TXT aus.

  10. Wählen Sie Code generieren aus.

    Warten Sie, bis der Code generiert wurde. Dies kann ungefähr eine Minute dauern.

  11. Nachdem der TXT-Eintragswert generiert wurde, wählen Sie Kopieren (neben dem generierten Wert) aus, um den Code in die Zwischenablage zu kopieren.

  12. Wählen Sie Schließen aus.

  13. Öffnen Sie eine neue Browserregisterkarte, und melden Sie sich bei Ihrem Domänenregistrierungsstellenkonto an.

  14. Navigieren Sie zu den DNS-Konfigurationseinstellungen Ihres Domänennamens zurück.

  15. Fügen Sie einen neuen TXT-Eintrag mit den folgenden Werten hinzu.

    Einstellung Wert
    type TXT
    Host Geben Sie @ ein
    Wert Fügen Sie den generierten Codewert ein, den Sie aus dem Azure-Portal kopiert haben.
    TTL (falls zutreffend) Als Standardwert übernehmen.

  16. Speichern Sie die Änderungen an Ihrem DNS-Eintrag.

Einrichten eines A-Datensatzes

  1. Kehren Sie zu den DNS-Konfigurationseinstellungen Ihres Domänennamens zurück.

  2. Fügen Sie einen neuen A-Eintrag mit den folgenden Werten hinzu.

    Einstellung Wert
    type A
    Host Geben Sie @ ein
    Wert Fügen Sie den stableInboundIP-Wert ein, den Sie aus dem Azure-Portal kopiert haben.
    TTL (falls zutreffend) Als Standardwert übernehmen.

  3. Speichern Sie die Änderungen an Ihrem DNS-Eintrag.

    Da DNS-Einstellungen verteilt werden müssen, kann dieser Vorgang einige Zeit dauern.

  4. Öffnen Sie eine neue Browserregisterkarte, und navigieren Sie zu Ihrer Apex-Domäne.

    Nachdem die DNS-Einträge aktualisiert wurden, sollte Ihre statische Web-App im Browser angezeigt werden. Überprüfen Sie außerdem den Standort, um zu überprüfen, ob Ihre Website mithilfe von https sicher bedient wird.

Nächste Schritte

Verwalten der Standarddomäne