Configurer un domaine apex dans Azure Static Web Apps
Les noms de domaine sans sous-domaine sont appelés « domaines apex » ou « domaines racines ». Par exemple, le domaine www.example.com
est le www
sous-domaine joint au domaine apex example.com
.
Certains bureaux d’enregistrement de domaines (par exemple Google et GoDaddy) ne permettent pas de faire pointer le domaine apex vers une URL existante. Si votre bureau d’enregistrement ne prend pas en charge les enregistrements ALIAS
ou ANAME
, ou qu’il n’autorise pas l’aplatissement CNAME
, envisagez les options suivantes :
- Configurez votre domaine avec Azure DNS.
- Transférez le domaine apex vers le sous-domaine
www
. - Utiliser un enregistrement
A
L’utilisation d’un enregistrement A
dirige votre trafic vers un hôte régional unique de votre application web statique. Lorsqu’elle est activée, votre application web statique ne bénéficie plus de sa distribution globale, ce qui peut affecter les performances de votre application. Envisagez d’utiliser un enregistrement ALIAS
, ANAME
ou CNAME
pour les domaines APEX pour obtenir les meilleures performances.
Ce guide illustre trois options de configuration d’un domaine apex.
Utilisez les étapes pour configurer avec un enregistrement ALIAS si votre bureau d’enregistrement de domaines prend en charge l’enregistrement DNS
ALIAS
.Si votre bureau d’enregistrement de domaine ne prend pas en charge les enregistrements
ALIAS
, mais prend en charge les enregistrementsANAME
ou la mise à platCNAME
, consultez sa documentation sur les paramètres de configuration.Utilisez les étapes de l’étape transférer vers le sous-domaine www si votre bureau d’enregistrement de domaines ne prend pas en charge l’enregistrement DNS
ALIAS
.Utilisez les étapes pour configurer avec un enregistrement A si les options ci-dessus ne vous conviennent pas. Avec un enregistrement
A
, votre trafic est dirigé vers un seul hôte Static Web Apps et votre application ne bénéficie plus des améliorations des performances fournies par la distribution globale.
Remarque
L’enregistrement CNAME
mappe un nom de domaine à un autre domaine (ou sous-domaine), tandis que l’enregistrement A
mappe un nom de domaine à une adresse IP. Si l’adresse IP change, une entrée CNAME
est toujours valide, contrairement à l’enregistrement A
.
Configurer avec un enregistrement ALIAS
Avant de créer l’enregistrement ALIAS
, vous devez vérifier que vous êtes propriétaire du domaine.
Valider la propriété
Ouvrez le portail Azure.
Accédez à votre application web statique.
À partir de la fenêtre Vue d’ensemble, copiez l’URL générée de votre site et copiez-la dans un éditeur de texte pour une utilisation ultérieure.
Sous Paramètres, sélectionnez Domaines personnalisés.
Sélectionnez Ajouter.
Sous l’onglet Entrer un domaine, entrez le nom de votre domaine apex.
Par exemple, si votre nom de domaine est
example.com
, entrezexample.com
dans cette zone (sans aucun sous-domaine).Cliquez sur Suivant.
Sous l’onglet Vérifier + configurer, entrez les valeurs suivantes.
Paramètre Valeur Nom de domaine Cette valeur doit correspondre au nom de domaine que vous avez entré à l’étape précédente. Type d’enregistrement du nom d’hôte Sélectionnez TXT. Sélectionnez Générer un code.
Attendez que le code soit généré. Cette opération peut prendre environ une minute.
Une fois que la valeur de l’enregistrement
TXT
est générée, copiez le code dans le Presse-papiers (à côté de la valeur générée).Sélectionnez Fermer.
Ouvrez un nouvel onglet de navigateur et connectez-vous à votre compte de bureau d’enregistrement de domaine.
Accédez aux paramètres de configuration DNS de votre nom de domaine.
Ajoutez un nouvel enregistrement
TXT
avec les valeurs suivantes.Paramètre Valeur Type TXT
Hôte Entrez @ Valeur Collez la valeur de code générée que vous avez copiée à partir du Portail Azure. TTL (le cas échéant) Laissez la valeur par défaut. Enregistrez les modifications apportées à votre enregistrement DNS.
Configurer un enregistrement ALIAS
Retournez aux paramètres de configuration DNS de votre nom de domaine.
Ajoutez un nouvel enregistrement
ALIAS
avec les valeurs suivantes.Paramètre Valeur Type ALIAS
Hôte Entrez @ Valeur Collez l’URL générée que vous avez copiée à partir du Portail Azure. Veillez à supprimer le préfixe https://
de votre URL.TTL (le cas échéant) Laissez la valeur par défaut. Enregistrez les modifications apportées à votre enregistrement DNS.
Étant donné que les paramètres DNS doivent se propager, ce processus peut prendre un certain temps.
Ouvrez un nouvel onglet de navigateur et accédez à votre domaine apex.
Une fois les enregistrements DNS mis à jour, vous devriez voir votre application web statique dans le navigateur. Inspectez aussi l’emplacement pour vérifier que l’accès à votre site est sécurisé avec
https
.
Transférer vers le sous-domaine www
Chaque bureau d’enregistrement de domaines a un processus différent pour la gestion des noms de domaine. Une fois que vous êtes connecté à votre compte avec votre bureau d’enregistrement de domaines, recherchez les options de transfert de domaine. Certains bureaux d’enregistrement de domaines ont cette fonctionnalité qui est indiquée sous Options DNS, tandis que d’autres les font figurer avec les options de site web.
Lorsque vous configurez le transfert, assurez-vous que vous configurez uniquement le domaine apex à transférer vers le sous-domaine www
.
Pour plus d’informations, consultez la documentation de votre bureau d’enregistrement de domaines.
Configurer avec un enregistrement A
Avant de créer l’enregistrement A
, vous devez vérifier que vous êtes propriétaire du domaine.
Valider la propriété
Ouvrez le portail Azure.
Accédez à votre application web statique.
Dans la fenêtre Vue d’ensemble dans le coin supérieur droit de la section Essentials, sélectionnez Vue JSON.
Copiez la valeur de la propriété
stableInboundIP
et mettez-la de côté dans un éditeur de texte pour une utilisation ultérieure. Il s’agit de l’adresse IP de votre hôte Static Web Apps régional.Sous Paramètres, sélectionnez Domaines personnalisés.
Sélectionnez Ajouter.
Sous l’onglet Entrer un domaine, entrez le nom de votre domaine apex.
Par exemple, si votre nom de domaine est
example.com
, entrezexample.com
dans cette zone (sans aucun sous-domaine).Cliquez sur Suivant.
Sous l’onglet Vérifier + configurer, entrez les valeurs suivantes.
Paramètre Valeur Nom de domaine Cette valeur doit correspondre au nom de domaine que vous avez entré à l’étape précédente. Type d’enregistrement du nom d’hôte Sélectionnez TXT. Sélectionnez Générer un code.
Attendez que le code soit généré. Cette opération peut prendre environ une minute.
Une fois que la valeur de l’enregistrement
TXT
est générée, copiez le code dans le Presse-papiers (à côté de la valeur générée).Sélectionnez Fermer.
Ouvrez un nouvel onglet de navigateur et connectez-vous à votre compte de bureau d’enregistrement de domaine.
Accédez aux paramètres de configuration DNS de votre nom de domaine.
Ajoutez un nouvel enregistrement
TXT
avec les valeurs suivantes.Paramètre Valeur Type TXT
Hôte Entrez @ Valeur Collez la valeur de code générée que vous avez copiée à partir du Portail Azure. TTL (le cas échéant) Laissez la valeur par défaut. Enregistrez les modifications apportées à votre enregistrement DNS.
Configurer un enregistrement A
Retournez aux paramètres de configuration DNS de votre nom de domaine.
Ajoutez un nouvel enregistrement
A
avec les valeurs suivantes.Paramètre Valeur Type A
Hôte Entrez @ Valeur Collez la valeur stableInboundIP
que vous avez copié à partir du portail Microsoft Azure.TTL (le cas échéant) Laissez la valeur par défaut. Enregistrez les modifications apportées à votre enregistrement DNS.
Étant donné que les paramètres DNS doivent se propager, ce processus peut prendre un certain temps.
Ouvrez un nouvel onglet de navigateur et accédez à votre domaine apex.
Une fois les enregistrements DNS mis à jour, vous devriez voir votre application web statique dans le navigateur. Inspectez aussi l’emplacement pour vérifier que l’accès à votre site est sécurisé avec
https
.