Skip to main content
Questo articolo è stato tradotto automaticamente.

Panoramica

Collega il provider di identità SAML 2.0 per consentire ai membri di accedere a Legora con le credenziali di lavoro. I passaggi valgono per SAML, ADFS e PingFederate, incluse le applicazioni aziendali Entra configurate per SAML. L’opzione Entra ID usa OpenID Connect.

Prerequisiti

L’organizzazione deve usare l’autenticazione globale di Legora. Servono Manage authentication security in Legora e l’accesso amministratore al provider di identità. Consulta Gestire l’autenticazione.

Come funziona

Legora riserva i dati del service provider per ogni nuova connessione SAML. Registrali nel provider di identità, quindi importa i metadati di quell’applicazione in Legora. Legora riceve l’asserzione all’URL Assertion Consumer Service (ACS). L’Entity ID (Identifier) del service provider identifica la connessione Legora. L’Entity ID del provider di identità identifica l’emittente. Per le nuove connessioni, invia un attributo id con un valore stabile e univoco per ogni persona.

Configurare la connessione

Inizia da Legora. Mantieni invariate le connessioni funzionanti e le relative mappature degli identificatori mentre prepari la nuova connessione.

Iniziare da Legora

Riserva prima la connessione.
  1. Dal tuo nome nel menu, seleziona Settings. In People, seleziona Authentication.
  2. In SSO, seleziona Add, quindi SAML, ADFS o PingFederate.
  3. Inserisci un Connection name e seleziona Continue.
  4. Copia Entity ID (Identifier) e ACS URL (Reply URL). Puoi riprendere la configurazione in seguito.

Configurare il provider di identità

Crea un’applicazione SAML. Copia Entity ID (Identifier) in Entity ID, Audience URI o Identifier e ACS URL (Reply URL) in ACS URL, Single Sign-On URL o Reply URL. Copia i valori completi mostrati per la connessione. Non aggiungere né rimuovere la barra finale. In Okta, il campo Identifier si chiama Audience URI (SP Entity ID). Se il supporto Legora fornisce un link ai metadati del service provider, verifica che Entity ID e URL ACS corrispondano ai valori visualizzati. L’URL dei metadati del provider di identità descrive l’app da importare in Legora.

Mappare identificatori e attributi degli utenti

Mappa questi attributi SAML al record della persona nella directory:
Per una connessione SAML esistente, contatta il supporto Legora prima di aggiungere id o modificare origine, formato o mappatura di un identificatore. Un identificatore diverso può influire sull’accesso agli account esistenti, anche se gli indirizzi e-mail rimangono invariati. Mantieni la configurazione attuale finché non avrai concordato un piano di migrazione.
Per ogni nuova connessione SAML, aggiungi un attributo chiamato id e associalo all’identificatore di directory stabile e univoco della persona che accede. Configuralo esplicitamente invece di affidarti a NameID, a un altro attributo identificatore o a un valore di ripiego derivato dall’e-mail. Per una nuova applicazione, segui le istruzioni del provider per aggiungere questi attributi:
Aggiungi claim SAML specifici dell’applicazione. Usa i nomi degli attributi della tabella con Namespace vuoto e verifica che user.mail contenga un valore.
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. NameID è l’identificatore dell’utente nel Subject di una risposta SAML. È distinto dagli attributi della tabella sopra: un attributo esplicito id o nameidentifier può avere la precedenza su NameID. Controlla NameID e tutti gli attributi id o nameidentifier inviati. Devono identificare coerentemente la persona che accede. Evita testo fisso, ID del tenant o dell’applicazione, indirizzi condivisi, nomi visualizzati e valori generati a ogni accesso. Verifica che provider e connessione supportino il formato NameID. Gli identificatori basati sull’e-mail richiedono un piano per modifiche e riutilizzo degli indirizzi.
Le mappature esistenti possono usare questi alias standard con il prefisso:http://schemas.xmlsoap.org/ws/2005/05/identity/claims/

Completare la configurazione in Legora

Importa la configurazione dell’applicazione appena creata.
  1. Inserisci la Metadata URL, oppure Entity ID, Sign-In Endpoint URL e Signing Certificate (PEM) del provider di identità.
  2. Seleziona Complete setup.
  3. Per la nuova connessione, lascia Status e Auto-provision disattivati fino agli accessi completi e controllati indicati di seguito.

Verificare con due utenti di test

Accedi due volte come la stessa persona per verificare la stabilità dell’identificatore, poi come una seconda persona per verificare che gli identificatori siano diversi. Un accesso riuscito può comunque utilizzare un identificatore condiviso per errore. Test connection non mostra gli attributi SAML e non confronta gli utenti. Chiedi all’amministratore del provider di identità di controllare la risposta SAML inviata per ogni accesso di prova, usando il visualizzatore del provider o uno strumento di tracciamento SAML approvato dalla tua organizzazione. Se non puoi visualizzare questi valori, contatta il supporto Legora prima di attivare la connessione. Per una nuova connessione, verifica il valore esplicito di id in ciascuno dei test seguenti. Se manca o è vuoto, correggi la mappatura prima di attivare la connessione, anche se Test connection ha esito positivo. Per una connessione esistente, verifica la mappatura degli identificatori in uso senza modificarla.
  1. Assegna due persone distinte all’applicazione del provider di identità. Entrambe devono già essere membri della tua organizzazione Legora, ciascuna con un proprio record di directory e un’e-mail di lavoro. Per una nuova applicazione, limita l’accesso a queste persone fino al completamento della verifica.
  2. Seleziona Test connection e accedi come prima persona.
  3. Apri la risposta di quell’accesso nel visualizzatore di risposte del tuo provider di identità o in uno strumento di tracciamento SAML approvato dalla tua organizzazione. Controlla id e gli altri campi identificatore, inclusi NameID all’interno di Subject e l’attributo standard nameidentifier.
  4. Avvia un nuovo accesso con la stessa persona. L’identificatore deve rimanere uguale.
  5. Usa un profilo del browser separato o una sessione privata per la seconda persona. Il suo identificatore deve essere diverso. Verifica e-mail e nomi di entrambe.
  6. Per la nuova connessione, attiva Status per gli accessi controllati indicati di seguito. Mantieni Auto-provision disattivato.
  7. Prima del rilascio esteso o del provisioning automatico, organizza accessi completi e controllati a Legora per entrambe. Ognuna deve raggiungere il proprio account e l’organizzazione prevista. Ripeti l’accesso della prima persona. La finestra di test non controlla questi account.
  8. Dopo che entrambe le persone hanno superato questi controlli, estendi l’accesso all’applicazione del provider di identità come previsto. Attiva Auto-provision solo dopo aver confermato le assegnazioni e i domini e-mail previsti.
Se un identificatore cambia, le persone ne condividono uno o compare un account inatteso, interrompi il rilascio e contatta support@legora.com. Non inviare token, chiavi private o asserzioni grezze tramite e-mail o ticket.

Migrare una connessione esistente

Confronta gli identificatori attuali e proposti con il supporto Legora per stabilire se è necessaria una migrazione degli account. Prima di modificare la configurazione, concorda un’introduzione controllata, verifiche dell’accesso agli account esistenti per gli utenti che accedono nuovamente e un piano di ripristino. Migrazione all’autenticazione globale Prepara un’applicazione separata con i valori della nuova connessione. Mantieni l’app funzionante e il relativo callback condiviso o specifico fino alla verifica di un passaggio coordinato. Consulta la guida alla migrazione dell’autenticazione globale.

Risoluzione dei problemi

Confronta i valori mostrati per la connessione con la configurazione del provider di identità e le mappature degli attributi.

Reply URL o audience rifiutata

Copia esattamente Identifier e URL ACS della connessione. Il download riuscito dei metadati non conferma che entrambi corrispondano.

Profilo mancante o errato

Controlla i nomi degli attributi SAML e i valori per utente indicati sopra. Verifica che la persona abbia un’e-mail di lavoro e che venga inviata nell’attributo e-mail configurato. Importare i metadati non verifica gli attributi di una persona.

Account inatteso o identificatore variabile

Interrompi il rilascio e controlla le origini degli identificatori con il supporto prima di cambiare mappature esistenti. Se il problema persiste, contatta support@legora.com.