Aller au contenu
Localtonet Localtonet Tableau de bord

En-têtes, réécriture du chemin et options HTTP

Aide pour cette page
Sur cette page 11 sections
  1. Avant de commencer
  2. En-têtes HTTP
  3. Ajouter un en-tête
  4. Choisir le type d'en-tête
  5. Ajouter l'en-tête
  6. Enregistrer
  7. Ensembles prêts à l'emploi
  8. En-têtes suggérés
  9. Règles
  10. En-tête Host
  11. Réécriture du chemin
  12. Passer Réécrire le chemin ? sur Oui
  13. Saisir le chemin à ajouter
  14. Enregistrer
  15. Délai d'expiration HTTP
  16. HTTPS uniquement ?
  17. HTTP/3 actif ?
  18. Exemples
  19. Laisser une application web d'un autre site appeler votre API
  20. Publier une application hébergée sous un sous-chemin
  21. Les mêmes paramètres via l'API
  22. Dépannage
  23. Pages associées

Modifiez la façon dont les requêtes et les réponses HTTP traversent un tunnel : ajoutez des en-têtes fixes, définissez l'en-tête Host que reçoit votre service, placez un chemin devant chaque requête, réglez le délai d'expiration des requêtes, et choisissez HTTPS uniquement ou HTTP/3 pour l'adresse publique.

Avant de commencer #

  • Un tunnel HTTP. Voir HTTP / HTTPS.
  • Les paramètres se trouvent dans le panneau de paramètres du tunnel : ouvrez Mes tunnels › HTTP et sélectionnez Paramètres dans la ligne du tunnel.
ParamètreHTTPPasserelle MCP
En-têtesOui–
Réécrire le chemin ?Oui–
Délai d'expiration HTTPOuiOui
HTTPS uniquement ?OuiOui
HTTP/3 actif ?OuiOui

Aucun de ces paramètres ne redémarre le tunnel. Une modification est appliquée au tunnel en cours d'exécution dès que vous l'enregistrez.

En-têtes HTTP #

En-têtes › Gérer ouvre la boîte de dialogue En-têtes HTTP. Elle ajoute des en-têtes fixes au trafic qui traverse le tunnel :

  • Les En-têtes de requête parviennent à votre service local avec chaque requête.
  • Les En-têtes de réponse parviennent au visiteur avec chaque réponse.

Les valeurs sont envoyées exactement comme vous les saisissez.

Ajouter un en-tête #

  1. Choisir le type d'en-tête #

    Sélectionnez En-têtes de requête ou En-têtes de réponse en haut de la boîte de dialogue. Chaque onglet indique combien d'en-têtes il contient.

  2. Ajouter l'en-tête #

    Sélectionnez Ajouter un en-tête et renseignez Nom et Valeur, ou sélectionnez un nom sous Suggestions pour obtenir une ligne avec une valeur de départ pertinente. Pour un en-tête que la boîte de dialogue connaît, l'icône d'information de la ligne explique son rôle.

  3. Enregistrer #

    Sélectionnez Enregistrer. Pour supprimer un en-tête, sélectionnez le bouton de suppression de sa ligne, puis Enregistrer.

Ensembles prêts à l'emploi #

Sous l'onglet En-têtes de réponse, les Ensembles prêts à l'emploi ajoutent un groupe d'en-têtes en une seule étape. La boîte de dialogue affiche alors « NAME ajouté. Vérifiez les valeurs, puis enregistrez. » Un ensemble ne renseigne un en-tête déjà présent dans la liste que si sa valeur est vide.

EnsembleEn-têtes ajoutésÀ utiliser pour
Autoriser CORS
  • Access-Control-Allow-Origin: *
  • Access-Control-Allow-Methods: GET, POST, PUT, PATCH, DELETE, OPTIONS
  • Access-Control-Allow-Headers: Content-Type, Authorization
Permet à des applications web d'autres sites d'appeler ce tunnel.
En-têtes de sécurité
  • Strict-Transport-Security: max-age=31536000; includeSubDomains
  • X-Content-Type-Options: nosniff
  • X-Frame-Options: SAMEORIGIN
  • Referrer-Policy: strict-origin-when-cross-origin
HSTS, nosniff, protection contre l'affichage en frame et politique de référent.
Désactiver le cacheCache-Control: no-storeEmpêche les navigateurs et les proxys de mettre les réponses en cache.
Masquer aux moteurs de rechercheX-Robots-Tag: noindex, nofollowDemande aux moteurs de recherche de ne pas répertorier cette adresse.

En-têtes suggérés #

En-têteTypeCe qu'en dit la boîte de dialogue
HostRequêteVotre service reçoit ce nom d'hôte à la place de l'adresse du tunnel. Utile lorsqu'un serveur web local choisit le site d'après le nom d'hôte.
AuthorizationRequêteEnvoie les mêmes identifiants à votre service avec chaque requête.
X-API-KeyRequêteUne clé fixe pour les services qui en attendent une dans un en-tête.
X-Forwarded-ProtoRequêteIndique à votre application que les visiteurs utilisent HTTPS, afin qu'elle construise des liens et des redirections en https://.
OriginRequêteCertains services n'acceptent que les requêtes provenant d'une origine connue.
Access-Control-Allow-OriginRéponseQuels sites web peuvent appeler ce tunnel depuis un navigateur. * autorise n'importe quel site.
Access-Control-Allow-CredentialsRéponsePermet aux navigateurs d'envoyer des cookies. Ne fonctionne pas avec Access-Control-Allow-Origin: *.
Strict-Transport-SecurityRéponseIndique aux navigateurs d'utiliser toujours HTTPS pour cette adresse.
X-Frame-OptionsRéponseEmpêche d'autres sites d'afficher vos pages dans un cadre.
Content-Security-PolicyRéponseContrôle d'où les pages peuvent charger des scripts, des styles et des images. Une politique stricte peut casser des pages : testez-la.
Cache-ControlRéponseno-store empêche les navigateurs et les proxys de mettre les réponses en cache.
X-Robots-TagRéponseDemande aux moteurs de recherche de ne pas répertorier cette adresse.

Les suggestions comprennent aussi User-Agent, Accept-Language et Cache-Control pour les requêtes, et Access-Control-Allow-Methods, Access-Control-Allow-Headers, X-Content-Type-Options, Referrer-Policy et Permissions-Policy pour les réponses. Vous pouvez aussi saisir n'importe quel autre nom d'en-tête.

Règles #

  • Les noms d'en-tête peuvent contenir des lettres, des chiffres et des tirets, par exemple X-Api-Key, et comporter jusqu'à 256 caractères.
  • Un nom ne peut apparaître qu'une fois par onglet. Une seconde ligne portant le même nom est refusée avec « NAME figure déjà dans cette liste. »
  • Une ligne a besoin d'un nom. Une ligne vide est ignorée lors de l'enregistrement.

En-tête Host #

Par défaut, votre service reçoit l'adresse du tunnel comme nom d'hôte d'une requête. Pour envoyer un autre nom d'hôte, ajoutez l'en-tête de requête Host dans la boîte de dialogue En-têtes HTTP et donnez-lui pour valeur le nom attendu par votre service, par exemple localhost ou shop.internal.

Utilisez-le lorsqu'un serveur web local choisit le site d'après le nom d'hôte, comme un hôte virtuel Apache ou nginx, IIS avec des liaisons d'hôte, ou un serveur de développement qui ne répond que pour localhost. Voir Hôtes virtuels pour un exemple complet.

Réécriture du chemin #

Une réécriture de chemin ajoute un chemin devant chaque requête avant qu'elle n'atteigne votre service local. Les visiteurs continuent d'utiliser l'adresse courte.

  1. Passer Réécrire le chemin ? sur Oui #

    La boîte de dialogue Réécriture du chemin s'ouvre.

  2. Saisir le chemin à ajouter #

    Saisissez-le dans Chemin à ajouter, par exemple /api ou /app/v2, ou sélectionnez l'un des Chemins courants. Le chemin commence par une barre oblique ; si vous l'omettez, elle est ajoutée pour vous. La zone Exemple montre le résultat pour une requête type.

  3. Enregistrer #

    Sélectionnez Enregistrer.

Avec /api comme chemin :

Le visiteur ouvreVotre service reçoit
https://<YOUR_TUNNEL_ADDRESS>/orders?id=7/api/orders?id=7

Un tunnel a un seul chemin, de 200 caractères au maximum. Il ne peut pas contenir d'espaces et ne peut pas être uniquement /. Pour le supprimer, passez Réécrire le chemin ? sur Non et confirmez Désactiver la réécriture du chemin ? : le chemin enregistré est supprimé et les requêtes atteignent votre service avec leur chemin d'origine.

Délai d'expiration HTTP #

Délai d'expiration HTTP › Gérer ouvre la boîte de dialogue Délai d'expiration des requêtes. Le délai d'expiration est le temps pendant lequel le tunnel attend que votre service réponde à une requête. Passé ce délai, le visiteur reçoit une erreur de délai dépassé.

ÉlémentValeurs
DélaiUn nombre entier de 1 à 600 secondes. Laissez vide pour la valeur par défaut du serveur.
PréréglagesValeur par défaut du serveur, 30 s, 1 min, 2 min, 5 min, 10 min

Augmentez le délai pour des rapports lents, de gros téléversements ou du long polling. Choisissez Valeur par défaut du serveur pour revenir à la valeur standard.

HTTPS uniquement ? #

Passez HTTPS uniquement ? sur Oui et confirmez Activer HTTPS uniquement ? pour servir l'URL publique exclusivement en HTTPS. Utilisez-le pour tout ce qui transporte des identifiants ou des données personnelles, afin que personne n'accède au tunnel en HTTP simple.

HTTP/3 actif ? #

Passez HTTP/3 actif ? sur Oui pour permettre aux clients d'accéder à l'URL publique en HTTP/3. Les clients qui ne prennent pas en charge HTTP/3 continuent d'utiliser les versions HTTP antérieures.

Exemples #

Laisser une application web d'un autre site appeler votre API #

Votre front end s'exécute sur https://app.example.com et appelle une API derrière un tunnel. Ouvrez En-têtes › Gérer, allez dans En-têtes de réponse et sélectionnez Autoriser CORS. Remplacez le * de Access-Control-Allow-Origin par https://app.example.com si seul ce site peut appeler l'API, puis sélectionnez Enregistrer.

Publier une application hébergée sous un sous-chemin #

Votre serveur d'applications sert l'application sous /app/v2, et vous voulez que les visiteurs ouvrent l'adresse simple du tunnel. Activez Réécrire le chemin ? et saisissez /app/v2. Un visiteur qui ouvre /login atteint /app/v2/login sur votre service.

Les mêmes paramètres via l'API #

Ces paramètres sont aussi disponibles sous /api/v2/tunnels/<TUNNEL_ID>/ : headers, host-header, path-rewrite, http-timeout, https-only et http3. Voir API.

Dépannage #

« Les noms d'en-tête peuvent contenir des lettres, des chiffres et des tirets, par exemple X-Api-Key. »

Le nom contient un caractère interdit dans un nom d'en-tête, comme une espace ou deux-points. Saisissez uniquement le nom dans Nom et le reste dans Valeur.

« Ajoutez un nom pour cet en-tête, ou retirez la ligne. »

Une ligne a une valeur mais pas de nom. Renseignez le nom ou supprimez la ligne.

« Saisissez uniquement le chemin, sans http:// ni nom d'hôte. »

Chemin à ajouter attend un chemin tel que /api, pas une URL complète.

« Saisissez un nombre entier de 1 à 600, ou choisissez Valeur par défaut du serveur. »

Le délai doit être compris entre 1 et 600 secondes. Pour une tâche plus longue, répondez d'abord à la requête et laissez le client demander le résultat plus tard.

Mon en-tête CORS ne fonctionne pas avec les cookies

Access-Control-Allow-Credentials ne fonctionne pas avec Access-Control-Allow-Origin: *. Définissez Access-Control-Allow-Origin sur l'origine exacte du site appelant.

Mon service local utilise HTTPS et le tunnel affiche une erreur

Ce n'est pas un problème d'en-tête. Activez SslStream ?, qui indique au tunnel que votre service local utilise lui-même HTTPS. Voir Référence des paramètres.

Support