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 pour 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 quelques options. Vous pouvez configurer des sous-domaines et 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 DNS Azure Fournisseur externe
Configurer un domaine apex DNS Azure 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é à un environnement d’aperçu n’est pas pris en charge. Les domaines Unicode, y compris les domaines Punycode et le xn-- préfixe, 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, tels que GoDaddy et 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.

Vous pouvez également configurer un A enregistrement pour votre application web statique pour les enregistrements, enregistrements ou aplatissements pour les bureaux d’enregistrement de domaine qui ne prennent pas en charge ALIAS les enregistrements, ANAME enregistrements ou CNAME aplatissements. Cela dirige le trafic vers un hôte régional unique de votre application web statique. L’utilisation d’enregistrements A n’est pas recommandée, car votre application ne bénéficie plus de sa distribution globale, ce qui peut affecter les performances de votre application si votre trafic est distribué globalement.

Voici les termes que vous rencontrerez lorsque vous configurerez 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.contoso.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. Une fois le domaine ajouté, l’une des conditions suivantes doit être remplie pour que le renouvellement automatique des certificats fonctionne :

  • Vérifiez que l’enregistrement DNS CNAME 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 si les points de terminaison privés sont activés, car les points de terminaison privés pour Static Web Apps bloquent l’accès à Internet au contenu du site, mais ne bloquent pas la résolution DNS Internet sur le site.

Migration sans temps d’arrêt

Vous pouvez migrer un domaine personnalisé qui sert actuellement un site web de production vers votre application web statique sans temps d’arrêt. Les fournisseurs DNS n’acceptent pas plusieurs enregistrements pour le même nom/hôte. Vous pouvez donc valider séparément la propriété du domaine et 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). Au lieu d’entrer la valeur de l’hôte comme indiqué, entrez l’hôte dans votre fournisseur DNS comme suit :
    • 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 CNAMEou ALIASA enregistrement pour pointer 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.