En-têtes, réécriture du chemin et options HTTP
Sur cette page 11 sections
- Avant de commencer
- En-têtes HTTP
- Ajouter un en-tête
- Choisir le type d'en-tête
- Ajouter l'en-tête
- Enregistrer
- Ensembles prêts à l'emploi
- En-têtes suggérés
- Règles
- En-tête Host
- Réécriture du chemin
- Passer Réécrire le chemin ? sur Oui
- Saisir le chemin à ajouter
- Enregistrer
- Délai d'expiration HTTP
- HTTPS uniquement ?
- HTTP/3 actif ?
- Exemples
- Laisser une application web d'un autre site appeler votre API
- Publier une application hébergée sous un sous-chemin
- Les mêmes paramètres via l'API
- Dépannage
- 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ètre | HTTP | Passerelle MCP |
|---|---|---|
| En-têtes | Oui | – |
| Réécrire le chemin ? | Oui | – |
| Délai d'expiration HTTP | Oui | Oui |
| HTTPS uniquement ? | Oui | Oui |
| HTTP/3 actif ? | Oui | Oui |
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 #
-
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.
-
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.
-
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.
| Ensemble | En-têtes ajoutés | À utiliser pour |
|---|---|---|
| Autoriser CORS |
| Permet à des applications web d'autres sites d'appeler ce tunnel. |
| En-têtes de sécurité |
| HSTS, nosniff, protection contre l'affichage en frame et politique de référent. |
| Désactiver le cache | Cache-Control: no-store | Empêche les navigateurs et les proxys de mettre les réponses en cache. |
| Masquer aux moteurs de recherche | X-Robots-Tag: noindex, nofollow | Demande aux moteurs de recherche de ne pas répertorier cette adresse. |
En-têtes suggérés #
| En-tête | Type | Ce qu'en dit la boîte de dialogue |
|---|---|---|
Host | Requête | Votre 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. |
Authorization | Requête | Envoie les mêmes identifiants à votre service avec chaque requête. |
X-API-Key | Requête | Une clé fixe pour les services qui en attendent une dans un en-tête. |
X-Forwarded-Proto | Requête | Indique à votre application que les visiteurs utilisent HTTPS, afin qu'elle construise des liens et des redirections en https://. |
Origin | Requête | Certains services n'acceptent que les requêtes provenant d'une origine connue. |
Access-Control-Allow-Origin | Réponse | Quels sites web peuvent appeler ce tunnel depuis un navigateur. * autorise n'importe quel site. |
Access-Control-Allow-Credentials | Réponse | Permet aux navigateurs d'envoyer des cookies. Ne fonctionne pas avec Access-Control-Allow-Origin: *. |
Strict-Transport-Security | Réponse | Indique aux navigateurs d'utiliser toujours HTTPS pour cette adresse. |
X-Frame-Options | Réponse | Empêche d'autres sites d'afficher vos pages dans un cadre. |
Content-Security-Policy | Réponse | Contrôle d'où les pages peuvent charger des scripts, des styles et des images. Une politique stricte peut casser des pages : testez-la. |
Cache-Control | Réponse | no-store empêche les navigateurs et les proxys de mettre les réponses en cache. |
X-Robots-Tag | Réponse | Demande 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.
-
Passer Réécrire le chemin ? sur Oui #
La boîte de dialogue Réécriture du chemin s'ouvre.
-
Saisir le chemin à ajouter #
Saisissez-le dans Chemin à ajouter, par exemple
/apiou/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. -
Enregistrer #
Sélectionnez Enregistrer.
Avec /api comme chemin :
| Le visiteur ouvre | Votre 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ément | Valeurs |
|---|---|
| Délai | Un nombre entier de 1 à 600 secondes. Laissez vide pour la valeur par défaut du serveur. |
| Préréglages | Valeur 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.