Stocker les URL
Chaque site web d’une installation Adobe Commerce ou Magento Open Source comporte une URL de base attribuée au storefront et une autre URL attribuée à l’administrateur. Adobe utilise des variables pour définir des liens internes par rapport à l’URL de base, ce qui permet de déplacer l’ensemble d’un magasin d’un emplacement à un autre sans mettre à jour les liens. Les URL de base standard commencent par http
et les URL de base sécurisées commencent par https
.
- URL de base —
http://www.yourdomain.com/magento/
- URL de base sécurisée —
https://www.yourdomain.com/magento/
- URL avec adresse IP —
http://###.###.###.###/magento/
ouhttps://###.###.###.###/magento/
Utiliser un protocole sécurisé
Les URL de base de votre boutique ont été initialement configurées lors de votre installation d’Adobe Commerce. Si un certificat de sécurité était disponible à ce moment-là, vous pouviez indiquer les URL HTTPS
à utiliser pour le magasin, l’administrateur ou les deux. Si votre installation d’Adobe Commerce comprend plusieurs magasins ou si vous prévoyez d’en ajouter d’autres ultérieurement, vous pouvez inclure le code du magasin dans l’URL. Toutes les ressources et opérations d’Adobe peuvent être utilisées avec un protocole sécurisé.
Si aucun certificat de sécurité n’était disponible pour le domaine au moment de l’installation, veillez à mettre à jour la configuration avant de lancer votre boutique. Une fois qu’un certificat de sécurité est établi pour votre domaine, vous pouvez configurer les URL de base, ou les deux, pour qu’elles fonctionnent avec le protocole SSL (Secure Sockets Layer) et TLS (Transport Layer Security chiffré.
Par défaut, Adobe Commerce et Magento Open Source peuvent être configurés pour diffuser toutes les pages sur HTTPS
. Si votre boutique fonctionne avec le protocole standard, vous pouvez améliorer la sécurité en activant HTTP Strict Transport Security (HSTS) et en mettant à niveau toutes les requêtes de page non sécurisées. HSTS est un protocole d’accord préalable qui empêche les navigateurs de rendre des pages HTTP
standard qui sont transmises avec un protocole non sécurisé pour le domaine spécifié. Comme les moteurs de recherche peuvent avoir déjà indexé chaque page de votre boutique avec des URL HTTP
standard, vous pouvez configurer Commerce pour mettre à niveau toutes les requêtes de page non sécurisées vers HTTPS
automatiquement , afin de ne pas perdre de trafic. Lorsque Commerce est configuré pour utiliser des URL sécurisées pour le storefront et l’admin, deux champs supplémentaires s’affichent pour vous permettre d’activer HSTS
.
Configuration de l’URL de base
-
Dans la barre latérale Admin, accédez à Stores > Settings>Configuration.
-
Sous Général dans le panneau de gauche, choisissez Web.
-
Développez
-
Base URL — Saisissez l'URL de base complète de votre boutique. Veillez à terminer l’URL par une barre oblique afin qu’elle puisse être étendue avec des clés d’URL supplémentaires provenant de votre boutique. Par exemple :
http://yourdomain.com/
note note NOTE Ne modifiez pas l’espace réservé dans le champ Base Link URL. Il s’agit d’un espace réservé utilisé pour créer des liens relatifs à l’URL de base. -
Base URL for Static View Files — (Facultatif) Spécifiez un autre emplacement pour l'URL de base des fichiers de vue statiques en saisissant le chemin commençant par l'espace réservé suivant :
{{unsecure_base_url}}
-
Base URL for User Media Files — (Facultatif) Spécifiez un autre emplacement pour l’URL de base des fichiers multimédias utilisateur en saisissant le chemin d’accès commençant par l’espace réservé suivant :
{{unsecure_base_url}}
Dans le cas d’une installation standard, il n’est pas nécessaire de mettre à jour les chemins d’accès aux fichiers de vues statiques ou aux fichiers multimédias, car ils sont relatifs à l’URL de base.
note note NOTE Les espaces réservés placés entre doubles accolades sont des balises de mise en forme pour les variables. -
-
Cliquez ensuite sur Save Config.
Configurer l’URL de base sécurisée
Si votre domaine dispose d’un certificat de sécurité valide, vous pouvez configurer les URL du storefront et de l’administrateur pour transmettre les données sur un canal sécurisé (https). Sans certificat de sécurité valide, votre boutique ne peut pas fonctionner avec un protocole sécurisé (SSL/TLS).
-
Développez la section
-
Secure Base URL — Saisissez l'URL de base sécurisée complète, suivie d'une barre oblique. Par exemple :
https://yourdomain.com/
-
Secure Base Link URL — Ne modifiez pas l'espace réservé dans le champ URL du lien de base sécurisé. Il est utilisé pour créer des liens relatifs à l’URL de base sécurisée.
-
Secure Base URL for Static View Files — (Facultatif) Spécifiez un autre emplacement pour l'URL de base sécurisée pour les fichiers de vue statiques en saisissant le chemin commençant par l'espace réservé suivant :
{{secure_base_url}}
-
Secure Base URL for User Media Files — (Facultatif) Spécifiez un autre emplacement pour l'URL de base sécurisée des fichiers multimédias utilisateur en saisissant le chemin commençant par l'espace réservé suivant :
{{secure_base_url}}
-
-
Pour améliorer la sécurité, définissez les deux options suivantes sur
Yes
.- Use Secure URLs on Storefront
- Use Secure URLs in Admin
-
Par Enhanced Security Settings, procédez comme suit :
-
Enable HTTP Strict Transport Security (HSTS) — Si vous souhaitez que votre boutique affiche uniquement les requêtes de page HTTPS sécurisées, définissez sur
Yes
. -
Upgrade Insecure Requests — Pour mettre à niveau des requêtes de pages HTTP standard non sécurisées vers HTTPS sécurisé, définissez sur
Yes
.
-
-
Définissez la Offloader Header de votre serveur .
La plupart des installations Commerce utilisent le
X-Forward-Proto
par défaut pour identifier le protocole comme étantHTTP
ouHTTPS
. Si la configuration de votre serveur utilise un offloader_header différent, saisissez-le ici. -
Cliquez ensuite sur Save Config.
Inclure le code de magasin dans les URL
Yes
, vous devez inclure les codes de boutique dans les URL de votre navigateur. Ce paramètre garantit que les réécritures d’URL sont correctement mappées et que toutes les pages sont ouvertes avec succès, sans erreurs « Page 404 introuvable ».-
Dans la barre latérale Admin, accédez à Stores > Settings>Configuration.
-
Sous General dans le panneau de gauche, choisissez Web.
-
Développez
-
Définissez Add Store Code sur votre préférence :
- URL with Store Code :
http://www.yourdomain.com/magento/[store-code]/index.php/url-identifier
- URL without Store Code :
http://www.yourdomain.com/magento/index.php/url-identifier
- URL with Store Code :
-
Cliquez ensuite sur Save Config.
-
Cliquez sur le lien Cache Management dans le message en haut de l’espace de travail. Suivez ensuite les instructions pour actualiser le cache.
Résolution des problèmes liés aux URL
Si, après avoir suivi les instructions de configuration, certaines pages continuent à être diffusées avec l’URL non sécurisée (http://
), procédez comme suit :
- Remplacez l’URL de base (non sécurisée) par l’URL HTTPS sécurisée.
- Sur le serveur , modifiez le fichier
.htaccess
(ou la répartition de charge) afin que l’URL non sécurisée soit redirigée vers l’URL sécurisée.
Utiliser une URL d’administration personnalisée
En tant que bonne pratique en matière de sécurité, Adobe vous recommande d’utiliser une URL d’administration unique au lieu de la valeur par défaut admin ou un terme courant tel que backend. Bien qu’il ne protège pas directement votre site d’un acteur malveillant déterminé, il peut réduire l’exposition aux scripts qui tentent d’obtenir un accès non autorisé.
Dans une installation standard, l’URL d’administration et le chemin d’accès suivent immédiatement l’URL de base. Le chemin d’accès Admin correspond à un répertoire sous la racine.
- URL de base par défaut :
http://yourdomain.com/magento/
- Chemin d’administration par défaut :
admin
- URL et chemin d’administration par défaut :
http://yourdomain.com/magento/admin
Bien qu’il soit possible de modifier l’URL et le chemin d’accès de l’administrateur vers un autre emplacement, toute erreur supprime l’accès à l’administrateur et doit être corrigée à partir du serveur.
Méthode 1 : changement à partir de l’administrateur
-
Dans la barre latérale Admin, accédez à Stores > Settings>Configuration.
-
Dans le panneau de gauche, développez Advanced et choisissez Admin.
-
Développez
-
Définissez les options de configuration de l’URL personnalisée :
Si nécessaire, décochez la case Use system value pour modifier le paramètre.
-
Définissez Use Custom Admin URL sur
Yes
. -
Saisissez le Custom Admin URL :
http://yourdomain.com/magento/
note note NOTE L’URL d’administration doit se trouver dans la même installation de Commerce et avoir la même racine de document que le storefront. -
Définissez Custom Admin Path sur
Yes
. -
Par Custom Admin Path, saisissez le chemin d’accès à utiliser comme nom de dossier d’administration personnalisé.
Exemple :
sample_custom_admin
-
-
Cliquez ensuite sur Save Config.
-
Une fois les modifications enregistrées, déconnectez-vous de l’administrateur et reconnectez-vous à l’aide de la nouvelle URL d’administrateur et du nouveau chemin d’accès.
Méthode 2 : modifier le chemin d’accès Admin à partir de la ligne de commande du serveur
-
Ouvrez le fichier
app/etc/env.php
dans un éditeur de texte et modifiez la valeur du paramètrefrontName
de la sectionbackend
. Enregistrez ensuite le fichier.Veillez à n’utiliser que des caractères minuscules.
note note NOTE Cette méthode vous permet de modifier le chemin d’accès d’administration, mais pas l’URL d’administration. note tip TIP Pour Adobe Commerce sur les infrastructures cloud, vous pouvez configurer un chemin d’administration personnalisé à l’aide de la variable ADMIN_URL
dans l’interface utilisateur Cloud. Voir la rubrique Variables d’administration dans le guide Commerce sur les infrastructures cloud.-
Chemin d’accès administrateur par défaut
code language-php?start_inline=1 'backend' => [ 'frontName' => 'admin' ],
-
Nouveau chemin d’accès d’administration
code language-php?start_inline=1 'backend' => [ 'frontName' => 'backend' ],
-
-
Utilisez l’une des méthodes suivantes pour effacer le cache :
-
Dans la barre latérale Admin, accédez à System > Tools>Cache Management. Cliquez ensuite sur Flush Magento Cache.
-
Sur le serveur , exécutez la commande suivante :
code language-bash php bin/magento cache:flush
note note NOTE Les modifications effectuées à l’aide de la méthode 1 ont la priorité sur les modifications effectuées dans le fichier app/etc/env.php
. -
Méthode 3 : modifier le chemin d’accès administrateur à l’aide de l’interface de ligne de commande Commerce
Vous pouvez utiliser la commande CLI setup:config:set
pour modifier le chemin d’accès d’administration. L’exemple suivant utilise l’option --backend-frontname
pour remplacer le chemin d’accès racine Commerce par un nouveau chemin d’accès administrateur :
bin/magento setup:config:set --backend-frontname="backend_front_name"
Cette commande met à jour l'option de configuration backend
> frontName
dans le fichier app/etc/env.php
.
Restaurer l’URL d’administration et le chemin d’accès d’administration par défaut
Si vous avez défini une URL d’administration non valide ou un chemin d’accès d’administration et perdu l’accès au serveur principal, il existe un moyen de corriger ce problème à partir de la ligne de commande.
-
Pour rétablir l’URL d’administration par défaut, exécutez la commande suivante :
code language-bash php bin/magento config:set admin/url/use_custom 0
-
Pour revenir au chemin d’administration par défaut (défini dans le
app/etc/env.php
comme décrit dans la méthode 2), exécutez la commande suivante :code language-bash php bin/magento config:set admin/url/use_custom_path 0
-
Utilisez l’une des méthodes suivantes pour effacer le cache :
-
Dans la barre latérale Admin, accédez à System > Tools>Cache Management. Cliquez ensuite sur Flush Magento Cache.
-
Sur le serveur , exécutez la commande suivante :
code language-bash php bin/magento cache:flush
-