Partage via

Domaines personnalisés avec Azure Static Web Apps

  • Article

Par défaut, Azure Static Web Apps fournit un nom de domaine généré automatiquement à votre site web, mais vous pouvez faire pointer un domaine personnalisé vers votre site. Des certificats SSL/TLS gratuits sont créés automatiquement pour le nom de domaine généré automatiquement et tous les domaines personnalisés que vous pouvez ajouter.

Lorsque vous mappez un domaine personnalisé à une application web statique, vous disposez de plusieurs options, notamment la configuration de sous-domaines et d’un domaine apex.

Le tableau suivant contient des liens vers des articles qui montrent comment configurer un type de fournisseur basé sur un domaine personnalisé. 1

Action Avec… Avec…
Configurer un domaine avec le sous-domaine www Azure DNS Fournisseur externe
Configurer un domaine apex Azure DNS Fournisseur externe

1 Certains bureaux d’enregistrement de domaine tels que GoDaddy et Google ne prennent pas en charge les enregistrements de domaine qui affectent la façon dont vous configurez votre domaine apex. Envisagez d’utiliser Azure DNS avec ces bureaux d’enregistrement de domaine pour configurer votre domaine apex.

Remarque

L’ajout d’un domaine personnalisé à unenvironnement d’aperçu n’est pas pris en charge. Les domaines Unicode, y compris les domaines Punycode et le préfixe xn-- ne sont pas non plus pris en charge.

À propos des domaines

La configuration d’un domaine apex est un scénario courant à configurer une fois que votre nom de domaine est configuré. Pour créer un domaine apex, vous devez configurer un enregistrement ALIAS ou ANAME ou une mise à plat CNAME. Certains bureaux d’enregistrement de domaines comme GoDaddy et Squarespace (anciennement Google) ne prennent pas en charge ces enregistrements DNS. Si votre bureau d’enregistrement de domaines ne prend pas en charge tous les enregistrements DNS dont vous avez besoin, envisagez d’utiliser Azure DNS pour configurer votre domaine.

Par ailleurs, pour les bureaux d’enregistrement de domaines qui ne prennent pas en charge les enregistrements ALIAS, ANAME ou CNAME, vous pouvez configurer un enregistrement A pour votre application web statique. Cette configuration dirige le trafic vers un seul hôte régional de votre application web statique. L’utilisation d’enregistrements A n’est pas recommandée car votre application ne bénéficie plus d’une distribution globale, et ce type de configuration peut affecter les performances de l’application si votre trafic est distribué à l’échelle mondiale.

Voici les termes que vous pourriez rencontrer lors de la création d’un domaine personnalisé.

  • Domaines apex ou root : étant donné le domaine www.example.com, le préfixe www est appelé « sous-domaine », tandis que le segment restant de example.com est appelé « domaine apex ».

  • Bureau d’enregistrement de domaines : un bureau d’enregistrement vérifie la disponibilité qu’un domaine vende les droits d’achat d’un nom de domaine.

  • Zone DNS: une zone DNS (Domain Name System) héberge les enregistrements DNS associés à un domaine spécifique. Différents enregistrements sont disponibles pour le trafic direct à des fins différentes. Par exemple, le domaine example.com peut contenir plusieurs enregistrements DNS. Un enregistrement gère le trafic pour mail.example.com (pour un serveur de messagerie) et un autre www.example.com pour un site web.

  • Hébergement DNS : un hôte DNS gère les serveurs DNS qui résolvent un nom de domaine en une adresse IP spécifique.

  • Serveur de noms : un serveur de noms est chargé de stocker les enregistrements DNS d’un domaine.

Pour que la vérification de domaine personnalisée fonctionne avec Static Web Apps, le DNS doit pouvoir être résolu publiquement. Après l’ajout du domaine, l’une des conditions suivantes doit être remplie pour que le renouvellement automatique du certificat fonctionne :

  • Vérifiez que l’enregistrement DNS CNAME de l’Internet public utilisé pour ajouter le domaine personnalisé à l’application web statique via la validation CNAME est toujours présent. Cette option est valide uniquement si la validation CNAME a été utilisée pour ajouter le domaine à l’application web statique.

  • Vérifiez que le domaine personnalisé se résout en application web statique sur l’Internet public. Cette option est valide quelle que soit la méthode de validation utilisée pour ajouter le domaine à l’application web. Cette approche est valide même lorsque vous activez des points de terminaison privés. L’objectif d’un point de terminaison privé pour les applications web statiques est de bloquer l’accès Internet au contenu du site, mais pas de bloquer la résolution DNS Internet vers le site.

Migration sans temps d’arrêt

Vous pouvez vouloir migrer un domaine personnalisé qui dessert actuellement un site web de production vers votre application web statique sans interruption de service. Les fournisseurs de DNS n’acceptent pas plusieurs enregistrements pour le même nom et le même hôte, ce qui vous permet de valider séparément votre propriété du domaine et d’acheminer le trafic vers votre application web.

  1. Sur le portail Azure, ouvrez votre application web statique.

  2. Ajoutez un enregistrement TXT pour votre domaine personnalisé (APEX ou sous-domaine). Plutôt que d’entrer la valeur Host telle qu’elle est affichée, entrez l’Host dans votre fournisseur DNS de la manière suivante :

    • Pour les domaines APEX, entrez _dnsauth.www.<YOUR-DOMAIN.COM>.
    • Pour les sous-domaines, entrez _dnsauth.<SUBDOMAIN>.<YOUR-DOMAIN.COM>.

  3. Une fois votre domaine validé, vous pouvez migrer votre trafic vers votre application web statique en mettant à jour votre enregistrement CNAME, ALIAS ou A pour qu’il pointe vers votre nom d’hôte par défaut

Étapes suivantes

Utilisez les liens suivants pour connaître les étapes de configuration de votre domaine en fonction de votre fournisseur.