Aller au contenu
Localtonet Localtonet Tableau de bord

Créer un tunnel HTTP

Aide pour cette page
Sur cette page 10 sections
  1. Avant de commencer
  2. Étapes
  3. Ouvrir la page HTTP
  4. Choisir le type d'URL
  5. Choisir l'appareil et la région
  6. Saisir l'adresse locale
  7. Démarrer le tunnel
  8. Votre adresse publique
  9. HTTPS et certificats
  10. L'en-tête Host
  11. Paramètres d'un tunnel HTTP
  12. Exemples
  13. Partager une application web
  14. Recevoir des webhooks
  15. La page d'avertissement de l'offre gratuite
  16. Dépannage
  17. 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 #

  1. Ouvrir la page HTTP #

    Ouvrez Mes tunnels › HTTP et sélectionnez Créer un tunnel HTTP pour ouvrir le formulaire.

  2. Choisir le type d'URL #

    Type d'URLAdresse obtenuePrérequis
    Sous-domaine aléatoireUn 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
  3. 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.

  4. Saisir l'adresse locale #

    ChampCe qu'il faut saisir
    Domainelocalto.net, ou l'un de vos propres domaines. Pour Domaine personnalisé, la liste ne contient que vos propres domaines.
    Sous-domaineUniquement pour Sous-domaine personnalisé : le nom placé devant le domaine.
    Adresse IP localeAdresse du service sur votre appareil. Utilisez 127.0.0.1 pour cet appareil. Le formulaire accepte une adresse IPv4 ou IPv6, ou localhost.
    Port localLe 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.

  5. 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ètreFonctionQuand 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ètreFonctionEn savoir plus
Répartition de chargeRépartissez le trafic entre plusieurs appareils ou utilisez une cible de secours.Équilibrage de charge
Afficher la commande SSHDé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êtesGé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 HTTPDé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 IPContrôlez quelles adresses IP clientes peuvent accéder à ce tunnel.Contrôle d'accès
Fournisseurs SSOLes 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 ActionsOuvre 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 passanteArrê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 tunnelInspectez 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
ArgumentsEnvoyez ce tunnel par un réseau précis de votre appareil.Choix du réseau
Port sortantUtilisez des ports sortants fixes pour la connexion de l'application Localtonet au serveur, pour les pare-feu stricts.Ports
Note du tunnelEnregistrez 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.

ChampValeur
Type d'URLSous-domaine aléatoire
Domainelocalto.net
Adresse IP locale127.0.0.1
Port local3000

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 :

URL du webhook
https://<YOUR_SUBDOMAIN>.localto.net/<YOUR_WEBHOOK_PATH>

Testez-le depuis n'importe quel ordinateur :

Terminal
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-warning avec n'importe quelle valeur. Cela convient à vos propres scripts et clients d'API.
  • Ajoutez du solde à votre compte. Voir Offres et solde.
Terminal
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://.

Support