Créer un tunnel TLS
Desktop v7.6+ Mobile v9.9+
Sur cette page 10 sections
- TLS, HTTP ou TCP ?
- Avant de commencer
- Étapes
- Ouvrir la page TLS
- Choisir le type d'URL, l'appareil et la région
- Saisir le point d'accès
- Démarrer le tunnel
- Le point d'accès
- Mode SSL : qui gère le certificat
- Paramètres d'un tunnel TLS
- Exemples
- Un serveur web avec son propre certificat
- Un service non HTTP sur TLS
- TLS sur le port 443 pour un service sans certificat
- Avec l'offre gratuite
- Dépannage
- Pages associées
Un tunnel TLS transmet le trafic chiffré d'un nom d'hôte public, sur le port 443, vers un service TLS local. Par défaut, la connexion chiffrée traverse le tunnel directement jusqu'à votre service, qui présente son propre certificat.
TLS, HTTP ou TCP ? #
Les trois permettent de publier un service qui utilise le chiffrement. Ils diffèrent par le détenteur du certificat et par l'aspect de l'adresse publique.
| Question | Tunnel HTTP | Tunnel TLS | Tunnel TCP |
|---|---|---|---|
| Point d'accès public | Adresse https:// sans port | Nom d'hôte sur le port 443 | Nom d'hôte et port de serveur attribué |
| Qui présente le certificat | Localtonet | Votre service par défaut. Localtonet si vous le choisissez dans Mode SSL. | Localtonet n'ajoute aucun certificat. Votre service fait ce qu'il fait aujourd'hui. |
| Où TLS se termine | Sur le serveur Localtonet | Sur votre service, en mode passthrough | Là où votre protocole le termine |
| Protocoles | HTTP et WebSocket | Tout protocole fonctionnant sur TLS | Tout protocole TCP |
| Options HTTP comme les en-têtes, la réécriture de chemin, l'authentification basique, le SSO, le WAF et l'inspecteur de requêtes | Oui | Non | Non |
| Types d'URL | Sous-domaine aléatoire, sous-domaine personnalisé, domaine personnalisé | Sous-domaine aléatoire, sous-domaine personnalisé | Sous-domaine aléatoire, sous-domaine personnalisé |
| Limite de session de l'offre gratuite | Aucune | 30 minutes par session | 30 minutes par session |
- Choisissez HTTP pour un site web classique, une API ou un récepteur de webhooks. C'est le plus simple.
- Choisissez TLS lorsque votre service doit présenter son propre certificat, lorsque le trafic doit rester chiffré jusqu'à votre appareil, ou lorsqu'un protocole non HTTP sur TLS doit être accessible sur le port 443.
- Choisissez TCP lorsque le protocole n'est pas du TLS dès le premier octet, ou lorsque les clients ne peuvent pas envoyer de nom d'hôte. Un tunnel TCP est adressé par son port, un tunnel TLS par son nom d'hôte.
Avant de commencer #
- Un client Localtonet à jour, connecté avec un AuthToken. La page TLS indique les versions minimales : Desktop v7.6 et Mobile v9.9.
- Un service local qui parle TLS et dispose d'un certificat pour le nom d'hôte que les clients utiliseront. Si votre service n'a pas de certificat, voir HTTP, ou changez le mode SSL comme décrit plus bas.
- Pour Sous-domaine personnalisé : du solde sur votre compte.
Étapes #
-
Ouvrir la page TLS #
Ouvrez Mes tunnels › TLS et sélectionnez Créer un tunnel TLS pour ouvrir le formulaire.
-
Choisir le type d'URL, l'appareil et la région #
Dans Type d'URL, sélectionnez Sous-domaine aléatoire ou Sous-domaine personnalisé. 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.
-
Saisir le point d'accès #
Champ Ce qu'il faut saisir Domaine localto.net, ou un domaine que vous avez ajouté dans Gestionnaire DNS.Sous-domaine Uniquement pour Sous-domaine personnalisé : le nom placé devant le domaine. Les lettres, les chiffres et les traits d'union sont autorisés. Adresse IP locale L'adresse du service sur votre appareil. Utilisez 127.0.0.1pour cet appareil.Port local Le port sur lequel écoute votre service TLS, par exemple 443ou8443.Sélectionnez Créer le tunnel.
-
Démarrer le tunnel #
Sélectionnez le bouton de démarrage dans la colonne Actions. La colonne URL affiche le nom d'hôte, et la colonne Port du serveur affiche
443. Les clients se connectent à ce nom d'hôte sur le port 443.
Le point d'accès #
- Tout tunnel TLS est joint sur le port 443. Le port local peut être n'importe quel port.
- Localtonet retrouve votre tunnel grâce au nom d'hôte que le client envoie à l'ouverture de la connexion TLS (SNI). Les clients doivent donc se connecter avec le nom d'hôte de la colonne URL. Une connexion à l'adresse IP du serveur qui ne porte pas ce nom d'hôte n'atteint pas votre tunnel.
- Le nom d'hôte reste le même lorsque vous arrêtez et redémarrez le tunnel.
Mode SSL : qui gère le certificat #
Ouvrez les paramètres du tunnel et sélectionnez Gérer à côté de Mode SSL. La boîte de dialogue Mode SSL demande qui gère le HTTPS de ce tunnel.
| Choix | Ce qui se passe | À utiliser quand |
|---|---|---|
| Mon service gère HTTPS | Passthrough. Le trafic chiffré traverse directement jusqu'à votre service, qui doit présenter son propre certificat pour ce domaine. Localtonet ne le déchiffre pas. | Vous avez besoin de votre propre certificat ou d'un chiffrement de bout en bout. Un nouveau tunnel TLS démarre dans ce mode. |
| Localtonet gère HTTPS | Localtonet fournit et renouvelle le certificat. Rien à configurer de votre côté. Localtonet termine la connexion TLS et transmet le trafic déchiffré à votre service. | Votre service n'a pas de certificat, mais les clients doivent l'atteindre en TLS sur le port 443. |
Sélectionnez Enregistrer. Si le tunnel est en cours d'exécution, il redémarre avec le nouveau mode, l'application Localtonet doit donc être connectée.
Le paramètre SslStream ? appartient au second mode. Activez-le lorsque Localtonet gère le HTTPS et que votre service local attend toujours une connexion TLS. Laissez-le désactivé en mode passthrough, où la connexion TLS du visiteur atteint déjà votre service sans modification.
Paramètres d'un tunnel TLS #
| Paramètre | Fonction | En savoir plus |
|---|---|---|
| Mode SSL | Choisissez un SSL géré par Localtonet ou transmettez le trafic TLS tel quel à votre propre service. | Cette page, plus haut |
| SslStream ? | Activez TLS lorsque votre service local l'utilise. | Cette page, plus haut |
| Connexion héritée ? | À essayer si le tunnel ne parvient pas à se connecter avec la méthode habituelle. | Référence des paramètres |
| IP du tunnel | Affichez les adresses IPv4 et IPv6 du serveur. | Référence des paramètres |
| Restriction IP | Contrôlez quelles adresses IP clientes peuvent accéder à ce tunnel. | Contrôle d'accès |
| 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 et 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 | Consultez les connexions faites au tunnel, ses démarrages, ses arrêts et ses modifications de paramètres, ainsi que les vérifications de santé. | Journaux et inspection |
| Arguments | Faites passer 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 identifier ce tunnel. | Référence des paramètres |
| Répartition de charge | Répartissez le trafic entre plusieurs appareils ou utilisez une cible de secours. | Équilibrage de charge |
Un tunnel TLS n'a ni paramètre de port de serveur ni port réservé. Le port est toujours 443.
Exemples #
Un serveur web avec son propre certificat #
Votre serveur web écoute sur 127.0.0.1:443 et dispose d'un certificat pour secure.example.com. Vous avez ajouté example.com dans le Gestionnaire DNS et votre compte a du solde.
| Champ | Valeur |
|---|---|
| Type d'URL | Sous-domaine personnalisé |
| Sous-domaine | secure |
| Domaine | example.com |
| Adresse IP locale | 127.0.0.1 |
| Port local | 443 |
Démarrez le tunnel et ouvrez https://secure.example.com. Le navigateur affiche le certificat de votre propre serveur. Vous pouvez vérifier quel certificat est présenté avec OpenSSL :
openssl s_client -connect <TUNNEL_HOST>:443 -servername <TUNNEL_HOST>Un service non HTTP sur TLS #
Un courtier de messages sur votre appareil accepte les connexions TLS sur le port local 8883. Créez un tunnel TLS avec Port local 8883. Les clients se connectent alors au nom d'hôte du tunnel sur le port 443 avec TLS activé. Le client doit envoyer le nom d'hôte (SNI), ce que font les bibliothèques TLS lorsque vous vous connectez par nom.
TLS sur le port 443 pour un service sans certificat #
Créez le tunnel vers le port en clair de votre service, ouvrez Mode SSL et sélectionnez Localtonet gère HTTPS. Les clients se connectent en TLS et reçoivent un certificat de Localtonet. Votre service continue de recevoir du trafic non chiffré.
Avec l'offre gratuite #
Les tunnels TLS s'arrêtent après 30 minutes sur l'offre gratuite. Sélectionnez Démarrer pour lancer une nouvelle session s'il vous reste de la bande passante mensuelle. Le nom d'hôte ne change pas. Voir Offres et solde.
Dépannage #
Les clients affichent un avertissement de certificat
En mode passthrough, les clients voient le certificat de votre propre service. Il doit être valide pour le nom d'hôte du tunnel et approuvé par le client. Installez un certificat correspondant sur votre service, ou passez Mode SSL sur Localtonet gère HTTPS.
La connexion se ferme juste après son ouverture
En mode passthrough, votre service local doit répondre lui-même à la négociation TLS. Si le service sur le port local parle en HTTP simple ou en TCP simple, passez Mode SSL sur Localtonet gère HTTPS ou utilisez un tunnel HTTP ou TCP. Vérifiez aussi que SslStream ? est désactivé en mode passthrough.
« Démarrez ou mettez à jour l'application Localtonet. »
Le tunnel n'a pas pu être démarré sur l'appareil. Les tunnels TLS nécessitent Localtonet Desktop v7.6 ou Mobile v9.9, ou une version ultérieure. Mettez le client à jour depuis la page Téléchargements et redémarrez le tunnel.
« Vérifiez la connexion de l'appareil. »
Vous avez enregistré Mode SSL ou un autre 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 de nouveau, ou arrêtez d'abord le tunnel.
« Vous devez acheter du solde pour utiliser cette fonctionnalité. »
Sous-domaine personnalisé nécessite du solde. Utilisez Sous-domaine aléatoire, ou ajoutez du solde sous Solde.
Le tunnel s'est arrêté au bout d'une demi-heure
C'est la limite de session de l'offre gratuite. Le tunnel arrêté affiche Session terminée dans la liste. Redémarrez-le, ou ajoutez du solde pour lever la limite.