Single Sign-On per i tunnel HTTP
Saldo necessario Tunnel HTTP
In questa pagina 10 sezioni
Il single sign-on (SSO) mette una pagina di accesso davanti a un tunnel HTTP. Prima che qualsiasi richiesta raggiunga il tuo servizio, i visitatori accedono con un provider di identità a tua scelta, come Google, GitHub, Microsoft o GitLab, oppure con un nome utente e una password che definisci tu.
Quando usarlo #
Finché non lo proteggi, un tunnel HTTP è aperto a chiunque ne conosca l'indirizzo. L'SSO è la protezione giusta quando le persone aprono il tunnel in un browser e vuoi decidere chi possono essere: un pannello di amministrazione, una dashboard, uno strumento interno, un sito di staging. Il tuo servizio non cambia e non vede mai una password.
L'SSO è pensato per i browser. Una richiesta che non porta il cookie di accesso viene reindirizzata alla pagina di accesso, quindi script, webhook e client API non possono passare. Per questi casi proteggi solo alcuni percorsi (vedi Percorsi di accesso) oppure usa le opzioni di Controllo degli accessi.
Come funziona #
- Un visitatore apre l'URL del tunnel. Una richiesta via HTTP viene prima reindirizzata a HTTPS.
- Il visitatore non ha ancora effettuato l'accesso, quindi il server Localtonet reindirizza il browser alla pagina di accesso su
auth.localtonet.com. La pagina ha il titolo Sign in to continue e offre i provider che hai attivato per questo tunnel. - Il visitatore sceglie un provider e accede lì. Per un provider con nome utente e password, il modulo si trova nella pagina di accesso stessa.
- Localtonet controlla le tue regole di accesso e rimanda il visitatore all'indirizzo che aveva richiesto. L'accesso viene conservato in un cookie per il nome host del tunnel. È un cookie di sessione del browser, inviato solo tramite HTTPS.
- Da quel momento le richieste vengono inoltrate al tuo servizio come di consueto. Quando l'accesso non è più valido, il visitatore viene mandato di nuovo alla pagina di accesso.
Un visitatore che accede ma non è consentito dalle tue regole vede 403 - Access Denied con il testo "You do not have permission to access this tunnel."
I percorsi sotto /.well-known non vengono mai messi dietro l'accesso.
Prima di iniziare #
- Un tunnel HTTP. Vedi HTTP / HTTPS.
- Saldo sul tuo account. Senza saldo, salvare un provider o attivare l'accesso non riesce e compare "Devi acquistare del saldo per usare questa funzione." Vedi Piani e saldo e Prezzi.
- Per un provider esterno: un account presso di esso che ti permetta di registrare un'applicazione OAuth.
L'SSO si configura nella tua dashboard personale. Il pulsante SSO e l'impostazione Provider SSO non sono visibili per i tunnel del team.
Provider #
Queste guide trattano passo dopo passo le scelte più comuni:
L'elenco Tipo di provider nella dashboard contiene: Username-Password, Google, GitHub, Microsoft, OpenID Connect, Discord, Twitter (X), Custom, Facebook, Apple, LinkedIn, GitLab, Slack, Spotify, Twitch, Reddit, Bitbucket, Amazon e Yahoo. Per ogni tipo tranne Username-Password e Custom, gli endpoint vengono compilati per te. Per OpenID Connect gli indirizzi compilati sono esempi che sostituisci con gli endpoint del tuo provider.
Configurazione #
Ci sono due parti. Aggiungi un provider una sola volta e da quel momento è disponibile per tutti i tuoi tunnel HTTP. Poi lo attivi per ogni tunnel che vuoi proteggere. Un provider salvato non protegge nulla finché un tunnel non lo usa.
-
Aggiungi un provider #
Apri I miei tunnel › HTTP e seleziona SSO in cima alla pagina (il suo tooltip riporta Impostazioni del provider SSO). Si apre la finestra Provider SSO. Seleziona Aggiungi provider, compila il modulo e seleziona Salva provider. Ogni provider viene salvato separatamente.
Campo Cos'è Note Nome del provider Un nome per identificare questo provider nelle impostazioni del tunnel. Obbligatorio. Ad esempio Company Google.Tipo di provider Il metodo di accesso. Un nuovo provider parte come Google. Cambiare il tipo di un provider salvato svuota Client ID, quindi inserisci di nuovo il client ID e il client secret. Attivo Rende il provider disponibile ai tunnel. Quando imposti un provider come non attivo e salvi, viene disattivato anche su ogni tunnel che lo usava. Client ID L'ID dell'applicazione che hai registrato presso il provider. Obbligatorio per ogni tipo tranne Username-Password e Custom. Client secret Il secret di quell'applicazione. Non viene mai mostrato dopo il salvataggio. Lascialo vuoto in seguito per mantenere il secret salvato. Endpoint e callback Endpoint di autorizzazione, Endpoint del token, Endpoint delle informazioni utente e Percorso di callback. Compilati automaticamente per i provider standard. Modificali solo quando te lo indica una guida. Regole di accesso per email Domini email consentiti, Domini email bloccati e Indirizzi email bloccati. Facoltativo. Vedi Regole di accesso. Utenti di accesso Nomi utente e password. Solo per i tipi Username-Password e Custom. Per rimuovere un provider, seleziona Elimina provider. Viene rimosso dal tuo account e dalle impostazioni SSO dei tuoi tunnel.
-
Attivalo per un tunnel #
In I tuoi tunnel, seleziona Impostazioni sul tunnel. Nel pannello Impostazioni del tunnel, trova Provider SSO e seleziona Gestisci. Si apre la finestra Single sign-on.
Impostazione Cosa fa Richiedi l'accesso Attiva l'SSO per questo tunnel. I visitatori che non hanno effettuato l'accesso vengono prima mandati alla pagina di accesso. Provider Un interruttore per ciascuno dei tuoi provider attivi. Attivane almeno uno. Se ne sono attivi diversi, il visitatore sceglie nella pagina di accesso. Chi può accedere Elenchi facoltativi di Indirizzi email, Domini email e Nomi utente per questo tunnel. Percorsi di accesso e uscita Percorsi di accesso facoltativi e un Percorso di uscita. Seleziona Salva.
-
Provalo #
Apri l'URL del tunnel in una finestra privata del browser. Dovresti arrivare alla pagina Sign in to continue e, dopo l'accesso, al tuo servizio.
L'URI di reindirizzamento #
Un provider esterno chiede dove può rimandare le persone dopo l'accesso. Per ogni tunnel questo è un indirizzo sull'host di accesso di Localtonet, non l'indirizzo del tuo tunnel. Registra esattamente questo valore:
http://auth.localtonet.com/auth/callbackOgni guida ai provider ti indica dove inserirlo.
| Valore | Dove va inserito |
|---|---|
| L'URI di reindirizzamento qui sopra | Presso il provider: Authorized redirect URIs (Google), Authorization callback URL (GitHub), Redirect URI (Microsoft, GitLab). |
Percorso di callback, ad esempio /auth/callback/google | In Localtonet, sotto Endpoint e callback. Viene compilato per te. Lascialo com'è. |
Il provider confronta l'URI di reindirizzamento con il valore registrato in modo esatto, quindi copialo così come è mostrato qui.
Regole di accesso #
L'accesso dimostra chi è un visitatore. Le regole decidono se quella persona può aprire il tunnel. Ci sono due livelli e si applicano entrambi.
| Dove | Elenco | Cosa dice la dashboard |
|---|---|---|
| Provider | Domini email consentiti | Lascia vuoto per nessuna restrizione di dominio. I caratteri jolly dipendono dal provider. |
| Provider | Domini email bloccati | Blocca gli accessi da questi domini email. |
| Provider | Indirizzi email bloccati | Blocca questi singoli indirizzi email. |
| Tunnel | Indirizzi email, Domini email, Nomi utente | Lascia vuoto un elenco per saltare quel controllo. Gli elenchi si applicano a tutti i provider attivati per il tunnel. |
Inserisci un elemento per riga oppure separa gli elementi con virgole. Un dominio si inserisce senza @, ad esempio example.com.
Dopo aver modificato una regola, un visitatore già ammesso può mantenere l'accesso fino a cinque minuti. Un visitatore che era stato rifiutato viene ricontrollato dopo un minuto.
Percorsi di accesso e percorso di uscita #
| Impostazione | Comportamento | Esempio |
|---|---|---|
| Percorsi di accesso | Vuoto: ogni percorso del tunnel richiede l'accesso. Compilato: richiedono l'accesso solo le richieste il cui percorso inizia con una delle voci. | /admin copre /admin e /admin/users, non /administrator. |
| Percorso di uscita | Aprendolo si rimuove l'accesso per questo tunnel e il visitatore viene mandato alla pagina iniziale del tunnel, oppure all'indirizzo indicato in un valore di query returnUrl. | /sso/logout |
I percorsi iniziano con una barra. Maiuscole e minuscole non fanno differenza.
Un elenco Percorsi di accesso compilato lascia aperto tutto il resto. Con /admin nell'elenco, solo /admin è protetto e tutti gli altri percorsi sono raggiungibili senza accesso. Lascia vuoto l'elenco per proteggere l'intero tunnel.
Il percorso di uscita disconnette il visitatore solo dal tunnel. Non lo disconnette da Google, GitHub o da un altro provider di identità.
Risoluzione dei problemi #
"Devi acquistare del saldo per usare questa funzione."
L'SSO richiede saldo. Aggiungi saldo, poi salva di nuovo. Senza saldo puoi comunque aprire la finestra e disattivare Richiedi l'accesso.
"Aggiungi un provider prima di attivare l'accesso."
Non hai ancora nessun provider attivo. Seleziona Aggiungi un provider nella finestra, oppure usa il pulsante SSO in cima alla pagina HTTP.
"Attiva almeno un provider, oppure disattiva l'accesso."
Richiedi l'accesso è attivo ma nessun interruttore di provider è attivo. Un provider che imposti come non attivo viene disattivato sui suoi tunnel e non compare più nell'elenco.
La pagina di accesso riporta "No authentication providers are currently configured for this tunnel."
L'accesso è richiesto, ma nessun provider è attivato per questo tunnel. Apri Provider SSO › Gestisci sul tunnel e attivane uno.
Il tunnel si apre senza chiedere l'accesso
Controlla che Richiedi l'accesso sia attivo e salvato. Se Percorsi di accesso è compilato, sono protetti solo quei percorsi. Prova anche in una finestra privata: il tuo browser potrebbe avere ancora l'accesso effettuato.
"403 - Access Denied" dopo l'accesso
L'accesso è riuscito, ma una regola ha rifiutato l'account. Controlla le Regole di accesso per email del provider e gli elenchi Chi può accedere del tunnel. Dopo aver corretto una regola, attendi un minuto e ricarica.
Un webhook o un client API riceve un reindirizzamento invece di una risposta
Le richieste senza il cookie di accesso vengono reindirizzate alla pagina di accesso. Inserisci in Percorsi di accesso solo le pagine destinate alle persone, oppure usa un tunnel separato per il traffico tra macchine.
Automazione #
I provider e le impostazioni SSO dei tunnel si possono gestire anche tramite l'API, sotto /api/v2/sso-providers, e tramite il server MCP.