Aangepaste domeinen met Azure Static Web Apps

  • Artikel

Standaard biedt Azure Static Web Apps een automatisch gegenereerde domeinnaam voor uw website, maar u kunt een aangepast domein naar uw site laten verwijzen. Gratis SSL/TLS-certificaten worden automatisch gemaakt voor de automatisch gegenereerde domeinnaam en eventuele aangepaste domeinen die u kunt toevoegen.

Wanneer u een aangepast domein toe wijzen aan een statische web-app, hebt u een aantal opties beschikbaar. U kunt subdomeinen en een apex-domein configureren.

De volgende tabel bevat koppelingen naar artikelen die laten zien hoe u een aangepast providertype op basis van een domein configureert. 1

Actie Gebruik... Gebruik...
Een domein instellen met het www subdomein Azure DNS Externe provider
Een apex-domein instellen Azure DNS Externe provider

1 Sommige registrars zoals GoDaddy en Google bieden geen ondersteuning voor domeinrecords die van invloed zijn op hoe u uw apex-domein configureert. Overweeg om Azure DNS bij deze registrars te gebruiken om uw apex-domein in te stellen.

Notitie

Het toevoegen van een aangepast domein aan een preview-omgeving wordt niet ondersteund. Unicode-domeinen, waaronder Punycode-domeinen en het xn-- voorvoegsel, worden ook niet ondersteund.

Over domeinen

Het instellen van een apex-domein is een veelvoorkomend scenario dat moet worden geconfigureerd zodra uw domeinnaam is ingesteld. Het maken van een apex-domein wordt bereikt door een ALIAS of ANAME record te configureren of door CNAME middel van afvlakken. Sommige domeinregistrars, zoals GoDaddy en Google, bieden geen ondersteuning voor deze DNS-records. Als uw domeinregistrar niet alle DNS-records ondersteunt die u nodig hebt, kunt u overwegen Azure DNS te gebruiken om uw domein te configureren.

Voor domeinregistrars die geen ondersteuning bieden ALIAS voor records, ANAME records of CNAME platmaken, kunt u ook een A record configureren voor uw statische web-app. Hiermee wordt verkeer omgeleid naar één regionale host van uw statische web-app. Het gebruik van A records wordt niet aanbevolen omdat uw toepassing niet langer profiteert van de wereldwijde distributie. Dit kan van invloed zijn op de prestaties van uw toepassing als uw verkeer wereldwijd wordt gedistribueerd.

Hieronder vindt u termen die u tegenkomt tijdens het instellen van een aangepast domein.

  • Apex- of hoofddomeinen: Gezien het domein www.example.comwordt het www voorvoegsel het subdomein genoemd, terwijl het resterende segment van example.com het apex-domein wordt genoemd.

  • Domeinregistrar: Een registrar controleert de beschikbaarheid van een domein en verkoopt de rechten om een domeinnaam aan te schaffen.

  • DNS-zone: een DNS-zone (Domain Name System) host de DNS-records die zijn gekoppeld aan een specifiek domein. Er zijn verschillende records beschikbaar die verkeer voor verschillende doeleinden omleiden. Het domein example.com kan bijvoorbeeld verschillende DNS-records bevatten. Eén record verwerkt verkeer voor mail.example.com (voor een e-mailserver) en een andere www.contoso.com (voor een website).

  • DNS-hosting: een DNS-host onderhoudt DNS-servers die een domeinnaam omzetten in een specifiek IP-adres.

  • Naamserver: Een naamserver is verantwoordelijk voor het opslaan van de DNS-records voor een domein.

Aangepaste domeinverificatie werkt alleen met Static Web Apps als de DNS openbaar kan worden omgezet. Nadat het domein is toegevoegd, moet aan een van de volgende voorwaarden worden voldaan om automatische certificaatvernieuwing te laten werken:

  • Zorg ervoor dat de openbare INTERNET CNAME DNS-record die wordt gebruikt om het aangepaste domein toe te voegen aan de statische web-app via CNAME-validatie nog steeds aanwezig is. Deze optie is alleen geldig als CNAME-validatie is gebruikt om het domein toe te voegen aan de statische web-app.
  • Zorg ervoor dat het aangepaste domein wordt omgezet in de statische web-app via openbaar internet. Deze optie is geldig, ongeacht de validatiemethode die wordt gebruikt om het domein toe te voegen aan de web-app. Deze methode is geldig, zelfs als privé-eindpunten zijn ingeschakeld, omdat privé-eindpunten voor Static Web Apps internettoegang tot de site-inhoud blokkeren, maar internet-DNS-resolutie niet naar de site blokkeren.

Migratie zonder downtime

Mogelijk wilt u een aangepast domein migreren dat momenteel een productiewebsite naar uw statische web-app biedt, zonder uitvaltijd. DNS-providers accepteren niet meerdere records voor dezelfde naam/host, zodat u uw eigendom van het domein afzonderlijk kunt valideren en verkeer naar uw web-app kunt routeren.

  1. Open uw statische web-app in Azure Portal.
  2. Voeg een TXT-record toe voor uw aangepaste domein (APEX of subdomein). In plaats van de hostwaarde in te voeren zoals weergegeven, voert u de host in uw DNS-provider als volgt in:
    • Voer voor APEX-domeinen de tekst in _dnsauth.www.<YOUR-DOMAIN.COM>.
    • Voer voor subdomeinen in _dnsauth.<SUBDOMAIN>.<YOUR-DOMAIN.COM>.
  3. Zodra uw domein is gevalideerd, kunt u uw verkeer migreren naar uw statische web-app door uw CNAME, ALIASof A record bij te werken zodat deze verwijst naar uw standaardhostnaam

Volgende stappen

Gebruik de volgende koppelingen voor stappen voor het instellen van uw domein op basis van uw provider.