X-Forwarded-Proto
En-tête transmis par un proxy inverse pour indiquer le protocole externe initial, utile quand le serveur WordPress reçoit une requête HTTP après terminaison TLS. Son application dépend du contexte WordPress et de la configuration technique.
Rôle et fonctionnement
En-tête transmis par un proxy inverse pour indiquer le protocole externe initial, utile quand le serveur WordPress reçoit une requête HTTP après terminaison TLS. Le résultat dépend du serveur web, du proxy, de PHP et parfois d’un CDN; WordPress n’est pas toujours le composant responsable du comportement observé. Pour X-Forwarded-Proto, il faut distinguer le principe présenté, la responsabilité de WordPress et les éventuelles bibliothèques ou services externes : la fiche précise le mécanisme sans le présenter à tort comme une fonction native si ce n’en est pas une.
À quoi cela sert ?
Dans le contexte WordPress, le besoin pratique est le suivant : diagnostiquer des redirections HTTPS en boucle derrière un proxy. Cela permet de résoudre un besoin identifié plutôt que d’activer une fonctionnalité uniquement parce qu’elle existe. On commence par préciser la donnée ou l’interface concernée, l’endroit où le traitement intervient et les utilisateurs autorisés à le déclencher.
Quand l’utiliser dans un projet ?
Une application concrète est : diagnostiquer des redirections HTTPS en boucle derrière un proxy. Le bon choix dépend de la couche à laquelle agit X-Forwarded-Proto : interface, transport HTTP, infrastructure, stockage ou programmation serveur. Avant intégration, confirmer la compatibilité et les composants dont dépend l’exemple.
Exemple technique commenté
X-Forwarded-Proto: httpsL’extrait représente un échange ou un en-tête HTTP. Il faut le vérifier dans la réponse réelle : le coller dans un article WordPress n’en modifiera pas le comportement.
Décryptage du résultat attendu
L’exemple illustre X-Forwarded-Proto dans une situation volontairement limitée : diagnostiquer des redirections HTTPS en boucle derrière un proxy. Son résultat attendu est de rendre observable le mécanisme décrit, non de constituer à lui seul une extension prête à publier. Les retours d’erreur, l’accessibilité et les permissions doivent être traités autour du fragment lorsque le scénario l’exige.
Atelier de vérification
- Reproduire le contexte du cas : Diagnostiquer des redirections HTTPS en boucle derrière un proxy
- Appliquer uniquement l’exemple correspondant à la couche étudiée (http) dans un environnement isolé.
- Comparer les en-têtes publics, les journaux d’infrastructure et le fonctionnement depuis le navigateur.
- Documenter le résultat et confronter l’observation à la description de X-Forwarded-Proto.
Erreurs et limites à connaître
Ne faire confiance à cet en-tête que s’il provient d’un proxy maîtrisé; sinon il peut être falsifié par le client.
Diagnostic avancé
Comparer les en-têtes publics, les journaux d’infrastructure et le fonctionnement depuis le navigateur. Si le résultat diverge, vérifier d’abord les préconditions, les versions et les composants externes. Isoler ensuite la différence entre absence de donnée, comportement normal et erreur effective, avant d’envisager une modification du site public.
À ne pas confondre
Le terme X-Forwarded-Proto désigne ici un mécanisme précis. Il ne doit pas être confondu avec les outils qui l’observent, les options qui le configurent ni les protections qui peuvent le compléter. Les explications et les exemples restent valables dans leur contexte indiqué, pas automatiquement pour toutes les installations WordPress.
