Zelfstudie: Een bestaande aangepaste DNS-naam toewijzen aan Azure App Service

Azure App Service biedt een uiterst schaalbare webhostingservice met self-patchfunctie. In deze zelfstudie ziet u hoe u een bestaande aangepaste DNS-naam (Domain Name System) toewijst aan App Service.

In deze zelfstudie leert u het volgende:

  • Wijs een subdomein toe met behulp van een CNAME-record.
  • Wijs een hoofddomein toe met behulp van een A-record.
  • Wijs een wildcard-domein toe met behulp van een CNAME-record.
  • Een standaard-URL omleiden naar een aangepaste map.

1. Uw omgeving voorbereiden

  • Maak een App Service-app, of gebruik een app die u hebt gemaakt voor een andere zelfstudie.

  • Zorg ervoor dat u DNS-records voor uw aangepaste domein kunt bewerken. Als u nog geen aangepast domein hebt, kunt u een App Service aanschaffen.

    Notitie

    Als u DNS-records wilt bewerken, hebt u toegang nodig tot het DNS-register voor uw domeinprovider, zoals GoDaddy. Als u bijvoorbeeld DNS-vermeldingen voor contoso.com en www.contoso.com wilt toevoegen, moet u de DNS-instellingen voor het hoofddomein van contoso.com kunnen configureren.

2. De app voorbereiden

Als u een aangepaste DNS-naam wilt aan een web-app, moet het App Service-abonnement van de web-app een betaalde laag zijn (niet Gratis (F1).

Aanmelden bij Azure

Open Azure Portal en meld u aan met uw Azure-account.

Selecteer de app in de Azure-portal

  1. Zoek en selecteer App Services.

    Schermopname van de selectie van App Services.

  2. Selecteer op de pagina App Services de naam van uw Azure-app.

    Schermopname van de portalnavigatie naar een Azure-app.

    U ziet de beheerpagina van de App Service-app.

Controleer de prijscategorie

  1. Schuif in het linkerdeelvenster op de app-pagina naar de sectie Instellingen en selecteer Omhoog schalen (App Service-plan) .

    Schermopname van het menu Omhoog schalen (App Service-plan).

  2. De huidige laag van de app wordt gemarkeerd door een blauwe rand. Controleer of de app zich niet in de F1-categorie bevindt. Aangepaste DNS wordt niet ondersteund in de F1-categorie.

    Schermopname met de aanbevolen prijscategorieën.

  3. Als het App Service abonnement zich niet in de F1-laag, sluit u de pagina Omhoog schalen en gaat u verder met 3. Haal een domeinverificatie-id op.

Het App Service-plan opschalen

  1. Selecteer een van de lagen die niet gratis zijn (D1, B1, B2, B3 of een laag in de categorie Productie). Selecteer Aanvullende opties bekijken voor aanvullende opties.

  2. Selecteer Toepassen.

    Schermopname waarin de controle van de prijscategorie wordt weergegeven.

    Wanneer u de volgende melding ziet, is de schaalbewerking voltooid.

    Schermopname waarin de bevestiging van de schaalbewerking wordt weergegeven.

3. Een domeinverificatie-id op halen

Als u een aangepast domein wilt toevoegen aan uw app, moet u verifiëren dat u de eigenaar van het domein bent door een verificatie-id als TXT-record toe te voegen bij uw domeinprovider.

  1. Selecteer Aangepaste domeinen in het linkerdeelvenster van de app-pagina.

  2. Kopieer de id in het vak Verificatie-id aangepast domein op de pagina Aangepaste domeinen voor de volgende stap.

    Schermopname met de id in het vak Verificatie-id aangepast domein.

    Waarschuwing

    Het toevoegen van domeinverificatie-id's aan uw aangepaste domein kan zwevende DNS-vermeldingen voorkomen en overnames van subdomeinen helpen voorkomen. Voor aangepaste domeinen die u eerder hebt geconfigureerd zonder deze verificatie-id, moet u deze beveiligen tegen ditzelfde risico door de verificatie-id toe te voegen aan uw DNS-record. Zie Subdomein overnemen voor meer informatie over deze veelvoorkomende, zeer kritieke bedreiging.

  1. (Alleen een record) Als u een A-record wilttoe te wijsen, hebt u het externe IP-adres van de app nodig. Kopieer op de pagina Aangepaste domeinen de waarde van IP-adres.

    Schermopname van de portalnavigatie naar een Azure-app.

4. De DNS-records maken

  1. Meld u aan bij de website van uw domeinprovider.

    Notitie

    Als u wilt, kunt u Azure DNS DNS-records voor uw domein beheren en een aangepaste DNS-naam configureren voor Azure App Service. Zie Zelfstudie: Uw domein in Azure DNS hosten voor meer informatie.

  2. Ga naar de pagina voor het beheren van DNS-records.

    Notitie

    Elke domeinprovider heeft zijn eigen interface voor het beheren van DNS-records. Raadpleeg daarom de documentatie van de provider. Doorgaans heeft het sitegedeelte waar u moet zijn, een naam als Domain Name, DNS of Name Server Management.

    Vaak kunt u de pagina met DNS-records vinden door uw accountgegevens te bekijken en te zoeken naar een link als My domains (of iets vergelijkbaars). Ga naar de betreffende pagina en kijk of u daar een link ziet zoals Zone file, DNS Records of Advanced configuration.

    In de schermafbeelding hieronder wordt een voorbeeld van een pagina met DNS-records weergegeven:

    Schermopname met een voorbeeld van de pagina DNS-records.

  3. Selecteer Toevoegen of de juiste widget om een record te maken.

  4. Selecteer het type record dat u wilt maken en volg de instructies. U kunt ofwel een CNAME-record of een A-record gebruiken voor het toewijzen van een aangepaste DNS-naam aan App Service.

    Notitie

    Welke record u moet kiezen

    • Gebruik een A-record om het hoofddomein toe te contoso.com geven (bijvoorbeeld). Gebruik de CNAME-record niet voor de hoofdrecord (zie RFC 1912 Section 2.4voor meer informatie).
    • Gebruik een CNAME-record om een subdomein toe www.contoso.com te geven (bijvoorbeeld).
    • U kunt een subdomein rechtstreeks met een A-record aan het IP-adres van de app toe te wijsen, maar het is mogelijk dat het IP-adres wijzigt. De CNAME wordt in plaats daarvan aan de standaardhostnaam van de app toebeland, die minder vatbaar is voor wijziging.
    • Gebruik een CNAME-record om een wildcard-domein toe te *.contoso.com geven (bijvoorbeeld ).

Maak voor een subdomein zoals www in twee records op basis van de volgende www.contoso.com tabel:

Recordtype Host Waarde Opmerkingen
CNAME <subdomain> (bijvoorbeeld www ) <app-name>.azurewebsites.net De domeintoewijzing zelf.
TXT asuid.<subdomain> (bijvoorbeeld asuid.www ) De verificatie-id die u eerder hebt ontvangen De TXT-record asuid.<subdomain> wordt geopend met App Service om te verifiëren dat u de eigenaar bent van het aangepaste domein.

Schermopname van de portalnavigatie naar een Azure-app.

Notitie

Bij bepaalde providers, zoals GoDaddy, worden wijzigingen in DNS-records pas van kracht wanneer u op een afzonderlijke link Save Changes klikt.

5. De toewijzing inschakelen in uw app

  1. Selecteer Aangepaste domeinen in het linkerdeelvenster van de app-pagina in Azure Portal.

    Schermopname met het menu Aangepaste domeinen.

  2. Selecteer Aangepast domein toevoegen.

    Schermopname van het item Hostnaam toevoegen.

  1. Typ de volledig gekwalificeerde domeinnaam in waarvoor u een CNAME-record zoals www.contoso.com heeft toegevoegd.

  2. Selecteer Valideren. De pagina Aangepast domein toevoegen wordt weergegeven.

  3. Zorg ervoor dat Hostnaam recordtype is ingesteld op CNAME (www.example.com of elk subdomein) . Selecteer Aangepast domein toevoegen.

    Schermopname van de knop Aangepast domein toevoegen.

    Het kan even duren voor het nieuwe aangepaste domein wordt weergegeven op de pagina Aangepaste domeinen van de app. Vernieuw de browser om de gegevens bij te werken.

    Schermopname van het toevoegen van het CNAME-record.

    Notitie

    Een waarschuwingslabel voor uw aangepaste domein betekent dat het nog niet is gebonden aan een TLS/SSL-certificaat. Een HTTPS-aanvraag van een browser naar uw aangepaste domein krijgt afhankelijk van de browser, een fout of waarschuwing. Zie Een aangepaste DNS-naam beveiligen met een TLS/SSL-binding in Azure App Service om een TLS-binding toe te voegen.

    Als u een stap hebt gemist of eerder ergens een typefout hebt gemaakt, wordt er een verificatiefoutmelding aan de onderkant van de pagina weergegeven.

    Schermopname waarin een verificatiefoutmelding wordt weergegeven.

6. Testen in een browser

Blader naar de DNS-namen die u eerder hebt geconfigureerd.

Schermopname van de navigatie naar een Azure-app.

Als u een HTTP 404-fout (niet gevonden) ontvangt wanneer u naar de URL van uw aangepaste domein bladert, zijn dit de twee meest voorkomende oorzaken:

  • Bij het geconfigureerde aangepaste domein ontbreekt een A-record of een CNAME-record. Mogelijk hebt u de DNS-record verwijderd nadat u de toewijzing in uw app hebt ingeschakeld. Controleer of de DNS-records juist zijn geconfigureerd met behulp van een online hulpprogramma voor DNS-opzoekfunctie.
  • De browserclient heeft het oude IP-adres van uw domein in de cache. Maak de cache leeg en test DNS-omzetting opnieuw. Op een Windows-computer, leegt u de cache met ipconfig /flushdns.

Een actief domein migreren

Zie voor het zonder downtime migreren van een live site en de DNS-domeinnaam naar App Service Een actieve DNS-naam migreren naar Azure App Service.

Een aangepaste map omleiden

Notitie

Standaard stuurt App Service webaanvragen naar de hoofdmap van uw app-code. Bepaalde web-frameworks starten echter niet in de hoofdmap. Bijvoorbeeld: Laravel start in de submap public. Als u wilt doorgaan met het DNS-voorbeeld, is een dergelijke app toegankelijk op , maar doorgaans wilt u in plaats daarvan contoso.com http://contoso.com/public naar de map http://contoso.com public gaan.

Hoewel dit een veelvoorkomende situatie is, gaat het niet echt om aangepaste DNS-toewijzing, maar om het aanpassen van de virtuele map in uw app.

  1. Selecteer Toepassingsinstellingen in het linkerdeelvenster van uw web-app-pagina.

  2. Aan de onderkant van de pagina verwijst de virtuele hoofdmap / standaard naar site\wwwroot. Dit is de hoofdmap van uw app-code. Wijzig deze om in plaats daarvan bijvoorbeeld te verwijzen naar de site\wwwroot\public en sla de wijzigingen op.

    Schermopname van het aanpassen van een virtuele map.

  3. Nadat de bewerking is uitgevoerd, controleert u dit door te navigeren naar het hoofdpad van uw app in de browser http://contoso.com (bijvoorbeeld of http://<app-name>.azurewebsites.net ).

Automatiseren met scripts

U kunt het beheer van aangepaste domeinen met scripts automatiseren met behulp van de Azure CLI of Azure PowerShell.

Azure CLI

De volgende opdracht voegt een geconfigureerde aangepaste DNS-naam toe aan een App Service-app.

az webapp config hostname add \
    --webapp-name <app-name> \
    --resource-group <resource_group_name> \
    --hostname <fully_qualified_domain_name>

Zie voor meer informatie Een aangepast domein toewijzen aan een web-app.

Azure PowerShell

Notitie

In dit artikel wordt de Azure Az PowerShell-module gebruikt. Dit is de aanbevolen PowerShell-module voor interactie met Azure. Raadpleeg Azure PowerShell installeren om aan de slag te gaan met de Az PowerShell-module. Raadpleeg Azure PowerShell migreren van AzureRM naar Az om te leren hoe u naar de Azure PowerShell-module migreert.

De volgende opdracht voegt een geconfigureerde aangepaste DNS-naam toe aan een App Service-app.

Set-AzWebApp `
    -Name <app-name> `
    -ResourceGroupName <resource_group_name> ` 
    -HostNames @("<fully_qualified_domain_name>","<app-name>.azurewebsites.net")

Zie voor meer informatie Een aangepast domein toewijzen aan een web-app.

Volgende stappen

Ga door naar de volgende zelfstudie om te leren hoe u een aangepast TLS/SSL-certificaat aan een web-app kunt toewijzen.