Single Sign-On con Microsoft
Saldo necessario Tunnel HTTP
In questa pagina 6 sezioni
Permetti ai visitatori di accedere con un account aziendale o dell'istituto di istruzione di Microsoft Entra ID, oppure con un account Microsoft personale, prima di poter aprire un tunnel HTTP. Registri un'applicazione in Microsoft Entra, la aggiungi a Localtonet come provider, poi la attivi per il tunnel.
Prima di iniziare #
- Un tunnel HTTP e Saldo sul tuo account. Vedi la panoramica di Single Sign-On.
- Accesso al Microsoft Entra admin center con un ruolo che può registrare applicazioni. Microsoft indica Application Developer come minimo.
- Una decisione su chi può accedere: solo la tua organizzazione, qualsiasi organizzazione, oppure anche gli account personali. Da essa dipendono due degli indirizzi che inserisci in Localtonet. Vedi Tipi di account ed endpoint.
Passaggi #
-
Registra un'applicazione in Microsoft Entra #
Le guide di Microsoft sono Register an app in Microsoft Entra ID, Add a redirect URI e Add app credentials. In breve:
- Nel Microsoft Entra admin center, vai a Entra ID › App registrations e seleziona New registration.
- Inserisci un Name. I visitatori lo vedono quando accedono.
- In Supported account types, scegli chi può usare l'applicazione, poi seleziona Register.
- Nella pagina Overview, copia l'Application (client) ID. Per un'applicazione single-tenant, copia anche il Directory (tenant) ID.
- In Manage, apri Authentication, seleziona Add Redirect URI, scegli la piattaforma Web, inserisci il redirect URI qui sotto e seleziona Configure.
- Apri Certificates & secrets › Client secrets e seleziona New client secret. Aggiungi una descrizione, scegli una scadenza e seleziona Add. Copia subito il Value del secret: Microsoft non lo mostra più dopo che lasci la pagina.
Redirect URI (piattaforma: Web)http://auth.localtonet.com/auth/callbackUn client secret scade. Microsoft ne limita la durata a 24 mesi. Alla scadenza, l'accesso smette di funzionare finché non crei un nuovo secret e lo salvi nel provider Localtonet.
-
Aggiungi il provider in Localtonet #
Apri I miei tunnel › HTTP e seleziona SSO in cima alla pagina. Nella finestra Provider SSO, seleziona Aggiungi provider.
Campo Valore Nome del provider Un nome qualsiasi, ad esempio Company Microsoft. Lo vedi nelle impostazioni del tunnel.Tipo di provider Microsoft. Cambiare il tipo di un provider salvato svuota Client ID, quindi inserisci di nuovo il client ID e il client secret. Attivo Attivo Client ID L'Application (client) ID di Microsoft Entra. Client secret Il Value del secret, non il Secret ID. Non viene mai mostrato dopo il salvataggio. Apri Endpoint e callback. Questi valori vengono compilati automaticamente:
Campo Valore precompilato Da modificare? Endpoint di autorizzazione https://login.microsoftonline.com/common/oauth2/v2.0/authorizeSostituisci commonsecondo la tabella nella sezione successiva.Endpoint del token https://login.microsoftonline.com/common/oauth2/v2.0/tokenSostituisci commoncon lo stesso valore di sopra.Endpoint delle informazioni utente https://graph.microsoft.com/oidc/userinfoNo. Non contiene alcun tenant. Percorso di callback /auth/callback/microsoftNo. Se vuoi, compila Regole di accesso per email, poi seleziona Salva provider.
-
Attivalo per un tunnel #
In I tuoi tunnel, seleziona Impostazioni sul tunnel, poi Gestisci accanto a Provider SSO. Nella finestra Single sign-on, attiva Richiedi l'accesso e l'interruttore del tuo provider Microsoft. Seleziona Salva.
Gli elenchi in Chi può accedere e i Percorsi di accesso sono facoltativi. Sono spiegati nella panoramica.
-
Provalo #
Apri l'URL del tunnel in una finestra privata del browser. Localtonet mostra Sign in to continue con un pulsante per il tuo provider. Dopo aver effettuato l'accesso su Microsoft, vieni reindirizzato al tunnel e il tuo servizio si carica.
Tipi di account ed endpoint #
La parte dell'indirizzo Microsoft dopo login.microsoftonline.com/ controlla chi può accedere. Deve corrispondere ai Supported account types della tua applicazione. L'Endpoint di autorizzazione e l'Endpoint del token ricevono sempre lo stesso valore. L'Endpoint delle informazioni utente non cambia mai.
| Supported account types in Microsoft Entra | Da usare al posto di common | Chi può accedere |
|---|---|---|
| Single tenant only | Il tuo Directory (tenant) ID | Utenti e ospiti del tuo tenant. |
| Multiple Entra ID tenants | organizations | Account aziendali o dell'istituto di istruzione di qualsiasi organizzazione. |
| Any Entra ID Tenant + Personal Microsoft accounts | Mantieni common | Account aziendali o dell'istituto di istruzione e account Microsoft personali. |
| Personal accounts only | consumers | Account Microsoft personali. |
Esempio per un'applicazione single-tenant. Sostituisci <TENANT_ID> con il tuo Directory (tenant) ID:
Authorization endpoint: https://login.microsoftonline.com/<TENANT_ID>/oauth2/v2.0/authorize
Token endpoint: https://login.microsoftonline.com/<TENANT_ID>/oauth2/v2.0/token
User info endpoint: https://graph.microsoft.com/oidc/userinfoUn'applicazione single-tenant non funziona con common. Microsoft risponde con l'errore AADSTS50194. Inserisci il tuo tenant ID in entrambi gli endpoint, oppure cambia l'applicazione in un tipo di account multitenant.
Con un tipo di account multitenant o personale, anche persone esterne alla tua organizzazione possono accedere su Microsoft. Usa Domini email consentiti sul provider, oppure Chi può accedere sul tunnel, per ammettere solo le persone che vuoi.
Cosa legge Localtonet da Microsoft #
L'endpoint delle informazioni utente di Microsoft restituisce un indirizzo email solo quando ne è associato uno all'account, quindi un account senza indirizzo email potrebbe non superare le regole basate sull'email.
Risoluzione dei problemi #
AADSTS50011: the reply URL does not match
Il redirect URI nella richiesta non è registrato per l'applicazione. Il messaggio mostra l'indirizzo che è stato inviato. Deve essere identico a un redirect URI nella pagina Authentication della registrazione dell'app, sulla piattaforma Web, comprese maiuscole e minuscole. Registra esattamente http://auth.localtonet.com/auth/callback.
AADSTS50194: the application is not configured as a multitenant application
L'applicazione è single tenant, ma gli endpoint contengono ancora common. Sostituisci common con il tuo Directory (tenant) ID nell'Endpoint di autorizzazione e nell'Endpoint del token, e seleziona Salva provider.
AADSTS700016: the application was not found in the directory
Il Client ID è errato, oppure gli endpoint puntano a un tenant in cui l'applicazione non esiste. Controlla l'Application (client) ID e il tenant ID negli endpoint.
AADSTS7000215 o AADSTS7000222: client secret non valido o scaduto
Crea un nuovo client secret in Certificates & secrets, incolla il suo Value in Client secret in Localtonet e seleziona Salva provider.
Microsoft richiede l'approvazione dell'amministratore
Il tuo tenant non permette agli utenti di concedere da soli il consenso alle applicazioni. Un amministratore del tenant deve concedere il consenso per l'applicazione nel Microsoft Entra admin center.
“403 - Access Denied” dopo un accesso Microsoft riuscito
Una regola di Localtonet ha rifiutato l'account. Controlla Regole di accesso per email sul provider e Chi può accedere sul tunnel, e verifica se l'account ha un indirizzo email. Dopo aver corretto una regola, attendi un minuto e ricarica.