Questo articolo è stato tradotto automaticamente.
Panoramica
Questa guida è rivolta agli amministratori IT che collegano Microsoft Entra ID all’autenticazione globale di Legora per il Single Sign-on (SSO). I membri accedono quindi a Legora con i propri account Entra ID. Lavori in due ambienti: il centro di amministrazione Microsoft Entra e Authentication in Legora. Entra ID usa OpenID Connect con l’autenticazione globale di Legora.La tua organizzazione deve usare l’autenticazione globale di Legora e il tuo ruolo deve includere Manage authentication security. Consulta Come posso gestire l’autenticazione per la mia organizzazione?.Se la tua organizzazione non è ancora passata all’autenticazione globale, il supporto Legora configura il Single Sign-on (SSO). Contatta support@legora.com. Per spostare un’organizzazione esistente, consulta Guida per l’amministratore IT: l’autenticazione globale di Legora.
Funzionamento
Ogni passaggio indica dove eseguirlo. Completa i passaggi Entra prima di testare la connessione in Legora.Passaggio 1: Creare l’applicazione aziendale (in Entra)
Crea in Entra l’applicazione aziendale che Legora usa per connettere i membri. Entra crea anche una registrazione dell’app associata, che usi nei passaggi 2 e 3. Legora deve essere un’applicazione aziendale non di raccolta. Creala in Enterprise apps con i passaggi seguenti, così Entra la configura come applicazione non di raccolta. Le applicazioni di raccolta segnalano che non supportano SCIM, quindi il provisioning di Directory Sync resta non disponibile. Se la tua è un’applicazione di raccolta, o l’hai creata in App registrations, crea una nuova applicazione aziendale e usala per l’accesso e il provisioning.- Accedi al centro di amministrazione Microsoft Entra.
- Vai a Entra ID > Enterprise apps e seleziona New application.
- Seleziona Create your own application.
- Compila il modulo e seleziona Create:
- What’s the name of your app?: Un nome che descrive l’applicazione, ad esempio «Legora SSO».
- What are you looking to do with your application?: Seleziona Integrate any other application you don’t find in the gallery (Non-gallery).
- Vai a Entra ID > App registrations, seleziona All applications e apri l’app con il nome che hai inserito.
- Nella pagina Overview della registrazione dell’app, copia questi valori per il passaggio 4:
- Application (client) ID
- Directory (tenant) ID
Passaggio 2: Aggiungere l’URI di reindirizzamento (in Entra)
Registra il callback di Legora in modo che Entra possa rinviare i membri dopo l’accesso.- Nella registrazione dell’app, vai a Authentication.
- Seleziona Add a platform, quindi scegli Web.
- Incolla questo URI di reindirizzamento e seleziona Configure:
https://sso.legora.com/api/oauth/oidc
Usa questo URI per ogni organizzazione sull’autenticazione globale di Legora. Dopo la creazione della connessione nel passaggio 4, Redirect URL sulla connessione mostra lo stesso valore.
Se Entra chiede quali ambiti OpenID Connect autorizzare, attiva openid, profile e email. Legora ha bisogno dell’indirizzo e-mail dopo l’accesso. Nome e cognome sono consigliati.
Se questa registrazione dell’app ha già URI di reindirizzamento di una configurazione di accesso Legora precedente, lasciali e aggiungi l’URI sopra. Rimuovi i vecchi URI solo dopo che la tua organizzazione ha completato il passaggio all’autenticazione globale di Legora. L’elenco completo delle attività è in Guida per l’amministratore IT: l’autenticazione globale di Legora.
Passaggio 3: Creare un client secret (in Entra)
Crea il secret che Legora usa per connettersi alla tua registrazione dell’app.- Nella registrazione dell’app, vai a Certificates & secrets > Client secrets e seleziona New client secret.
- Aggiungi una descrizione, ad esempio «Legora SSO secret», e scegli la data di scadenza.
- Seleziona Add, quindi copia il Value e salvalo in un posto sicuro. Entra mostra il Value una sola volta. L’ID del secret non può essere incollato in Legora.
- Dal tuo nome nel menu, seleziona Settings > People > Authentication.
- In SSO, seleziona la connessione.
- In Connection details, seleziona Edit.
- Inserisci il nuovo valore in Client secret. Lascia il campo vuoto solo se vuoi conservare il secret attuale.
- Salva.
Passaggio 4: Aggiungere i dettagli della connessione (in Legora)
Inserisci in Legora i valori dei passaggi da 1 a 3. Per il dominio, usa un dominio di proprietà della tua organizzazione. Nel centro di amministrazione Entra, trovalo in Entra ID > Domain names. Usa un dominio verificato comelegora.com. Ignora un dominio che termina con onmicrosoft.com.
- Dal tuo nome nel menu, seleziona Settings > People > Authentication.
- In SSO, seleziona Add, quindi scegli Entra ID.
- Compila il modulo:
- Display Name: Il nome che i membri vedono nella schermata di accesso.
- Domain: Il dominio della tua organizzazione.
- Tenant ID: Il Directory (tenant) ID del passaggio 1.
- Client ID: L’Application (client) ID del passaggio 1.
- Client Secret: Il valore del secret del passaggio 3.
- Seleziona Create connection. Legora apre la nuova connessione.
Passaggio 5: Assegnare utenti e gruppi (in Entra)
Scegli chi può accedere a Legora tramite Entra.- Vai a Entra ID > Enterprise apps e seleziona l’app che hai creato nel passaggio 1.
- In Properties, scegli se ogni utente della directory può accedere o solo gli utenti che assegni. Assignment required? è No per impostazione predefinita. Impostalo su Yes per autorizzare solo gli utenti e i gruppi assegnati.
- Se l’assegnazione è obbligatoria, vai a Users and groups e seleziona Add user/group.
- Seleziona gli utenti o i gruppi che devono avere accesso a Legora, quindi seleziona Assign.
Passaggio 6: Testare la connessione (in Legora)
Conferma che la connessione funzioni prima che i membri la usino.- Dal tuo nome nel menu, seleziona Settings > People > Authentication.
- In SSO, seleziona la connessione.
- Seleziona Test connection. Si apre una finestra di accesso.
Passaggio 7: Attivare la connessione (in Legora)
Rendi la connessione disponibile ai membri. Sulla connessione, attiva Status. I membri potranno quindi accedere con Entra ID. Finché non lo fai, la connessione resta configurata ma non compare come metodo di accesso.Chi può unirsi
Entra controlla chi può autenticarsi. Legora controlla chi diventa membro. Imposti l’appartenenza sulla connessione, in Auto-provision e Email domains.Auto-provision attivato
Quando Auto-provision è attivato, Legora aggiunge una persona la prima volta che accede con un indirizzo e-mail di un dominio in elenco. Deve comunque avere il permesso di autenticarsi in Entra. L’assegnazione dell’app, l’accesso condizionale e l’autenticazione a più fattori restano in Entra. Aggiungi almeno un dominio in Email domains prima di attivare Auto-provision. La connessione deve essere attiva. Se Directory Sync è attivato per la connessione, usa Directory Sync per gestire l’appartenenza. Consulta Directory Sync.Auto-provision disattivato
Quando Auto-provision è disattivato, una persona può comunque autenticarsi in Entra. Legora la aggiunge solo dopo che un Admin la invita e lei accetta. Senza un’appartenenza attiva, l’accesso si interrompe. Legora mostra: «User has no active membership in any of the connection organisations.» Per concedere l’accesso, autorizza la persona in Entra e invitala in Legora. Per rimuovere l’accesso, rimuovila dall’app Entra oppure rimuovila dall’organizzazione in Legora.Domande frequenti
Queste risposte coprono i problemi di accesso che gli amministratori segnalano più spesso dopo l’attivazione della connessione.Cosa succede quando un utente viene rimosso dall’applicazione aziendale in Entra?
Non può più accedere tramite quell’applicazione. Il suo profilo Legora rimane. Se lo riassegni all’applicazione, può accedere, purché sia ancora membro o Auto-provision possa aggiungerlo. Se l’organizzazione usa anche Directory Sync, la disattivazione o la rimozione dell’utente in Entra revoca il suo accesso all’organizzazione. Non elimina il suo profilo Legora.Perché un utente accede a un account Legora vuoto?
Quando Auto-provision è attivato, Legora crea l’account dall’indirizzo e-mail che Entra invia. Se quell’indirizzo differisce da quello dell’invito, ad esempiojdoe@example.com invece di jane.doe@example.com, Legora crea un account distinto per l’indirizzo Entra. Fai coincidere l’e-mail in Entra con l’indirizzo usato in Legora, oppure contatta support@legora.com.