DevOps / CI/CD

Next.js 16 Server Actions : requêtes inter-origines refusées ? Comment diagnostiquer le proxy inverse (2026)

Vérifiez d’abord l’Origin envoyé par le navigateur, le Host transmis à Next.js et les en-têtes reçus après chaque proxy ; n’ajoutez un domaine à serverActions.allowedOrigins que si un appel inter-origines légitime est confirmé. Cette méthode s’adresse aux applications Next.js 16 déployées derrière un proxy inverse ou une passerelle, et évite de masquer une erreur de transfert par une ouverture excessive des sources autorisées.

Les équipes frontend peuvent l’utiliser pour localiser le refus d’une Server Action. Les responsables plateforme peuvent comparer les en-têtes avant et après chaque intermédiaire. Les responsables sécurité peuvent déterminer si allowedOrigins est nécessaire, puis limiter cette autorisation aux domaines réellement utilisés.

Repérer le point de rupture dans la requête

Une erreur affichée dans le navigateur ne signifie pas automatiquement que le navigateur a bloqué une requête CORS, ni que React a perdu un état. Une action peut être refusée par le contrôle de source de Next.js, interceptée par le proxy ou atteindre le code applicatif et échouer ensuite. Le premier travail consiste donc à établir jusqu’où la requête est allée.

Dans les outils de développement du navigateur, ouvrez l’onglet réseau, soumettez le formulaire une seule fois et repérez la requête associée à l’action. Notez son URL, son statut HTTP et l’en-tête Origin lorsqu’il est présent. Évitez de copier des cookies, des jetons ou des corps contenant des données personnelles : un relevé de diagnostic devrait conserver uniquement les champs nécessaires, après suppression des valeurs sensibles.

Côté serveur, cherchez dans les journaux du proxy et de l’application une entrée qui corresponde à la même tentative. Il faut comparer les horodatages et le chemin de la requête, sans supposer que l’absence d’un message applicatif prouve à elle seule un rejet par Next.js : le niveau de journalisation ou le routage peut aussi empêcher l’observation. La documentation Next.js décrit les Server Actions comme des mutations appelées au moyen de requêtes réseau ; le chemin observé doit donc être comparé au flux documenté d’appel et de traitement des mutations.

Pourquoi Next.js 16 signale-t-il une source non autorisée ? Le contrôle de sécurité des Server Actions compare l’origine de la requête à l’hôte de la requête. Si ces valeurs ne correspondent pas selon la configuration et le chemin de déploiement, l’action peut être rejetée. La documentation officielle décrit aussi serverActions.allowedOrigins comme un moyen d’autoriser des origines supplémentaires ; elle ne présente pas ce paramètre comme un interrupteur général de CORS. Consultez la documentation de configuration des Server Actions et la présentation officielle de leur sécurité avant de modifier le comportement.

Les statuts et symptômes ne suffisent pas à identifier la cause. Un refus visible au navigateur peut correspondre à une réponse du proxy, à une réponse de Next.js ou à une erreur déclenchée par l’action. Pour trancher, il faut rapprocher le statut côté navigateur des journaux du proxy et de ceux de l’application. Une erreur métier survenue après l’exécution de l’action n’est pas une preuve de refus d’origine ; inversement, un message générique dans l’interface ne prouve pas que le code de l’action a été exécuté.

Vérifier la source côté navigateur

L’Origin décrit l’origine associée à la requête, et non simplement le nom affiché dans l’interface. Selon la référence HTTP de MDN, il comprend le schéma et l’hôte, auxquels s’ajoute le port lorsqu’il est pertinent. Ainsi, une page servie en HTTPS et une destination en HTTP ne sont pas équivalentes ; un nom de domaine différent ou un port distinct peut également modifier le résultat de la comparaison. La référence MDN sur l’en-tête Origin détaille sa forme et son rôle.

Comparez ces éléments avec la barre d’adresse et l’URL exacte de la requête d’action. Il arrive qu’une application soit ouverte par son domaine public, alors qu’un formulaire ou une configuration de déploiement construit l’URL avec un nom interne, une autre terminaison DNS ou un protocole différent. Les environnements local, de prévisualisation et de production doivent être inspectés séparément : leur nom d’hôte peut changer sans que le code du formulaire soit différent.

Conservez pour chaque environnement un relevé limité à des valeurs expurgées, par exemple :

  • URL publique de la page et URL cible de l’action, sans paramètres sensibles ;
  • valeur d’Origin reçue dans le navigateur ;
  • statut de la réponse et présence ou absence de la requête dans les journaux ;
  • hôte public attendu et, si disponible, valeur observée après le proxy.

Que faire si les valeurs Origin et Host diffèrent après le proxy ? Commencez par déterminer où la différence apparaît. Une divergence entre le domaine public et un nom interne peut provenir d’une réécriture d’en-tête, d’un équilibrage de charge ou d’une configuration d’URL publique. Ne corrigez pas immédiatement la divergence en ajoutant tous les domaines possibles à la liste d’autorisation : une valeur interne inattendue peut révéler un transfert incorrect ou un routage incohérent.

Un contrôle CORS et le contrôle de source d’une Server Action ne désignent pas le même mécanisme. CORS concerne les règles de partage des réponses avec des scripts exécutés dans un navigateur ; le contrôle d’origine des Server Actions relève de la validation de requêtes côté application. Ajouter une règle CORS à la passerelle ne garantit donc pas que Next.js acceptera la requête. De même, réinitialiser l’état client ou invalider un cache ne répare pas une paire Origin/Host incohérente.

Reconstituer le transfert du proxy

Les en-têtes à comparer sont ceux que le navigateur envoie et ceux que l’application reçoit réellement, pas uniquement ceux que l’équipe pense transmettre. Avec plusieurs intermédiaires, le proxy d’entrée peut conserver le nom public alors qu’un autre composant remplace Host par le nom d’un service interne. Un en-tête peut également être absent, remplacé ou construit différemment d’un environnement à l’autre.

La référence MDN présente X-Forwarded-Host comme un en-tête permettant d’indiquer l’hôte demandé par le client à travers un proxy. Il faut cependant vérifier sa valeur effective et le traitement effectué par la plateforme ; sa seule présence ne prouve ni qu’il est fiable, ni que Next.js l’utilise comme prévu dans le déploiement concerné. Consultez la documentation MDN de X-Forwarded-Host, puis les recommandations Next.js pour le déploiement auto-hébergé derrière un proxy.

Le contrôle le plus probant consiste à comparer une requête équivalente en accès direct à l’application et en passant par le chemin public, si l’architecture autorise ce test sans exposer l’application ni contourner ses protections. Si la requête directe fonctionne et que la requête publique échoue, l’écart oriente le diagnostic vers le proxy, le routage ou les en-têtes transférés. Si les deux échouent de la même manière, examinez aussi la configuration de l’application et les journaux de l’action.

Cette comparaison doit conserver la même page, la même session de test et le même chemin fonctionnel. Les modifications simultanées de l’image de déploiement, de la configuration de l’action et des règles du proxy rendent le résultat difficile à interpréter. Modifiez un élément à la fois, puis consignez le résultat observé. La définition d’une passerelle dans la spécification HTTP de référence rappelle qu’un intermédiaire peut recevoir et transmettre des messages HTTP : il faut donc examiner cette étape de transmission, plutôt que supposer que navigateur et application communiquent directement.

Comparer les causes avant de modifier la configuration

Option de diagnostic Indice à vérifier Décision
Refus avant l’application La requête apparaît dans le navigateur, mais pas dans les journaux applicatifs ; vérifier les journaux et règles de la passerelle. Corriger le routage ou le filtrage du proxy avant de toucher à Next.js.
Origine refusée par Next.js La requête atteint l’application et les valeurs Origin et hôte reçu ne concordent pas avec le déploiement attendu. Corriger le transfert des en-têtes ; n’ajouter une origine qu’après validation du besoin.
Erreur dans l’action La requête atteint le code applicatif et les journaux signalent une erreur de validation, d’autorisation ou de traitement. Déboguer l’action et ses dépendances, sans élargir les origines permises.
Accès public ou prévisualisation différent La même action se comporte différemment selon le domaine utilisé. Comparer les domaines, protocoles, en-têtes et règles propres à chaque environnement.

La comparaison évite de traiter comme équivalents un blocage périphérique et un refus de l’application. Elle aide aussi à empêcher une modification de sécurité inutile : si le proxy ne transmet jamais la requête, une liste allowedOrigins plus large ne corrigera pas le chemin. Si l’action s’exécute puis échoue dans une dépendance métier, une modification des en-têtes ne résoudra pas cette erreur.

Définir une autorisation allowedOrigins limitée

Faut-il renseigner le domaine du navigateur ou celui du proxy dans serverActions.allowedOrigins ? La réponse dépend de l’origine supplémentaire réellement présentée dans le chemin de déploiement, pas d’une préférence générale pour le nom public ou le nom du proxy. Commencez par établir quelles valeurs Next.js reçoit et pourquoi elles diffèrent. Ensuite, vérifiez dans la documentation correspondant à la version déployée la sémantique précise de l’option et les formes de domaine acceptées.

Si une origine supplémentaire est légitime et que les transferts sont correctement configurés, déclarez uniquement les hôtes nécessaires, dans le format pris en charge par la version utilisée. La configuration documentée se place sous experimental.serverActions ; un exemple minimal à adapter après vérification est :

/** @type {import('next').NextConfig} */
const nextConfig = {
  experimental: {
    serverActions: {
      allowedOrigins: ['actions.exemple.fr'],
    },
  },
}

module.exports = nextConfig

Cet exemple ne constitue pas une valeur universelle : actions.exemple.fr est un domaine fictif à remplacer par l’origine réellement requise. Il ne faut ni recopier ce nom dans une production, ni déduire de l’exemple qu’un domaine public, une adresse interne ou un motif générique convient à toute topologie. Contrôlez le nom attendu, les règles de prévisualisation et la configuration effective au démarrage ; confirmez également que le mécanisme de configuration cité correspond bien à la version installée.

Une autorisation très large augmente le nombre de sources auxquelles l’application fait confiance. Elle ne remplace ni l’authentification, ni l’autorisation de l’utilisateur pour l’opération demandée. Next.js distingue ces contrôles dans son guide de gestion de l’authentification et de l’autorisation : même une requête acceptée comme provenant d’une origine autorisée doit encore être vérifiée au niveau de l’action.

Les données d’une action ne doivent pas être considérées comme fiables du seul fait qu’elles sont transmises par l’interface. Vérifiez côté serveur la session, les droits et les valeurs reçues selon le risque de l’opération. Il s’agit d’une question différente de la correspondance entre Origin et Host, mais les deux contrôles participent à la sécurité du même point d’entrée.

Procéder aux essais par rôle

Parcours du développeur frontend

  • [ ] Reproduire le problème avec le parcours utilisateur concerné, sans multiplier les soumissions susceptibles de produire des effets métier.
  • [ ] Relever l’URL publique, l’URL de la requête, l’Origin visible et le statut de réponse.
  • [ ] Comparer la page et la requête dans les environnements local, de prévisualisation et de production, en notant les différences de protocole, d’hôte et de port.
  • [ ] Confirmer si l’action a atteint le serveur et si un message applicatif apparaît.
  • [ ] Éviter de conclure à un problème de cache, de CORS ou d’état client avant d’avoir localisé le point de rupture.

Cette séquence évite une fausse piste fréquente : une interface peut afficher un message d’échec après plusieurs types d’erreurs. Tant que le réseau et les journaux ne montrent pas si l’action a été exécutée, modifier l’état local ou réinitialiser un cache ne permet pas de savoir si la cause a été traitée.

Parcours de l’équipe plateforme

  • [ ] Examiner les règles du proxy d’entrée et les transferts de Host, Origin et, si utilisé, X-Forwarded-Host.
  • [ ] Relever les valeurs avant et après chaque intermédiaire ; dans une chaîne à plusieurs proxies, ne pas attribuer au premier composant un en-tête modifié plus loin.
  • [ ] Vérifier que le domaine présenté au navigateur correspond au nom public attendu, sans exposer l’adresse interne dans les URL générées.
  • [ ] Comparer l’accès par l’entrée publique et un accès direct autorisé, sans désactiver les contrôles de production.
  • [ ] Produire une preuve expurgée des en-têtes utiles et du résultat correspondant.

Le relevé doit distinguer les en-têtes réellement reçus des valeurs configurées. Une règle déclarée dans un fichier de proxy ne garantit pas que la passerelle active, le répartiteur ou le conteneur transmette la même valeur à l’application. Si un environnement de prévisualisation passe par une autre chaîne, il faut auditer cette chaîne séparément au lieu de supposer qu’elle hérite du comportement de production.

Parcours du responsable sécurité

  • [ ] Vérifier la documentation officielle de la version déployée avant d’ajouter une entrée à allowedOrigins.
  • [ ] Justifier chaque origine par un usage d’application et un chemin d’accès identifiés.
  • [ ] Refuser les autorisations génériques ou les domaines sans propriétaire opérationnel clair.
  • [ ] Confirmer que l’authentification et les contrôles d’autorisation restent appliqués dans l’action.
  • [ ] Examiner l’effet de la configuration sur les domaines de prévisualisation avant son déploiement.

Le mot « inter-origines » ne doit pas conduire à ouvrir indistinctement toutes les sources. Une prévisualisation accessible sous un domaine variable peut nécessiter un choix d’architecture ou de gestion des environnements ; elle ne justifie pas automatiquement une règle générale. Si les domaines changent fréquemment, formalisez leur cycle de vie et leur propriétaire plutôt que d’ajouter des exceptions temporaires sans échéance.

Parcours des tests et des mises en production

  • [ ] Valider qu’une soumission depuis le domaine prévu atteint l’action et produit le résultat attendu.
  • [ ] Valider qu’une source non prévue reste refusée selon le modèle de sécurité retenu.
  • [ ] Refaire les contrôles après bascule entre prévisualisation et production, car le domaine public ou la chaîne de proxy peut différer.
  • [ ] Comparer les en-têtes expurgés avant et après proxy ainsi que les journaux associés.
  • [ ] Consigner le changement de configuration, son motif et le résultat du test de non-régression.

Une réponse réussie isolée n’établit pas que la correction est sûre. Le test doit vérifier à la fois le fonctionnement du domaine attendu et le maintien du refus pour une origine hors périmètre. Dans un plan de publication, séparez les modifications du proxy et celles d’allowedOrigins autant que possible : si le comportement change, l’équipe saura ainsi quelle étape a produit l’effet.

Comment localiser une erreur qui n’apparaît qu’en production ? Commencez par comparer le domaine de production à celui de prévisualisation, puis contrôlez les en-têtes observés après le dernier proxy. Examinez aussi si la requête atteint l’application et si la configuration effective de Next.js est identique à celle testée. L’écart entre environnements doit être démontré par des valeurs expurgées, non supposé à partir du seul message affiché.

Choisir un environnement de vérification adapté

Pour reproduire une différence entre navigateur et proxy, il faut un environnement de test séparé, des domaines et règles de transfert contrôlables, ainsi que des journaux permettant de comparer les requêtes sans toucher aux données de production. Une instance de développement sur Mac peut servir à valider le code frontend, préparer un scénario de test ou examiner le comportement de l’interface ; elle ne remplace ni le proxy réellement utilisé ni un serveur de production représentatif. Elle ne permet pas, à elle seule, de confirmer les en-têtes qu’une infrastructure distante transmet effectivement.

Pour les équipes qui souhaitent un poste Mac temporaire consacré au développement ou aux essais, les offres de KuzCloud peuvent être comparées aux besoins du projet. Avant de retenir cette voie, vérifiez que le mode d’accès et l’environnement fournis conviennent au scénario ; les modalités disponibles sont à confirmer directement auprès de KuzCloud, et ne doivent pas être assimilées à une capacité de déploiement de Next.js ou à un service de proxy.

Un poste temporaire est surtout pertinent pour isoler des essais frontend ou reproduire une configuration de développement lorsque l’équipe n’a pas besoin d’un hôte local permanent. Il ne sera pas le meilleur choix si l’application exige un serveur durable, des contrôles réseau propres à la production ou un accès à des interfaces physiques particulières. Un achat peut mieux convenir à un poste utilisé en continu ; l’exécution locale reste adaptée lorsque l’équipe possède déjà un environnement maîtrisé. Pour clarifier les conditions d’accès avant de choisir, consultez aussi la page d’aide de KuzCloud.

La décision essentielle reste indépendante du matériel de test : localisez d’abord le refus dans la chaîne, comparez Origin et l’hôte réellement transmis, puis n’ajoutez que les origines nécessaires à serverActions.allowedOrigins. Un Mac loué peut aider à préparer et isoler un scénario de développement ; seule la validation dans la chaîne de proxy concernée établit que la correction respecte la frontière de confiance en production.

Validez votre déploiement Next.js sur un Mac dédié

Avec KuzCloud, louez un Mac mini M4 dédié pour reproduire vos conditions de déploiement et diagnostiquer vos échanges avec un proxy inverse.

Accédez directement à la machine par SSH ou VNC, avec les droits administrateur nécessaires pour installer vos outils et examiner votre configuration.