Déclarer les accès réseau d’une application Shopify
Préparez la déclaration des accès réseau Shopify : applications concernées, origines à inventorier et recette isolée avant de publier une nouvelle version.

Pour déclarer les accès réseau d’une application Shopify, identifiez d’abord si elle entre dans le périmètre obligatoire, puis rapprochez les serveurs réellement contactés de sa configuration. Testez la déclaration sur une boutique de développement isolée avant de publier. Une page qui fonctionne sans avertissement ne suffit pas : un mauvais environnement de test peut cacher une origine oubliée.
Le 19 novembre 2026, Shopify a annoncé les échéances d’obligation de allowed_sources. L’enjeu pour un marchand et son prestataire est de pouvoir livrer la prochaine version avec un inventaire explicable. Ce guide propose une fiche par dépendance, un essai témoin et une décision de publication. Il distingue cette déclaration des droits de l’application et de la rotation de ses jetons.
Qui doit agir avant décembre et janvier ?
L’annonce officielle du 19 novembre vise les applications publiques et les applications personnalisées installées hors de l’organisation du développeur lorsqu’elles utilisent au moins une fonction concernée : bloc ou intégration d’extension de thème, script sur la boutique, app proxy, scope write_themes, ou pixel avec write_open_pixels.
Pour les applications publiques concernées, Shopify refusera les déploiements et soumissions App Store sans déclaration à partir du 1er décembre 2026 ; un avertissement apparaîtra dans l’administration marchande. À partir du 1er janvier 2027, elles seront retirées de l’App Store et les nouvelles installations bloquées. Les installations existantes continueront de fonctionner selon l’annonce.
Pour les applications personnalisées concernées, les déploiements seront refusés en décembre. En janvier, les installations hors de l’organisation seront bloquées tant que toutes les applications entrant dans le périmètre n’auront pas déclaré leurs accès. Faites donc qualifier le portefeuille, pas seulement la version que vous préparez aujourd’hui.
Les applications qui écrivent seulement du contenu, celles limitées à une extension d’interface de paiement et les pixels dans le bac à sable strict par défaut ne relèvent pas de ce seul périmètre. L’annonce précise aussi les exclusions de distribution. Conservez une justification écrite de votre qualification et revérifiez-la après tout ajout de fonctionnalité.
Déclaration, permission et sécurité : trois décisions différentes
La déclaration décrit des destinations attendues. Elle ne donne pas à l’application le droit de lire une commande et ne démontre pas qu’un serveur est correctement protégé. Pour comprendre l’identité de l’application et ses autorisations, le guide sur les jetons d’accès Shopify reste la lecture appropriée.
La fonctionnalité avait été introduite le 27 octobre 2026. Cette première annonce présentait deux listes : les sites vers lesquels un client navigue et les origines que le code charge ou contacte. Elle expliquait leur rôle dans la reconnaissance des destinations attendues et la détection d’activités suspectes. L’annonce de novembre ajoute l’obligation et son calendrier ; elle ne doit pas être lue comme la date d’apparition du mécanisme.
La bonne question métier est : « Quelles dépendances doivent rester disponibles pour terminer ce parcours ? » Une liste copiée d’un ancien projet ne répond pas à cette question. Une dépendance inutilisée ajoute du bruit ; une dépendance oubliée rend le dossier incomplet. L’équipe doit pouvoir justifier chaque entrée par une fonction encore présente.
Cette logique prolonge la gouvernance des données et des intégrations du guide SEO e-commerce. Ici, la décision porte sur le code exécuté et ses destinations, plutôt que sur la visibilité des pages ou la qualité des flux produit.
Construire une fiche par origine
Commencez par un parcours observable : afficher les avis d’un produit, ouvrir un suivi de commande, choisir une option personnalisée. Relevez les composants impliqués et demandez au développeur les destinations qu’ils utilisent. Comparez cet inventaire au trafic observé dans un environnement de test avec des données synthétiques.
La fiche suivante est une proposition de méthode, à adapter à votre application. Elle ne constitue pas un formulaire imposé par Shopify.
| Élément | Question à résoudre | Preuve attendue |
|---|---|---|
| Fonction | Quel service rendu exige cet appel ? | Étape du parcours et résultat |
| Origine | Quel serveur est effectivement contacté ? | Requête observée et environnement |
| Chargement | Script, image, police ou échange de données ? | Ressource et composant initiateur |
| Navigation | Le client quitte-t-il la boutique ? | Destination du lien et propriétaire |
| Déclaration | Quelle liste décrit cette dépendance ? | Entrée de configuration relue |
| Maintien | Qui vérifie le prochain changement ? | Responsable et date de revue |
Une origine sans fonction identifiable mérite une enquête avant son ajout. Inversement, un appel rare peut être indispensable : état vide, langue secondaire, erreur d’un fournisseur ou ouverture d’une aide. Ne limitez pas l’observation au premier affichage de la page d’accueil.
Documentez aussi ce qui n’est pas une dépendance externe à déclarer. Le guide Shopify de déclaration exclut notamment les fichiers servis par Shopify dans les assets d’une extension de thème et l’URL de l’app proxy servie sur le domaine de la boutique. Les ressources externes utilisées par son contenu demandent leur propre analyse.
Traduire l’inventaire dans la configuration
La référence actuelle de configuration distingue allowed_sources, qui reçoit des origines HTTPS, et allowed_navigation_hosts, facultatif, qui reçoit les hôtes de navigation. Une origine contient le protocole ; un hôte de navigation n’est pas une URL complète. Faites relire la syntaxe plutôt que de transformer automatiquement une liste de liens.
Exemple fictif minimal pour un module qui charge un composant et demande des données :
[network_access]
allowed_sources = ["https://cdn.example.com", "https://api.example.com"]
allowed_navigation_hosts = ["help.example.com"]
Ces domaines sont des exemples, pas des destinations à reprendre dans votre application. La liste de navigation doit se limiter aux hôtes contrôlés par l’éditeur. Chaque sous-domaine doit être examiné séparément. La référence actuelle autorise jusqu’à trente entrées par liste ; l’annonce initiale d’octobre en mentionnait vingt. Utilisez la référence en vigueur lors de la livraison et consignez sa date.
Une application concernée qui ne contacte aucun serveur externe déclare une liste vide allowed_sources = []. Ce résultat doit découler de l’inventaire. Il ne sert pas à faire passer une validation en attendant de chercher les dépendances.
Une recette isolée, avec un essai qui doit avertir
Le piège principal est un test qui réussit pour une mauvaise raison. Shopify combine les déclarations des applications installées dans une politique commune. Une seconde application peut donc couvrir une origine absente de votre propre liste. Le guide officiel demande une boutique de développement sans autres applications pour cette recette.
Le protocole suivant ajoute à cette isolation un témoin volontaire. C’est une recommandation de méthode : elle sert à vérifier que l’observation peut réellement détecter un oubli.
- Fixer le périmètre. Notez l’identifiant de l’application, la version, la configuration choisie et les fonctions à parcourir. Gardez un responsable capable de rapprocher le résultat de la prochaine publication. Un nom de boutique seul ne permet pas de reproduire l’essai.
- Préparer l’environnement documenté. Utilisez une boutique de développement avec la preview Network access testing, puis maintenez
shopify app devactif. Activez les blocs et intégrations nécessaires. Conservez la preuve que l’environnement correspond à celui prévu par Shopify. - Vérifier le dispositif d’observation. Ouvrez la boutique à son adresse
myshopify.com, avec la console du navigateur. Le guide demande de retrouver l’en-têteContent-Security-Policy-Report-Onlydans la réponse. L’aperçu de thème n’applique pas cette politique : une console silencieuse dans cet aperçu ne valide rien. - Introduire un oubli connu. Sur cette seule configuration de développement, retirez temporairement une origine de test que vous contrôlez et déclenchez l’appel correspondant. Recherchez l’avertissement attendu. Si vous ne l’observez pas, suspendez la conclusion et corrigez le dispositif avant de poursuivre. Rétablissez ensuite l’entrée et refaites l’essai.
- Parcourir les variantes utiles. Essayez les étapes normales, les erreurs, les états sans résultat et les langues qui modifient les dépendances. Pour chaque origine, rapprochez l’entrée de la fiche, l’appel et le résultat visible. N’exportez pas de données client pour documenter un test de réseau.
- Qualifier chaque écart. Une origine absente, une URL mal formée, une configuration non appliquée et un fournisseur indisponible n’appellent pas la même correction. Conservez l’écart, sa cause démontrée et le résultat après reprise. Un tableau rempli de « OK » sans observation n’est pas une preuve.
Le mode Report-Only fournit des signalements : ne racontez pas le témoin comme la preuve d’un blocage réseau en production. Le guide avertit également que la preview évolue. Enfin, l’absence de message ne couvre pas tout : Shopify cite les polices Google parmi les dépendances à déclarer même sans avertissement de console. L’inventaire reste nécessaire à côté des essais.
Exemple fictif : le widget qui passe grâce à une autre application
Imaginons une application d’avis qui charge son affichage depuis un CDN et ses avis depuis une API. La déclaration contient le CDN, mais oublie l’API. Sur une boutique de test partagée, une autre application utilise et déclare cette même API. L’équipe termine le parcours sans avertissement, puis conclut trop vite que son inventaire est complet.
La recette isolée change le diagnostic. Le test témoin confirme d’abord que le dispositif signale un oubli. L’équipe rejoue ensuite l’affichage des avis avec sa seule application, constate l’origine manquante, puis corrige la liste. Elle vérifie aussi le bouton d’aide et le cas d’une fiche sans avis. Chaque résultat rejoint la fiche de dépendance.
Cet exemple est fictif et n’annonce aucun incident subi par un client. Il montre pourquoi la qualité de l’environnement compte autant que la réussite visible. Ajouter arbitrairement tous les domaines rencontrés serait une mauvaise correction : l’équipe doit conserver uniquement les dépendances justifiées par son code et son périmètre.
Publier une version identifiable, puis maintenir la preuve
La commande Shopify app deploy construit et déploie la configuration et les extensions dans une version d’application. Elle ne publie pas le serveur web de l’éditeur chez son hébergeur. Préparez donc séparément ces responsabilités et vérifiez que les destinations déclarées correspondent à la version réellement servie.
Avant diffusion, exigez quatre éléments : qualification du périmètre, inventaire rapproché, essai isolé reproductible et version de configuration identifiable. Si le témoin ne fonctionne pas ou si une origine reste inexpliquée, corrigez avant de conclure. Si l’application n’est pas concernée, conservez la justification et un déclencheur de réexamen.
Le modèle de cahier des charges permet d’inscrire ces preuves dans une livraison. La supervision des applications Shopify prend ensuite le relais pour les alertes, incidents et reprises. Une déclaration ne remplace ni cette exploitation ni l’examen des droits et des données.
Revérifiez les échéances de décembre et janvier, ainsi que la documentation sous trente jours. Pour préparer un projet e-commerce, commencez par le parcours dont une dépendance oubliée retarderait réellement la livraison. Un inventaire court, justifié et testé donne une base plus utile qu’une promesse générale de sécurité.

