Een TLS-tunnel aanmaken
Desktop v7.6+ Mobiel v9.9+
Op deze pagina 10 secties
- TLS, HTTP of TCP?
- Voordat je begint
- Stappen
- Open de TLS-pagina
- Kies het URL-type, het apparaat en de regio
- Voer het eindpunt in
- Start de tunnel
- Het eindpunt
- SSL-modus: wie het certificaat afhandelt
- Instellingen van een TLS-tunnel
- Voorbeelden
- Een webserver met een eigen certificaat
- Een niet-HTTP-service over TLS
- TLS op poort 443 voor een service zonder certificaat
- In het Gratis-abonnement
- Probleemoplossing
- Gerelateerde pagina's
Een TLS-tunnel stuurt versleuteld verkeer voor een publieke hostnaam op poort 443 door naar een lokale TLS-service. Standaard gaat de versleutelde verbinding rechtstreeks door naar je service, die zijn eigen certificaat toont.
TLS, HTTP of TCP? #
Alle drie kunnen een service met versleuteling publiceren. Ze verschillen in wie het certificaat heeft en hoe het publieke adres eruitziet.
| Vraag | HTTP-tunnel | TLS-tunnel | TCP-tunnel |
|---|---|---|---|
| Publiek eindpunt | https://-adres zonder poort | Hostnaam op poort 443 | Hostnaam en een toegewezen serverpoort |
| Wie het certificaat toont | Localtonet | Standaard je service. Localtonet als je dat kiest bij SSL-modus. | Localtonet voegt geen certificaat toe. Je service doet wat die nu al doet. |
| Waar TLS eindigt | Op de Localtonet-server | Bij je service in de doorgeefmodus | Waar je protocol het beëindigt |
| Protocollen | HTTP en WebSocket | Elk protocol dat over TLS loopt | Elk TCP-protocol |
| HTTP-opties zoals headers, padherschrijving, basisauthenticatie, SSO, WAF en de verzoekinspecteur | Ja | Nee | Nee |
| URL-typen | Willekeurig subdomein, Eigen subdomein, Eigen domein | Willekeurig subdomein, Eigen subdomein | Willekeurig subdomein, Eigen subdomein |
| Sessielimiet bij het Gratis-abonnement | Geen | 30 minuten per sessie | 30 minuten per sessie |
- Kies HTTP voor een gewone website, API of webhookontvanger. Dat kost de minste moeite.
- Kies TLS wanneer je service zijn eigen certificaat moet tonen, wanneer het verkeer tot aan je apparaat versleuteld moet blijven, of wanneer een niet-HTTP-protocol over TLS bereikbaar moet zijn op poort 443.
- Kies TCP wanneer het protocol niet vanaf de eerste byte TLS is, of wanneer clients geen hostnaam kunnen meesturen. Een TCP-tunnel wordt aangesproken via zijn poort, een TLS-tunnel via zijn hostnaam.
Voordat je begint #
- Een actuele Localtonet-client, verbonden met een AuthToken. De TLS-pagina vermeldt de minimale versies: Desktop v7.6 en Mobiel v9.9.
- Een lokale service die TLS spreekt en een certificaat heeft voor de hostnaam die clients gebruiken. Als je service geen certificaat heeft, zie HTTP, of schakel de SSL-modus om zoals hieronder beschreven.
- Voor Eigen subdomein: saldo op je account.
Stappen #
-
Open de TLS-pagina #
Open Mijn tunnels › TLS en kies TLS-tunnel aanmaken om het formulier te openen.
-
Kies het URL-type, het apparaat en de regio #
Kies bij URL-type de optie Willekeurig subdomein of Eigen subdomein. Kies bij Apparaattoken de token die de Localtonet-app op je apparaat gebruikt. Kies bij Serverregio een regio dicht bij je apparaat.
-
Voer het eindpunt in #
Veld Wat je invult Domein localto.net, of een domein dat je hebt toegevoegd in DNS-beheer.Subdomein Alleen voor Eigen subdomein: de naam vóór het domein. Letters, cijfers en koppeltekens zijn toegestaan. Lokaal IP-adres Adres van de service op je apparaat. Gebruik 127.0.0.1voor dit apparaat.Lokale poort De poort waarop je TLS-service luistert, bijvoorbeeld 443of8443.Kies Tunnel aanmaken.
-
Start de tunnel #
Kies de startknop in de kolom Acties. De kolom URL toont de hostnaam en de kolom Serverpoort toont
443. Clients maken met die hostnaam verbinding op poort 443.
Het eindpunt #
- Elke TLS-tunnel is bereikbaar op poort 443. De lokale poort kan elke poort zijn.
- Localtonet vindt je tunnel aan de hand van de hostnaam die de client meestuurt wanneer hij de TLS-verbinding opent (SNI). Clients moeten daarom verbinden met de hostnaam uit de kolom URL. Een verbinding met het IP-adres van de server zonder deze hostnaam bereikt je tunnel niet.
- De hostnaam blijft hetzelfde wanneer je de tunnel stopt en start.
SSL-modus: wie het certificaat afhandelt #
Open de tunnelinstellingen en kies Beheren naast SSL-modus. Het dialoogvenster SSL-modus vraagt wie HTTPS voor deze tunnel afhandelt.
| Keuze | Wat er gebeurt | Gebruik het wanneer |
|---|---|---|
| Mijn service handelt HTTPS af | Doorgeefmodus. Versleuteld verkeer gaat rechtstreeks door naar je service, die een eigen certificaat voor dit domein moet tonen. Localtonet ontsleutelt het niet. | Je een eigen certificaat of end-to-end-versleuteling nodig hebt. Een nieuwe TLS-tunnel start in deze modus. |
| Localtonet handelt HTTPS af | Localtonet levert en vernieuwt het certificaat. Aan jouw kant hoef je niets in te stellen. Localtonet beëindigt de TLS-verbinding en stuurt het ontsleutelde verkeer door naar je service. | Je service geen certificaat heeft, maar clients er met TLS op poort 443 bij moeten kunnen. |
Kies Opslaan. Als de tunnel draait, herstart hij met de nieuwe modus, dus de Localtonet-app moet verbonden zijn.
De instelling SslStream? hoort bij de tweede modus. Zet hem aan wanneer Localtonet HTTPS afhandelt en je lokale service nog steeds een TLS-verbinding verwacht. Laat hem uit in de doorgeefmodus, waar de TLS-verbinding van de bezoeker je service al ongewijzigd bereikt.
Instellingen van een TLS-tunnel #
| Instelling | Wat het doet | Meer lezen |
|---|---|---|
| SSL-modus | Kies SSL dat door Localtonet wordt beheerd, of geef TLS-verkeer door aan je eigen service. | Deze pagina, hierboven |
| SslStream? | Schakel TLS in wanneer je lokale service het gebruikt. | Deze pagina, hierboven |
| Verouderde verbinding? | Probeer dit als de tunnel met de normale methode geen verbinding kan maken. | Instellingenreferentie |
| Tunnel-IP | Bekijk de IPv4- en IPv6-adressen van de server. | Instellingenreferentie |
| IP-beperking | Bepaal welke client-IP-adressen toegang hebben tot deze tunnel. | Toegangsbeheer |
| Vervaldatum, Snelheidslimieten, Bandbreedtelimiet, Bandbreedteverbruik, Bandbreedteverkeer | Stop de tunnel op een bepaalde datum, begrens de snelheid, begrens de data, zet de datateller terug en bekijk het verkeer in de loop van de tijd. | Limieten en vervaldatum |
| Verzoeklogboek, Activiteitenlogboek, Tunnelgezondheid | Bekijk de verbindingen met de tunnel, de starts, stops en instellingswijzigingen, en de gezondheidscontroles. | Logboeken en inspectie |
| Argumenten | Stuur deze tunnel via een specifiek netwerk op je apparaat. | Netwerkselectie |
| Uitgaande poort | Gebruik vaste uitgaande poorten voor de serververbinding van de Localtonet-app, voor strikte firewalls. | Poorten |
| Tunnelnotitie | Sla een privénotitie op om deze tunnel te herkennen. | Instellingenreferentie |
| Load balancing | Verdeel verkeer over apparaten of gebruik een back-updoel. | Load balancing |
Een TLS-tunnel heeft geen instelling voor de serverpoort en geen gereserveerde poort. De poort is altijd 443.
Voorbeelden #
Een webserver met een eigen certificaat #
Je webserver luistert op 127.0.0.1:443 en heeft een certificaat voor secure.example.com. Je hebt example.com toegevoegd in DNS-beheer en je account heeft saldo.
| Veld | Waarde |
|---|---|
| URL-type | Eigen subdomein |
| Subdomein | secure |
| Domein | example.com |
| Lokaal IP-adres | 127.0.0.1 |
| Lokale poort | 443 |
Start de tunnel en open https://secure.example.com. De browser toont het certificaat van je eigen server. Met OpenSSL kun je controleren welk certificaat wordt getoond:
openssl s_client -connect <TUNNEL_HOST>:443 -servername <TUNNEL_HOST>Een niet-HTTP-service over TLS #
Een berichtenbroker op je apparaat accepteert TLS-verbindingen op lokale poort 8883. Maak een TLS-tunnel met Lokale poort 8883. Clients maken dan verbinding met de hostnaam van de tunnel op poort 443 met TLS ingeschakeld. De client moet de hostnaam meesturen (SNI), wat TLS-bibliotheken doen wanneer je op naam verbindt.
TLS op poort 443 voor een service zonder certificaat #
Maak de tunnel naar de gewone poort van je service, open SSL-modus en kies Localtonet handelt HTTPS af. Clients maken verbinding met TLS en ontvangen een certificaat van Localtonet. Je service blijft onversleuteld verkeer ontvangen.
In het Gratis-abonnement #
TLS-tunnels stoppen na 30 minuten bij het Gratis-abonnement. Kies Starten om een nieuwe sessie te beginnen als je nog maandelijkse bandbreedte over hebt. De hostnaam verandert niet. Zie Abonnementen en saldo.
Probleemoplossing #
Clients tonen een certificaatwaarschuwing
In de doorgeefmodus zien clients het certificaat van je eigen service. Dat moet geldig zijn voor de hostnaam van de tunnel en vertrouwd worden door de client. Installeer een passend certificaat op je service, of zet SSL-modus op Localtonet handelt HTTPS af.
De verbinding sluit direct nadat hij is geopend
In de doorgeefmodus moet je lokale service zelf de TLS-handshake beantwoorden. Als de service op de lokale poort gewone HTTP of gewone TCP spreekt, zet dan SSL-modus op Localtonet handelt HTTPS af of gebruik een HTTP- of TCP-tunnel. Controleer ook of SslStream? in de doorgeefmodus uit staat.
"Start of update de Localtonet-app."
De tunnel kon niet op het apparaat worden gestart. TLS-tunnels vereisen Localtonet Desktop v7.6 of Mobiel v9.9 of nieuwer. Werk de client bij via de pagina Downloads en start de tunnel opnieuw.
"Controleer de verbinding van het apparaat."
Je hebt SSL-modus of een andere instelling die een draaiende tunnel herstart opgeslagen terwijl de Localtonet-app offline was. Verbind de app en sla opnieuw op, of stop eerst de tunnel.
"Je moet saldo kopen om deze functie te gebruiken."
Eigen subdomein vereist saldo. Gebruik Willekeurig subdomein, of voeg saldo toe onder Saldo.
De tunnel stopte na een half uur
Dat is de sessielimiet van het Gratis-abonnement. De gestopte tunnel toont Sessie afgelopen in de lijst. Start hem opnieuw, of voeg saldo toe om de limiet op te heffen.