Skip to main content
Questo articolo è stato tradotto automaticamente.

Panoramica

Questa guida è rivolta agli amministratori e agli amministratori IT che eseguono la migrazione della propria organizzazione all’autenticazione globale di Legora. Esegui tu stesso la migrazione dalla pagina Migrazione dell’autenticazione nelle Impostazioni. L’autenticazione globale assegna alla tua organizzazione un indirizzo di accesso dedicato e un’unica configurazione di accesso in tutto Legora. La migrazione prevede sei passaggi. I passaggi da 2 a 5 dipendono da come la tua organizzazione utilizza Legora, quindi consulta la tabella per sapere quali si applicano a te. Apporta ogni modifica in aggiunta alla configurazione esistente. Non rimuovere URL o impostazioni esistenti finché la migrazione non è completata.
Ti serve l’autorizzazione Let members configure SSO and IP restrictions, che il ruolo di Admin include per impostazione predefinita. La pagina Migrazione dell’autenticazione compare solo quando la migrazione self-service è attiva per la tua organizzazione. Se hai più di un’organizzazione Legora, esegui la migrazione di ciascuna separatamente. Non è necessario migrarle contemporaneamente.
La pagina Migrazione dell’autenticazione in Impostazioni ti guida passo dopo passo attraverso l’intera migrazione, nello stesso ordine di questa guida. Mostra quali test sono stati superati e cosa manca ancora prima di poter completare la migrazione. Per aprire la pagina, dal tuo nome nel menu, seleziona Impostazioni > Persone > Migrazione dell’autenticazione.

Passaggio 1: controlla il dominio dedicato della tua organizzazione

Questo passaggio imposta l’indirizzo a cui i tuoi utenti accedono dopo la migrazione. La pagina Migrazione dell’autenticazione lo mostra come Custom URL, ad esempio https://acme.app.legora.com.
Quando ti serve questo passaggio: sempre.
  1. Nella pagina Migrazione dell’autenticazione, controlla Custom URL. Legora lo compila per la tua organizzazione.
  2. Per modificarlo, seleziona l’icona di modifica accanto a Custom URL, inserisci un nuovo Subdomain e seleziona Save.
Il sottodominio deve essere univoco in tutto Legora. Usa lettere minuscole, numeri e trattini, fino a 63 caratteri. Non può iniziare né terminare con un trattino. Non puoi modificare il custom URL dopo aver completato la migrazione, quindi sceglilo ora. Verifica: Custom URL mostra il nuovo indirizzo e Completa la migrazione non chiede più di impostare un custom URL.

Passaggio 2: configura come accedono i membri

Questo passaggio configura l’accesso per l’autenticazione globale. Registri il servizio di accesso globale di Legora presso il tuo provider di identità, ad esempio Okta o Microsoft Entra ID, e scegli se i membri mantengono e-mail e password. Le connessioni esistenti continuano a funzionare mentre prepari quelle nuove.
Quando ti serve questo passaggio: la tua organizzazione utilizza SSO. In caso contrario, salta le modifiche al provider di identità e conferma solo l’accesso con e-mail e password. Non puoi completare la migrazione senza questa conferma.
Copia l’URL ACS completo e l’Identifier del SP visualizzati per questa connessione SAML. Le nuove connessioni usano /api/oauth/saml/<connection-id>. Quelle esistenti possono usare il callback condiviso /api/oauth/saml o un valore specifico fornito. Copia l’URL completo visualizzato per la connessione, inclusi nome host e percorso.
  • OpenID Connect (OIDC): https://sso.legora.com/api/oauth/oidc. Registra questo URL come URI di reindirizzamento consentito per l’accesso nelle impostazioni dell’applicazione del tuo provider di identità. Per Entra ID, consulta la guida alla configurazione di Entra ID.

Connessioni SAML

  1. In New connections, seleziona Add per aggiungere ciascuna nuova connessione SAML.
  2. Inserisci un Connection name e seleziona Continue.
  3. Copia Entity ID (Identifier) e ACS URL (Reply URL). Puoi riprendere la configurazione in seguito.
Inserisci l’Entity ID esattamente come indicato, senza barra finale. In Okta, questo campo si chiama Audience URI (SP Entity ID). Per gli attributi utente SAML, consulta le mappature degli attributi. Mantieni disponibili l’applicazione e il callback esistenti fino alla verifica del passaggio coordinato.

Istruzioni di attributo SAML

Scegli un identificatore non vuoto, stabile per la stessa persona tra gli accessi e diverso per ogni persona. Preferisci un identificatore di directory persistente, mai riassegnato e supportato dal provider. Può essere diverso dall’indirizzo e-mail. Per gli attributi utente SAML, consulta le mappature degli attributi.

Ambiti e attestazioni di OpenID Connect

Se il tuo provider di identità chiede di quali ambiti OIDC ha bisogno Legora, abilita questi:
  • openid: richiesto per l’accesso OIDC.
  • profile: fornisce il nome dell’utente.
  • email: fornisce l’indirizzo e-mail di lavoro dell’utente.
Legora ha bisogno di un indirizzo e-mail dopo l’accesso. Nome e cognome sono consigliati. Non ti serve un ambito di gruppo. L’appartenenza all’organizzazione Legora controlla l’accesso e la sincronizzazione della directory viene configurata separatamente. Se il tuo provider di identità chiede un tipo di client, scegli un client OIDC standard con il flusso Authorization Code.

Connetti e testa

  1. In Existing connections, seleziona Move accanto a ciascuna connessione OIDC per trasferirla.
  2. Seleziona Esegui test su ciascuna connessione e accedi con il tuo provider di identità.
Per gli attributi utente SAML, consulta le mappature degli attributi.

Accesso con e-mail e password

Questa impostazione stabilisce se i membri possono accedere con e-mail e password dopo la migrazione. La scheda Email and password compare quando oggi i membri accedono con una password. Le modifiche si applicano subito alla nuova pagina di accesso e i membri continuano a usare la pagina di accesso attuale finché non completi la migrazione.
  • La tua organizzazione utilizza SSO: in Keep email-and-password sign-in after migration?, scegli Yes, keep email and password oppure No, use SSO only, quindi seleziona Save.
  • La tua organizzazione non utilizza SSO: seleziona Confirm per mantenere e-mail e password.
I membri che mantengono e-mail e password devono reimpostare la password la prima volta che usano la nuova pagina di accesso. Verifica: ogni connessione SSO attiva mostra Superato e la scheda Email and password mostra la tua scelta.

Passaggio 3: aggiorna gli URL di richiamata delle integrazioni

Questo passaggio consente alle integrazioni di riportare gli utenti a Legora dopo che si sono connessi. Aggiungi un nuovo URL di reindirizzamento nelle impostazioni di amministrazione di ciascuna integrazione.
Quando ti serve questo passaggio: la tua organizzazione utilizza iManage on-premises, SharePoint, Google Drive o Microsoft 365 con una propria app Entra. Il passaggio 3 nella pagina Migrazione dell’autenticazione elenca iManage on-premises, SharePoint e Google Drive quando devi aggiornarli. Microsoft 365 non è elencato lì, quindi controlla tu stesso la sua impostazione Entra app.
Aggiungi il nuovo URL come URI di reindirizzamento consentito. Mantieni al loro posto gli URL esistenti. Usa esattamente questi URL, anche se i tuoi utenti accedono dal tuo custom URL. Verifica: nel passaggio 3 della pagina Migrazione dell’autenticazione, seleziona Esegui test per ciascuna integrazione e completa l’accesso nella finestra pop-up. Ognuna mostra Superato. Se il browser blocca il pop-up, consenti i pop-up per Legora e riprova.

Passaggio 4: installa i componenti aggiuntivi Global di Word e Outlook

Questo passaggio prepara i componenti aggiuntivi Global di Word e Outlook, che sostituiscono i componenti aggiuntivi regionali. I componenti aggiuntivi regionali smettono di funzionare non appena completi la migrazione e i componenti aggiuntivi Global funzionano solo dopo.
Quando ti serve questo passaggio: la tua organizzazione utilizza il componente aggiuntivo Legora di Word o di Outlook. Distribuisci i componenti aggiuntivi Global prima di abilitare l’autenticazione globale nel passaggio 6.
I componenti aggiuntivi Global sono installazioni separate. Puoi installarli insieme ai componenti aggiuntivi regionali. Installarli non rimuove né modifica i componenti aggiuntivi regionali, quindi puoi distribuirli prima del passaggio 6. Gli utenti accedono ai componenti aggiuntivi Global dopo aver completato la migrazione. Mantieni installato il componente aggiuntivo regionale di Word finché gli utenti non hanno esportato le loro chat di Assistant. Scegli il metodo più adatto alla tua organizzazione: Le chat di Assistant in Word non vengono trasferite al Word Add-in Global. Informa gli utenti che possono esportarle dal Word Add-in regionale. Vedi Cosa succede alle chat di Assistant e Agent? Verifica: dopo il passaggio 6, apri i componenti aggiuntivi Global in Word e Outlook ed esegui l’accesso.

Passaggio 5: aggiorna le regole del firewall

Questo passaggio consente alla tua rete di raggiungere i servizi di accesso globali. Applica le regole al traffico in uscita e, dove la configurazione di rete, proxy o firewall lo richiede, al traffico in entrata.
Quando ti serve questo passaggio: la tua rete, il proxy o il firewall limita il traffico verso Legora.
Consenti HTTPS (TCP 443) verso questi domini:
  • Il tuo custom URL del passaggio 1, ad esempio https://acme.app.legora.com
  • https://app.legora.com
  • https://login.legora.com
  • https://identity.legora.com
  • https://token.legora.com
  • https://sso.legora.com, se usi SSO
  • https://auth.legora.com
  • https://word-addin.legora.com, per il Word Add-in Global
  • https://outlook-addin.legora.com, per l’Outlook Add-in Global
Il tuo custom URL è l’unico dominio specifico della tua organizzazione. Gli altri sono gli stessi per ogni organizzazione. Continua a consentire i domini regionali di Legora, ad esempio auth.eu.legora.com. Per l’elenco completo, vedi Requisiti di rete e dominio di Legora. Verifica: da un dispositivo della rete aziendale, apri il tuo custom URL ed esegui l’accesso. Poi chiedi a un piccolo gruppo di utenti di fare lo stesso e conferma che il loro lavoro abituale, integrazioni incluse, funziona ancora. Puoi anche aprire connectivity.legora.com dalla rete aziendale. La pagina controlla i domini di accesso globali e crea un report che puoi inviare a support@legora.com.

Passaggio 6: abilita l’autenticazione globale

Questo passaggio fa passare l’intera organizzazione all’autenticazione globale. Non puoi annullarlo, quindi pianificalo al di fuori dell’orario di lavoro e avvisa prima i tuoi utenti.
Quando ti serve questo passaggio: sempre, dopo aver completato i passaggi che si applicano a te.
  1. Seleziona il tuo custom URL per aprire la nuova pagina di accesso in una nuova scheda. Accedi per verificare che la configurazione del passaggio 2 funzioni. I membri continuano a usare la pagina di accesso attuale finché non completi la migrazione.
  2. Se la tua organizzazione richiede l’autenticazione a due fattori, scegli Transfer MFA settings per mantenere il requisito, oppure Skip transfer.
  3. Seleziona Completa la migrazione.
Completa la migrazione resta non disponibile finché non sono soddisfatte tutte queste condizioni. La sua descrizione indica cosa manca ancora.
  • Il custom URL è impostato.
  • Ogni connessione SSO attiva mostra Superato.
  • Almeno un metodo di accesso è attivo e l’impostazione di e-mail e password è salvata.
  • Hai fatto una scelta sull’MFA, se la tua organizzazione richiede l’autenticazione a due fattori.
I controlli delle integrazioni del passaggio 3 non bloccano Completa la migrazione. Eseguili comunque prima di completare la migrazione, per confermare che le tue integrazioni continuino a funzionare.

Cosa succede quando completi la migrazione

La modifica si applica a tutti i membri della tua organizzazione contemporaneamente:
  • Gli utenti restano connessi. Nessuno viene disconnesso quando completi la migrazione.
  • Gli utenti SSO continuano ad accedere tramite SSO e non notano alcuna differenza.
  • Gli utenti con e-mail e password impostano una password al successivo accesso. Legora invia loro un’e-mail con un codice da Reimposta la tua password Legora e la nuova password deve contenere almeno 15 caratteri. Per i passaggi utente, vedi Perché non riesco ad accedere a Legora?.
  • Autenticazione a due fattori: se hai trasferito le impostazioni MFA, i membri configurano di nuovo l’autenticazione a due fattori dopo la migrazione.
  • URL regionali: gli utenti che aprono un URL regionale di Legora mentre sono connessi vengono inoltrati al tuo custom URL.
  • Componenti aggiuntivi: i componenti aggiuntivi regionali di Word e Outlook smettono di funzionare e chiedono agli utenti di passare a quelli Global. Se non hai ancora distribuito i componenti aggiuntivi Global del passaggio 4, distribuiscili ora.
  • Impostazioni: la pagina Migrazione dell’autenticazione viene rimossa. Gestisci l’accesso da Impostazioni > Persone > Autenticazione. Vedi Come posso gestire l’autenticazione per la mia organizzazione?.
  • Profilo: nella pagina Impostazioni > Personale > Profilo di ogni membro, Accesso in Accesso all’area di lavoro mostra Globale. Usala per confermare che la migrazione è stata applicata.
Condividi il tuo custom URL con gli utenti in modo che ci arrivino direttamente.

Domande frequenti

Queste risposte riguardano le domande più comuni di amministratori e utenti durante e dopo la migrazione.

La migrazione è obbligatoria?

Sì. Tutte le organizzazioni Legora passano all’autenticazione globale. Con un unico sistema di accesso, Legora mantiene l’accesso sicuro in un solo punto. Le nuove funzionalità che richiedono l’accesso si basano sull’autenticazione globale.

Cambia qualcos’altro per i nostri utenti?

Gli utenti mantengono i loro progetti, documenti e chat di Agent. La migrazione cambia il modo in cui gli utenti accedono e i componenti aggiuntivi di Word e Outlook che usano. Per le chat di Assistant in Word, vedi Cosa succede alle chat di Assistant e Agent? Per ciò che vedono gli utenti al passaggio, vedi Cosa succede quando completi la migrazione.

“Globale” significa che i nostri dati si spostano in un’altra area?

No. I dati della tua organizzazione restano nell’area in cui Legora li archivia oggi. L’autenticazione globale cambia il modo in cui i membri accedono e l’indirizzo che usano. Legora invia le richieste dal tuo URL personalizzato all’area attuale della tua organizzazione. Il servizio di accesso conserva anche i dati dell’account che usa per riconoscere i membri. Per ogni membro sono il nome, l’indirizzo e-mail, l’appartenenza all’organizzazione e il ruolo. Conserva anche la modalità di accesso: una password o l’accesso Single Sign-On, l’autenticazione a più fattori e le sessioni di accesso. Per l’organizzazione conserva le impostazioni di accesso, inclusa la connessione SSO e i domini e-mail accettati. Non conserva documenti, progetti o chat.

Posso completare la migrazione prima di distribuire i componenti aggiuntivi Global?

Sì. Completa la migrazione non controlla i componenti aggiuntivi. Se completi prima la migrazione, i componenti aggiuntivi regionali di Word e Outlook smettono di funzionare e Legora chiede agli utenti di installare i componenti aggiuntivi Global. Legora nel browser continua a funzionare. Per i passaggi di installazione, vedi Come installo il Word Add-in? e Installare l’Outlook Add-in per gli utenti.

Come accedono gli utenti all’app mobile?

Dopo la migrazione, gli utenti accedono di nuovo all’app mobile di Legora. Nella schermata di accesso, selezionano Globale come regione dei dati, quindi accedono con il loro metodo abituale. Vedi Domande frequenti sull’app mobile di Legora.

Cosa succede alle chat di Assistant e Agent?

Le chat di Agent e le chat di Assistant in Outlook sono archiviate in Legora, quindi restano disponibili nei componenti aggiuntivi Global. Gli utenti non devono fare nulla. Le chat di Assistant in Word, inclusi i risultati di Playbook, sono memorizzate nel Word Add-in regionale e non vengono trasferite. Gli utenti possono esportarle dal Word Add-in regionale e importarle nel Word Add-in Global. Il componente aggiuntivo regionale offre ancora Esporta ora dopo la migrazione. Vedi Come spostare la cronologia Word Add-in Assistant nel componente aggiuntivo globale.

Possiamo ancora invitare altri clienti Legora nel nostro Portal?

Sì, una volta che entrambe le organizzazioni utilizzano l’autenticazione globale. Fino ad allora, gli inviti al Portal rivolti a un altro cliente Legora non funzionano. Gli inviti a clienti che non utilizzano Legora non sono interessati.

Posso annullare la migrazione?

No. Dopo che selezioni Completa la migrazione, la tua organizzazione resta sull’autenticazione globale e non puoi modificare il custom URL.

Devo migrare tutte le mie organizzazioni Legora contemporaneamente?

No. Esegui la migrazione di ciascuna organizzazione dalla sua pagina Migrazione dell’autenticazione, quando è pronta.

Perché https://sso.legora.com mostra «404 Not Found»?

sso.legora.com è un servizio di accesso, non un sito web, quindi il suo indirizzo root mostra 404 Not Found per progettazione. SSO funziona comunque. Usa gli URL di richiamata completi del passaggio 2 ed esegui il test con Esegui test.

Perché il test di una connessione SAML non riesce?

Per gli attributi utente SAML, consulta le mappature degli attributi.

Perché Completa la migrazione non è disponibile?

Controlla la descrizione sotto Completa la migrazione. Indica cosa manca: un custom URL, un test di connessione SSO non superato, le impostazioni di accesso o una scelta sull’MFA. Dopo aver corretto la configurazione, esegui di nuovo ogni test che mostra Failed o Not tested.