Single Sign-On voor HTTP-tunnels
Saldo vereist HTTP-tunnels
Op deze pagina 10 secties
Single sign-on (SSO) plaatst een inlogpagina voor een HTTP-tunnel. Bezoekers loggen in met een identiteitsprovider naar keuze, zoals Google, GitHub, Microsoft of GitLab, of met een gebruikersnaam en wachtwoord die jij bepaalt, voordat een verzoek je service bereikt.
Wanneer gebruik je het #
Zolang je hem niet beveiligt, is een HTTP-tunnel open voor iedereen die het adres kent. SSO is de juiste beveiliging wanneer mensen de tunnel in een browser openen en jij wilt bepalen wie ze zijn: een beheerpaneel, een dashboard, een intern hulpmiddel, een stagingsite. Je service verandert niet en ziet nooit een wachtwoord.
SSO is gemaakt voor browsers. Een verzoek zonder inlogcookie wordt doorgestuurd naar de inlogpagina, dus scripts, webhooks en API-clients komen er niet doorheen. Beveilig daarvoor alleen bepaalde paden (zie Inlogpaden) of gebruik de opties in Toegangsbeheer.
Hoe het werkt #
- Een bezoeker opent de tunnel-URL. Een verzoek via HTTP wordt eerst doorgestuurd naar HTTPS.
- De bezoeker is nog niet ingelogd, dus de Localtonet-server stuurt de browser door naar de inlogpagina op
auth.localtonet.com. De pagina heeft de kop Sign in to continue en toont de providers die je voor deze tunnel hebt ingeschakeld. - De bezoeker kiest een provider en logt daar in. Bij een provider met gebruikersnaam en wachtwoord staat het formulier op de inlogpagina zelf.
- Localtonet controleert je toegangsregels en stuurt de bezoeker terug naar het adres dat die opvroeg. De login wordt bewaard in een cookie voor de hostnaam van de tunnel. Het is een sessiecookie van de browser en wordt alleen via HTTPS verzonden.
- Vanaf dat moment worden verzoeken gewoon doorgestuurd naar je service. Als de login niet meer geldig is, wordt de bezoeker opnieuw naar de inlogpagina gestuurd.
Een bezoeker die inlogt maar volgens je regels geen toegang heeft, ziet 403 - Access Denied met de tekst "You do not have permission to access this tunnel."
Paden onder /.well-known worden nooit achter de login geplaatst.
Voordat je begint #
- Een HTTP-tunnel. Zie HTTP / HTTPS.
- Saldo op je account. Zonder saldo mislukt het opslaan van een provider of het inschakelen van inloggen met "Je moet saldo kopen om deze functie te gebruiken." Zie Abonnementen en saldo en Prijzen.
- Voor een externe provider: een account daar waarmee je een OAuth-toepassing kunt registreren.
SSO stel je in via je persoonlijke dashboard. De knop SSO en de instelling SSO-providers worden niet getoond voor teamtunnels.
Providers #
Deze handleidingen behandelen de meest gekozen opties stap voor stap:
De lijst Providertype in het dashboard bevat: Username-Password, Google, GitHub, Microsoft, OpenID Connect, Discord, Twitter (X), Custom, Facebook, Apple, LinkedIn, GitLab, Slack, Spotify, Twitch, Reddit, Bitbucket, Amazon en Yahoo. Voor elk type behalve Username-Password en Custom worden de endpoints voor je ingevuld. Bij OpenID Connect zijn de ingevulde adressen voorbeelden die je vervangt door de endpoints van je provider.
Instellen #
Er zijn twee delen. Je voegt eenmalig een provider toe, en die is daarna beschikbaar voor al je HTTP-tunnels. Daarna schakel je hem in voor elke tunnel die je wilt beveiligen. Een opgeslagen provider beveiligt niets zolang geen tunnel hem gebruikt.
-
Een provider toevoegen #
Open Mijn tunnels › HTTP en kies bovenaan de pagina SSO (de tooltip luidt Instellingen SSO-provider). Het dialoogvenster SSO-providers wordt geopend. Kies Provider toevoegen, vul het formulier in en kies Provider opslaan. Elke provider wordt apart opgeslagen.
Veld Wat het is Opmerkingen Providernaam Een naam om deze provider in je tunnelinstellingen te herkennen. Verplicht. Bijvoorbeeld Company Google.Providertype De inlogmethode. Een nieuwe provider begint als Google. Als je het type van een opgeslagen provider wijzigt, wordt Client-ID leeggemaakt, dus voer de client-ID en het clientgeheim opnieuw in. Actief Maakt de provider beschikbaar voor tunnels. Als je een provider op inactief zet en opslaat, wordt hij ook uitgeschakeld voor elke tunnel die hem gebruikte. Client-ID De ID van de toepassing die je bij de provider hebt geregistreerd. Verplicht voor elk type behalve Username-Password en Custom. Clientgeheim Het geheim van die toepassing. Wordt na het opslaan nooit meer getoond. Laat het later leeg om het opgeslagen geheim te behouden. Endpoints & callback Autorisatie-endpoint, Token-endpoint, Gebruikersinfo-endpoint en Callbackpad. Wordt automatisch ingevuld voor de standaardproviders. Wijzig ze alleen als een handleiding je dat vertelt. Toegangsregels voor e-mail Toegestane e-maildomeinen, Geblokkeerde e-maildomeinen en Geblokkeerde e-mailadressen. Optioneel. Zie Toegangsregels. Inloggebruikers Gebruikersnamen en wachtwoorden. Alleen voor de typen Username-Password en Custom. Om een provider te verwijderen, kies je Provider verwijderen. Hiermee verwijder je hem uit je account en uit de SSO-instellingen van je tunnels.
-
Zet hem aan voor een tunnel #
Kies onder Je tunnels bij de tunnel Instellingen. Zoek in het paneel Tunnelinstellingen naar SSO-providers en kies Beheren. Het dialoogvenster Single sign-on wordt geopend.
Instelling Wat het doet Inloggen vereisen Schakelt SSO in voor deze tunnel. Bezoekers die niet zijn ingelogd, worden eerst naar de inlogpagina gestuurd. Providers Een schakelaar voor elk van je actieve providers. Schakel er minstens één in. Als er meerdere aan staan, kiest de bezoeker op de inlogpagina. Wie kan inloggen Optionele lijsten met E-mailadressen, E-maildomeinen en Gebruikersnamen voor deze tunnel. In- en uitlogpaden Optionele Inlogpaden en een Uitlogpad. Kies Opslaan.
-
Test het #
Open de tunnel-URL in een privévenster van de browser. Je zou op de pagina Sign in to continue moeten uitkomen en na het inloggen op je service.
De redirect-URI #
Een externe provider vraagt waarheen hij mensen mag sturen nadat ze zijn ingelogd. Voor elke tunnel is dit een adres op de inloghost van Localtonet, niet het adres van je tunnel. Registreer precies deze waarde:
http://auth.localtonet.com/auth/callbackIn de handleiding van elke provider staat waar je hem invoert.
| Waarde | Waar hij naartoe gaat |
|---|---|
| De redirect-URI hierboven | Bij de provider: Authorized redirect URIs (Google), Authorization callback URL (GitHub), Redirect URI (Microsoft, GitLab). |
Callbackpad, bijvoorbeeld /auth/callback/google | In Localtonet, onder Endpoints & callback. Het wordt voor je ingevuld. Laat het zoals het is. |
De provider vergelijkt de redirect-URI exact met de geregistreerde waarde, dus kopieer hem precies zoals hier getoond.
Toegangsregels #
Inloggen bewijst wie een bezoeker is. De regels bepalen of die persoon de tunnel mag openen. Er zijn twee niveaus en beide gelden.
| Waar | Lijst | Wat het dashboard zegt |
|---|---|---|
| Provider | Toegestane e-maildomeinen | Laat leeg voor geen domeinbeperking. Jokertekens hangen af van de provider. |
| Provider | Geblokkeerde e-maildomeinen | Blokkeer logins vanaf deze e-maildomeinen. |
| Provider | Geblokkeerde e-mailadressen | Blokkeer deze afzonderlijke e-mailadressen. |
| Tunnel | E-mailadressen, E-maildomeinen, Gebruikersnamen | Laat een lijst leeg om die controle over te slaan. De lijsten gelden voor alle providers die voor de tunnel zijn ingeschakeld. |
Voer één item per regel in, of scheid items met komma's. Een domein voer je in zonder @, bijvoorbeeld example.com.
Nadat je een regel hebt gewijzigd, kan een bezoeker die al was toegelaten tot vijf minuten toegang houden. Een bezoeker die was geweigerd, wordt na één minuut opnieuw gecontroleerd.
Inlogpaden en uitlogpad #
| Instelling | Gedrag | Voorbeeld |
|---|---|---|
| Inlogpaden | Leeg: elk pad van de tunnel vereist inloggen. Gevuld: alleen verzoeken waarvan het pad met een van de items begint, vereisen inloggen. | /admin omvat /admin en /admin/users, niet /administrator. |
| Uitlogpad | Als je het opent, wordt de login voor deze tunnel verwijderd en wordt de bezoeker naar de startpagina van de tunnel gestuurd, of naar het adres in een returnUrl-querywaarde. | /sso/logout |
Paden beginnen met een schuine streep. Hoofdletters en kleine letters maken geen verschil.
Een gevulde lijst met Inlogpaden laat al het andere open. Met /admin in de lijst wordt alleen /admin beveiligd en zijn alle andere paden bereikbaar zonder in te loggen. Laat de lijst leeg om de hele tunnel te beveiligen.
Het uitlogpad logt de bezoeker alleen uit bij de tunnel. Het logt hem niet uit bij Google, GitHub of een andere identiteitsprovider.
Probleemoplossing #
"Je moet saldo kopen om deze functie te gebruiken."
SSO heeft saldo nodig. Voeg saldo toe en sla daarna opnieuw op. Zonder saldo kun je het dialoogvenster nog steeds openen en Inloggen vereisen uitschakelen.
"Voeg een provider toe voordat je inloggen inschakelt."
Je hebt nog geen actieve provider. Kies Provider toevoegen in het dialoogvenster, of gebruik de knop SSO bovenaan de HTTP-pagina.
"Schakel minstens één provider in, of schakel inloggen uit."
Inloggen vereisen staat aan, maar er staat geen enkele providerschakelaar aan. Een provider die je op inactief zet, wordt voor zijn tunnels uitgeschakeld en niet meer weergegeven.
De inlogpagina zegt "No authentication providers are currently configured for this tunnel."
Inloggen is vereist, maar er is geen provider ingeschakeld voor deze tunnel. Open SSO-providers › Beheren bij de tunnel en schakel er een in.
De tunnel opent zonder om inloggen te vragen
Controleer of Inloggen vereisen aan staat en is opgeslagen. Als Inlogpaden is gevuld, worden alleen die paden beveiligd. Test ook in een privévenster: je eigen browser kan nog ingelogd zijn.
"403 - Access Denied" na het inloggen
Het inloggen is gelukt, maar een regel heeft het account geweigerd. Controleer de Toegangsregels voor e-mail van de provider en de lijsten onder Wie kan inloggen van de tunnel. Wacht na het corrigeren van een regel een minuut en laad opnieuw.
Een webhook of API-client krijgt een doorverwijzing in plaats van een antwoord
Verzoeken zonder inlogcookie worden doorgestuurd naar de inlogpagina. Zet in Inlogpaden alleen de pagina's die voor mensen bedoeld zijn, of gebruik een aparte tunnel voor machineverkeer.
Automatisering #
Providers en SSO-instellingen van tunnels kunnen ook worden beheerd via de API, onder /api/v2/sso-providers, en via de MCP-server.