Créer un tunnel HTTP
Sur cette page 10 sections
- Avant de commencer
- Étapes
- Ouvrir la page HTTP
- Choisir le type d'URL
- Choisir l'appareil et la région
- Saisir l'adresse locale
- Démarrer le tunnel
- Votre adresse publique
- HTTPS et certificats
- L'en-tête Host
- Paramètres d'un tunnel HTTP
- Exemples
- Partager une application web
- Recevoir des webhooks
- La page d'avertissement de l'offre gratuite
- Dépannage
- Pages associées
Un tunnel HTTP donne à une application web, une API ou un récepteur de webhooks de votre appareil une adresse HTTPS publique. Localtonet fournit le certificat, votre service local peut donc rester en HTTP simple.
Avant de commencer #
- Le client Localtonet est installé sur l'appareil et connecté avec un AuthToken. Si ce n'est pas le cas, suivez le Démarrage rapide.
- Votre service web est en cours d'exécution et vous connaissez son port, par exemple
3000. - Pour Sous-domaine personnalisé ou Domaine personnalisé : du solde sur votre compte. Pour Domaine personnalisé, il faut aussi un domaine ajouté dans le Gestionnaire DNS. Voir Domaines personnalisés.
Étapes #
-
Ouvrir la page HTTP #
Ouvrez Mes tunnels › HTTP et sélectionnez Créer un tunnel HTTP pour ouvrir le formulaire.
-
Choisir le type d'URL #
Type d'URL Adresse obtenue Prérequis Sous-domaine aléatoire Un nom généré sur le domaine sélectionné, par exemple https://<RANDOM_NAME>.localto.net.Rien de plus Sous-domaine personnalisé Le nom que vous saisissez dans Sous-domaine, par exemple https://myapp.localto.net. Les lettres, les chiffres et les tirets sont autorisés.Solde Domaine personnalisé Un domaine qui vous appartient, sélectionné dans Domaine. Du solde et un domaine dans le Gestionnaire DNS -
Choisir l'appareil et la région #
Dans Jeton d'appareil, sélectionnez le jeton utilisé par l'application Localtonet de votre appareil. Dans Région du serveur, choisissez une région proche de votre appareil pour réduire la latence.
-
Saisir l'adresse locale #
Champ Ce qu'il faut saisir Domaine localto.net, ou l'un de vos propres domaines. Pour Domaine personnalisé, la liste ne contient que vos propres domaines.Sous-domaine Uniquement pour Sous-domaine personnalisé : le nom placé devant le domaine. Adresse IP locale Adresse du service sur votre appareil. Utilisez 127.0.0.1pour cet appareil. Le formulaire accepte une adresse IPv4 ou IPv6, oulocalhost.Port local Le port sur lequel votre service local écoute, de 1 à 65535. Sélectionnez Créer le tunnel. Le tunnel apparaît sous Vos tunnels sous la forme
Tunnel #suivi de son ID. -
Démarrer le tunnel #
Sélectionnez le bouton de démarrage dans la colonne Actions. Lorsque le tunnel fonctionne, son adresse dans la colonne URL devient un lien. Ouvrez-le dans un navigateur. Les requêtes envoyées à cette adresse atteignent désormais le service de votre appareil.
Si l'application Localtonet de ce jeton est hors ligne, une boîte de dialogue vous en informe. Démarrez l'application, ou sélectionnez Démarrer quand même : le tunnel est mis en service dès que l'application se connecte.
Votre adresse publique #
- L'adresse est
https://suivi du nom d'hôte de la colonne URL. - Un tunnel HTTP conserve son sous-domaine jusqu'à sa suppression. L'arrêter puis le redémarrer ne le modifie pas.
- L'adresse ne comporte aucun numéro de port. Les visiteurs l'ouvrent comme n'importe quel autre site web.
- Les connexions WebSocket traversent un tunnel HTTP.
HTTPS et certificats #
Les visiteurs accèdent à un tunnel HTTP en HTTPS, avec un certificat que Localtonet fournit et renouvelle. Le chiffrement TLS se termine sur le serveur Localtonet. De là, la requête traverse le tunnel jusqu'à votre appareil, et l'application Localtonet la transmet à votre service.
| Paramètre | Fonction | Quand l'utiliser |
|---|---|---|
| HTTPS uniquement ? | Sert l'URL publique uniquement en HTTPS. Une requête vers http:// est redirigée vers la même adresse en https://. Tant qu'il est désactivé, l'adresse répond dans les deux cas. | Activez-le dès que le service transporte des identifiants de connexion ou des données privées. |
| HTTP/3 actif ? | Permet aux clients d'accéder à l'URL publique via HTTP/3. Un nouveau tunnel l'a activé. | Ne le désactivez que si un client rencontre des difficultés avec HTTP/3. |
| SslStream ? | Indique à l'application Localtonet de se connecter à votre service local en TLS. L'application accepte le certificat du service local tel quel, un certificat auto-signé fonctionne donc. | Activez-le lorsque votre service local utilise lui-même HTTPS, par exemple un serveur de développement sur https://localhost:5001. |
| Connexion héritée ? | Connecte le tunnel avec l'ancienne méthode au lieu de la méthode normale. | Essayez-le si le tunnel ne parvient pas à se connecter avec la méthode normale. |
Ces commutateurs se trouvent sous Paramètres, dans le panneau Paramètres du tunnel. Modifier SslStream ? ou Connexion héritée ? sur un tunnel en cours d'exécution le redémarre : l'application Localtonet doit donc être connectée.
Besoin d'un chiffrement jusqu'à votre propre service ? Avec un tunnel HTTP, Localtonet déchiffre le trafic sur son serveur. Utilisez un tunnel TLS lorsque votre service doit présenter son propre certificat.
L'en-tête Host #
Votre service reçoit le nom d'hôte utilisé par le visiteur, c'est-à-dire l'adresse du tunnel. Certains serveurs web locaux choisissent le site d'après le nom d'hôte et répondent avec le mauvais site ou une erreur. Dans ce cas, ouvrez En-têtes dans les paramètres du tunnel et ajoutez un en-tête de requête nommé Host avec le nom attendu par votre serveur. Votre service reçoit alors ce nom d'hôte au lieu de l'adresse du tunnel. Voir En-têtes et réécritures et Hôtes virtuels.
Paramètres d'un tunnel HTTP #
Sélectionnez le bouton des paramètres dans la colonne Actions pour ouvrir le panneau Paramètres du tunnel. Sous Détails du tunnel, vous pouvez renommer le tunnel et modifier l'adresse IP locale et le port local. Le tableau indique ce que propose encore un tunnel HTTP et où c'est expliqué.
| Paramètre | Fonction | En savoir plus |
|---|---|---|
| Répartition de charge | Répartissez le trafic entre plusieurs appareils ou utilisez une cible de secours. | Équilibrage de charge |
| Afficher la commande SSH | Démarrez ce tunnel avec SSH simple, sans installer l'application Localtonet. | SSH sans installation |
| HTTPS uniquement ?, HTTP/3 actif ?, SslStream ?, Connexion héritée ? | Comment les visiteurs et votre service se connectent. | Cette page, plus haut |
| Réécrire le chemin ? | Modifiez le chemin de la requête avant qu'elle n'atteigne votre service local. | En-têtes et réécritures |
| En-têtes | Gérez les en-têtes de requête et de réponse HTTP personnalisés de ce tunnel. | En-têtes et réécritures |
| Délai d'expiration HTTP | Définissez combien de temps le serveur attend une réponse de votre application locale, de 1 à 600 secondes. | En-têtes et réécritures |
| Authentification basique ? | Demandez aux visiteurs un nom d'utilisateur et un mot de passe. | Contrôle d'accès |
| Restriction IP | Contrôlez quelles adresses IP clientes peuvent accéder à ce tunnel. | Contrôle d'accès |
| Fournisseurs SSO | Les visiteurs se connectent avec l'un de vos fournisseurs d'identité avant de pouvoir ouvrir le tunnel. Le bouton SSO en haut de la page gère les fournisseurs. | Authentification unique (SSO) |
| Bouton WAF dans la colonne Actions | Ouvre Paramètre WAF. Le bouton indique si le pare-feu applicatif web n'est pas configuré, actif ou inactif. | Pare-feu applicatif web (WAF) |
| Date d'expiration, Limites de vitesse, Limite de bande passante, Utilisation de la bande passante, Trafic de bande passante | Arrêtez le tunnel à une date donnée, plafonnez sa vitesse, plafonnez ses données, réinitialisez le compteur de données et consultez le trafic dans le temps. | Limites et expiration |
| Journal des requêtes, Journal d'activité, Santé du tunnel | Inspectez les requêtes, examinez les démarrages, les arrêts et les modifications de paramètres, et consultez les contrôles de santé. | Journaux et inspection |
| Arguments | Envoyez ce tunnel par un réseau précis de votre appareil. | Choix du réseau |
| Port sortant | Utilisez des ports sortants fixes pour la connexion de l'application Localtonet au serveur, pour les pare-feu stricts. | Ports |
| Note du tunnel | Enregistrez une note privée pour vous aider à identifier ce tunnel. | Référence des paramètres |
Fournisseurs SSO n'est pas affiché pour un tunnel qui appartient à une équipe.
Exemples #
Partager une application web #
Votre application s'exécute sur le même ordinateur que le client Localtonet et écoute sur le port 3000.
| Champ | Valeur |
|---|---|
| Type d'URL | Sous-domaine aléatoire |
| Domaine | localto.net |
| Adresse IP locale | 127.0.0.1 |
| Port local | 3000 |
Créez le tunnel, démarrez-le et envoyez l'adresse de la colonne URL aux personnes qui doivent voir l'application. Pour leur demander d'abord un mot de passe, activez Authentification basique ?.
Si l'application s'exécute sur une autre machine de votre réseau, saisissez l'adresse de cette machine dans Adresse IP locale, par exemple 192.168.1.20. L'appareil qui exécute le client Localtonet doit pouvoir l'atteindre.
Recevoir des webhooks #
Un fournisseur de webhooks a besoin d'une adresse HTTPS publique pour envoyer ses événements. Créez un tunnel HTTP vers le port de votre récepteur, démarrez-le, puis saisissez chez le fournisseur l'adresse du tunnel suivie du chemin de votre point de terminaison :
https://<YOUR_SUBDOMAIN>.localto.net/<YOUR_WEBHOOK_PATH>Testez-le depuis n'importe quel ordinateur :
curl -X POST https://<YOUR_SUBDOMAIN>.localto.net/<YOUR_WEBHOOK_PATH> \
-H "Content-Type: application/json" \
-d '{"event":"test"}'Pour voir ce qui est arrivé, sélectionnez l'icône dans la colonne Webhooks du tunnel (Voir les journaux de requêtes et réponses). Le tunnel doit d'abord être démarré. Voir Journaux et inspection.
Avec l'offre gratuite, ajoutez du solde avant de vous reposer sur des webhooks. Les requêtes vers un tunnel HTTP d'un compte gratuit reçoivent d'abord une page d'avertissement, qu'un fournisseur de webhooks ne peut pas franchir. Voir la section suivante.
La page d'avertissement de l'offre gratuite #
Lorsqu'un compte n'a pas de solde, un visiteur qui accède pour la première fois à son tunnel HTTP voit une page Localtonet intitulée « You are about to navigate to: » avec les boutons Cancel et Visit Site. Cette page sert à décourager les abus. Visit Site enregistre un cookie dans le navigateur du visiteur et ouvre votre site. Tant que le navigateur conserve ce cookie, la page ne lui est plus proposée.
La page elle-même indique les deux moyens de la supprimer :
- Envoyez un en-tête de requête nommé
localtonet-skip-warningavec n'importe quelle valeur. Cela convient à vos propres scripts et clients d'API. - Ajoutez du solde à votre compte. Voir Offres et solde.
curl -H "localtonet-skip-warning: 1" https://<YOUR_SUBDOMAIN>.localto.net/Dépannage #
La boîte de dialogue indique que le jeton est hors ligne, ou j'obtiens « L'application Localtonet de l'AuthToken « … » n'est pas connectée. »
Le client Localtonet qui utilise le jeton de ce tunnel n'est pas en cours d'exécution ou ne parvient pas à joindre Localtonet. Démarrez le client sur l'appareil avec le même jeton. La boîte de dialogue démarre le tunnel d'elle-même dès que l'application se connecte. Avec Démarrer quand même, le tunnel est activé et se met en service plus tard.
« Démarrez ou mettez à jour l'application Localtonet. »
Le tunnel n'a pas pu être démarré sur l'appareil. Vérifiez que le client est en cours d'exécution et, s'il est ancien, installez la version actuelle depuis la page Téléchargements.
Le navigateur affiche « Tunnel Recently Started or Stopped »
La requête a atteint Localtonet, mais le tunnel n'accepte pas de connexions. Il vient d'être démarré ou il est arrêté. Vérifiez qu'il est démarré et que la colonne Connexion affiche ON, puis rechargez la page.
Le navigateur affiche une page d'erreur Localtonet qui mentionne mon adresse locale
La page indique que le trafic a été tunnelisé vers l'agent Localtonet, mais que l'agent n'a pas réussi à se connecter au service en amont à votre IP et port locaux. Le titre est l'erreur, par exemple ConnectionRefused. Rien n'écoute à cette adresse. Démarrez votre service, puis vérifiez l'adresse IP locale et le port local sous Détails du tunnel. Vous pouvez tester le service sur l'appareil lui-même en ouvrant l'adresse locale dans un navigateur.
« Vous devez acheter du solde pour utiliser cette fonctionnalité. »
Sous-domaine personnalisé et Domaine personnalisé nécessitent du solde. Utilisez Sous-domaine aléatoire, ou ajoutez du solde sous Solde.
« Il vous faut un solde total de … pour créer un autre tunnel de ce type. »
Votre solde ne couvre pas un autre tunnel. Avec l'offre gratuite, vous ne pouvez créer qu'un seul tunnel au total, quel que soit son type. Supprimez votre tunnel existant avant d'en créer un autre, ou ajoutez du solde.
« … existe déjà. » ou « … n'est pas autorisé. »
Un autre tunnel utilise ce sous-domaine, ou le nom est réservé par Localtonet. Choisissez un autre sous-domaine.
« ATTENTION ! Vous n'avez aucun domaine ! »
Vous avez choisi Domaine personnalisé mais n'avez pas encore ajouté de domaine. Ajoutez-le d'abord dans le Gestionnaire DNS. Si vous voyez « … est déjà utilisé par un autre tunnel. », ce domaine appartient déjà à l'un de vos tunnels. Un domaine personnalisé ne peut servir qu'un seul tunnel.
« Modifiez la limite de bande passante ou réinitialisez la consommation de bande passante. » ou « Mettez à jour la date d'expiration. »
Le tunnel a atteint sa propre limite de bande passante ou sa date d'expiration et ne peut pas démarrer. Modifiez la limite ou la date dans les paramètres du tunnel, ou réinitialisez le compteur avec Utilisation de la bande passante. Voir Limites et expiration.
« Vérifiez la connexion de l'appareil. »
Vous avez modifié un paramètre qui redémarre un tunnel en cours d'exécution alors que l'application Localtonet était hors ligne. Connectez l'application et enregistrez à nouveau le paramètre, ou arrêtez d'abord le tunnel.
Mon application répond avec le mauvais site, ou génère des liens et des redirections en http://
Votre application décide d'après le nom d'hôte ou le schéma qu'elle reçoit. Sous En-têtes, ajoutez un en-tête de requête Host si l'application attend un nom d'hôte fixe. Ajoutez un en-tête de requête X-Forwarded-Proto avec la valeur https pour indiquer à l'application que les visiteurs utilisent HTTPS : elle génère alors des liens et des redirections en https://.