Anpassade domäner med Azure Static Web Apps

Som standard tillhandahåller Azure Static Web Apps ett automatiskt genererat domännamn för din webbplats, men du kan peka en anpassad domän på din webbplats. Kostnadsfria SSL/TLS-certifikat skapas automatiskt för det automatiskt genererade domännamnet och alla anpassade domäner som du kan lägga till.

När du mappar en anpassad domän till en statisk webbapp har du några tillgängliga alternativ, bland annat att konfigurera underdomäner och en apex-domän.

Följande tabell innehåller länkar till artiklar som visar hur du konfigurerar en anpassad domänbaserad providertyp. 1

Åtgärd Användande... Användande...
Konfigurera en domän med underdomänen www Azure DNS Extern provider
Konfigurera en apex-domän Azure DNS Extern provider

1 Vissa registratorer som GoDaddy och Google stöder inte domänposter som påverkar hur du konfigurerar apex-domänen. Överväg att använda Azure DNS med dessa registratorer för att konfigurera din apex-domän.

Kommentar

Det går inte att lägga till en anpassad domän i en förhandsversionsmiljö . Unicode-domäner, inklusive Punycode-domäner och prefixet xn-- stöds inte heller.

Om domäner

Att konfigurera en apex-domän är ett vanligt scenario för att konfigurera när domännamnet har konfigurerats. Att skapa en apex-domän uppnås genom att konfigurera en ALIAS post eller ANAME post eller genom CNAME utplattande. Vissa domänregistratorer som GoDaddy och Squarespace (tidigare Google) stöder inte dessa DNS-poster. Om domänregistratorn inte stöder alla DNS-poster som du behöver kan du överväga att använda Azure DNS för att konfigurera din domän.

Du kan också konfigurera en A post för din statiska webbapp för domänregistratorer som inte stöder ALIAS poster, ANAME poster eller CNAME utplattade poster. Den här konfigurationen dirigerar trafik till en enda regional värd för din statiska webbapp. Att använda A poster rekommenderas inte eftersom ditt program inte längre drar nytta av global distribution, och den här typen av konfiguration kan påverka programmets prestanda om trafiken distribueras globalt.

Följande är termer som du kan stöta på när du konfigurerar en anpassad domän.

  • Apex- eller rotdomäner: Med tanke på domänen www.example.comwww kallas prefixet underdomänen, medan det återstående segmentet i example.com kallas för apex-domänen.

  • Domänregistrator: En registrator verifierar tillgängligheten för en domän som säljer rättigheterna att köpa ett domännamn.

  • DNS-zon: En DNS-zon (Domain Name System) är värd för DE DNS-poster som är associerade med en specifik domän. Det finns olika tillgängliga poster som dirigerar trafik för olika syften. Domänen example.com kan till exempel innehålla flera DNS-poster. En post hanterar trafik för mail.example.com (för en e-postserver) och en annan www.example.com (för en webbplats).

  • DNS-värd: En DNS-värd underhåller DNS-servrar som löser ett domännamn till en specifik IP-adress.

  • Namnserver: En namnserver ansvarar för att lagra DNS-posterna för en domän.

För att anpassad domänverifiering ska fungera med Static Web Apps måste DNS gå att matcha offentligt. När domänen har lagts till måste ett av följande villkor uppfyllas för att automatisk certifikatförnyelse ska fungera:

  • Kontrollera att den offentliga INTERNET-DNS-posten CNAME som används för att lägga till den anpassade domänen i den statiska webbappen via CNAME validering fortfarande finns kvar. Det här alternativet är endast giltigt om CNAME valideringen användes för att lägga till domänen i den statiska webbappen.

  • Kontrollera att den anpassade domänen matchar den statiska webbappen via offentliga Internet. Det här alternativet är giltigt oavsett vilken valideringsmetod som används för att lägga till domänen i webbappen. Den här metoden är giltig även när du aktiverar privata slutpunkter. Syftet med en privat slutpunkt för Static Web Apps är att blockera Internetåtkomst till webbplatsinnehållet, men inte att blockera INTERNET DNS-matchning på webbplatsen.

Noll stilleståndstidsmigrering

Du kanske vill migrera en anpassad domän som för närvarande betjänar en produktionswebbplats till din statiska webbapp utan driftstopp. DNS-leverantörer accepterar inte flera poster för samma namn och värd, så du kan verifiera ägarskapet för domänen separat och dirigera trafik till webbappen.

  1. Öppna din statiska webbapp i Azure-portalen.

  2. Lägg till en TXT-post för din anpassade domän (APEX eller underdomän). I stället för att ange värdvärdet som det visas anger du värden i DNS-providern på följande sätt:

    • För APEX-domäner anger du _dnsauth.www.<YOUR-DOMAIN.COM>.
    • För underdomäner anger du _dnsauth.<SUBDOMAIN>.<YOUR-DOMAIN.COM>.
  3. När domänen har verifierats kan du migrera trafiken till din statiska webbapp genom att uppdatera din CNAME, ALIASeller A post så att den pekar på ditt standardvärdnamn

Nästa steg

Använd följande länkar för steg om hur du konfigurerar din domän baserat på din leverantör.