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 attributoid 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.- Dal tuo nome nel menu, seleziona Settings. In People, seleziona Authentication.
- In SSO, seleziona Add, quindi SAML, ADFS o PingFederate.
- Inserisci un Connection name e seleziona Continue.
- 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 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:
- Microsoft Entra ID
- Okta
- PingFederate
Aggiungi claim SAML specifici dell’applicazione. Usa i nomi degli attributi della tabella con Namespace vuoto e verifica che
user.mail contenga un valore.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.
Alias degli attributi standard
Alias degli attributi standard
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.- Inserisci la Metadata URL, oppure Entity ID, Sign-In Endpoint URL e Signing Certificate (PEM) del provider di identità.
- Seleziona Complete setup.
- 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 diid 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.
- 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.
- Seleziona Test connection e accedi come prima persona.
- 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
ide gli altri campi identificatore, inclusiNameIDall’interno diSubjecte l’attributo standardnameidentifier. - Avvia un nuovo accesso con la stessa persona. L’identificatore deve rimanere uguale.
- 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.
- Per la nuova connessione, attiva Status per gli accessi controllati indicati di seguito. Mantieni Auto-provision disattivato.
- 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.
- 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.