Vai al contenuto
Localtonet Localtonet Dashboard

Single Sign-On con Microsoft

Saldo necessario Tunnel HTTP

Aiuto su questa pagina
In questa pagina 6 sezioni
  1. Prima di iniziare
  2. Passaggi
  3. Registra un'applicazione in Microsoft Entra
  4. Aggiungi il provider in Localtonet
  5. Attivalo per un tunnel
  6. Provalo
  7. Tipi di account ed endpoint
  8. Cosa legge Localtonet da Microsoft
  9. Risoluzione dei problemi
  10. Pagine correlate

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 #

  1. 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:

    1. Nel Microsoft Entra admin center, vai a Entra ID › App registrations e seleziona New registration.
    2. Inserisci un Name. I visitatori lo vedono quando accedono.
    3. In Supported account types, scegli chi può usare l'applicazione, poi seleziona Register.
    4. Nella pagina Overview, copia l'Application (client) ID. Per un'applicazione single-tenant, copia anche il Directory (tenant) ID.
    5. In Manage, apri Authentication, seleziona Add Redirect URI, scegli la piattaforma Web, inserisci il redirect URI qui sotto e seleziona Configure.
    6. 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/callback

    Un 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.

  2. Aggiungi il provider in Localtonet #

    Apri I miei tunnel › HTTP e seleziona SSO in cima alla pagina. Nella finestra Provider SSO, seleziona Aggiungi provider.

    CampoValore
    Nome del providerUn nome qualsiasi, ad esempio Company Microsoft. Lo vedi nelle impostazioni del tunnel.
    Tipo di providerMicrosoft. Cambiare il tipo di un provider salvato svuota Client ID, quindi inserisci di nuovo il client ID e il client secret.
    AttivoAttivo
    Client IDL'Application (client) ID di Microsoft Entra.
    Client secretIl Value del secret, non il Secret ID. Non viene mai mostrato dopo il salvataggio.

    Apri Endpoint e callback. Questi valori vengono compilati automaticamente:

    CampoValore precompilatoDa modificare?
    Endpoint di autorizzazionehttps://login.microsoftonline.com/common/oauth2/v2.0/authorizeSostituisci common secondo la tabella nella sezione successiva.
    Endpoint del tokenhttps://login.microsoftonline.com/common/oauth2/v2.0/tokenSostituisci common con lo stesso valore di sopra.
    Endpoint delle informazioni utentehttps://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.

  3. 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.

  4. 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 EntraDa usare al posto di commonChi può accedere
Single tenant onlyIl tuo Directory (tenant) IDUtenti e ospiti del tuo tenant.
Multiple Entra ID tenantsorganizationsAccount aziendali o dell'istituto di istruzione di qualsiasi organizzazione.
Any Entra ID Tenant + Personal Microsoft accountsMantieni commonAccount aziendali o dell'istituto di istruzione e account Microsoft personali.
Personal accounts onlyconsumersAccount Microsoft personali.

Esempio per un'applicazione single-tenant. Sostituisci <TENANT_ID> con il tuo Directory (tenant) ID:

Single tenant
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/userinfo

Un'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.

Supporto