Anpassade domäner med Azure Static Web Apps

  • Artikel

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. Du kan 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ända... Använda...
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 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. Detta dirigerar trafik till en enda regional värd för din statiska webbapp. Du rekommenderas inte att använda A poster eftersom programmet inte längre drar nytta av den globala distributionen, och detta kan påverka programmets prestanda om trafiken distribueras globalt.

Följande är termer som du kommer att 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.contoso.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 CNAME DNS-posten för Internet som används för att lägga till den anpassade domänen i den statiska webbappen via CNAME-valideringen fortfarande finns kvar. Det här alternativet är endast giltigt om CNAME-validering 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 om privata slutpunkter är aktiverade, eftersom privata slutpunkter för Static Web Apps blockerar Internetåtkomst till webbplatsinnehållet men inte blockerar INTERNET DNS-matchning till 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/värd, så du kan separat verifiera ägarskapet för domänen 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.