Questo articolo fornisce i passaggi necessari per configurare l'autenticazione SAML 2.0 Single Sign-On (SSO) in EloView 4 (EV4) utilizzando il provider di identità (IdP) della tua organizzazione.
Il Security Assertion Markup Language (SAML) è uno standard aperto che consente agli utenti di accedere a EloView in modo sicuro utilizzando le credenziali di un altro sistema di fiducia. Invece di mantenere un nome utente e una password separati per EloView, gli utenti si autenticano tramite il provider di identità centralizzato della tua organizzazione.
Utilizzare SAML offre diversi vantaggi:
- Sicurezza Migliorata: Si basa sulla gestione centralizzata dell'identità e sull'autenticazione a più fattori (MFA).
- Accesso Utente Semplificato: Migliora l'efficienza del flusso di lavoro con il Single Sign-On (SSO).
- Overhead Ridotto: Non è necessario che gli utenti gestiscano, ruotino o ricordino separatamente le password di EloView.
- Provisioning Automatizzato: Assegna i ruoli appropriati dinamicamente in base alle mappature di configurazione dell'IdP.
Indice
- Prima di Iniziare
- Passo 1: Accedere alle Impostazioni SAML in EloView 4
- Passo 2: Ottenere i Valori di Configurazione SAML di EloView
- Passo 3: Configurare il Tuo Provider di Identità
- Passo 4: Configurare le Mappature degli Attributi SAML Richieste
- Passo 5: Configurare i Metadati del Provider di Identità in EloView
- Passo 6: Assegnare gli Utenti e Testare l'Autenticazione
- Opzionale: Configurare il Logout Singolo (SLO)
- Migrazione di una Configurazione SAML Legacy Esistente
- Risoluzione dei Problemi di Autenticazione SAML
- Token API per Accessi SSO (SAML)
Prima di Iniziare
Per configurare l'autenticazione SAML, assicurati di avere quanto segue:
- Accesso come amministratore al tuo account EloView 4.
- Accesso come amministratore al provider di identità (IdP) della tua organizzazione.
- Permessi per creare o modificare le applicazioni SAML all'interno del tuo provider di identità.
- L'ID dell'organizzazione di EloView appropriato e gli ID dei ruoli assegnati agli utenti che si autenticheranno.
Passo 1: Accedere alle Impostazioni SAML in EloView 4
Per accedere e abilitare il pannello delle impostazioni SAML:
- Accedi al Portale Cloud di EloView.
- Clicca sul menu a discesa del profilo utente nell'angolo in alto a destra e seleziona Account.
-
Clicca sull'icona a ingranaggio nell'area in alto a destra per aprire la pagina delle Impostazioni dell'Account.
-
Seleziona la scheda SAML nel pannello di navigazione a sinistra e clicca su Modifica.
-
Abilita l'interruttore Accesso solo tramite SAML per visualizzare il modulo di configurazione SAML.
Passo 2: Ottenere i Valori di Configurazione SAML di EloView
Una volta che il modulo SAML è visibile, devi registrare o copiare diversi parametri del fornitore di servizi (SP) da EloView da utilizzare durante la configurazione dell'applicazione nel tuo provider di identità (IdP):
- URL ACS (Consumer): L'endpoint dove il tuo provider di identità invia le asserzioni SAML dopo che un utente ha effettuato correttamente l'accesso.
- Validatore URL ACS (Consumer): L'endpoint di validazione per le asserzioni.
- Pubblico (Entity ID): L'identificatore unico per il fornitore di servizi EloView nel tuo processo di autenticazione SAML.
- URL di Login SAML: L'URL utilizzato per avviare l'autenticazione SSO direttamente con il provider di identità configurato.
- URL di Logout Singolo: L'endpoint utilizzato per gestire le azioni di logout coordinate.
Utilizza l'icona Copia blu accanto a ciascun campo per copiare questi valori in modo sicuro.
Passo 3: Configurare il Tuo Provider di Identità
Crea una nuova applicazione SAML 2.0 all'interno del provider di identità scelto. La mappatura generale tra i parametri di EloView e le impostazioni standard dell'IdP è la seguente:
| Impostazione del Provider di Identità | Valore di EloView |
|---|---|
| URL Single Sign-On / URL di Risposta | URL ACS (Consumer) |
| URI Pubblico / Identificatore / Entity ID | Pubblico |
| URL di Accesso / URL di Login | URL di Login SAML |
Microsoft Entra ID (Azure AD)
- Accedi al Portale Microsoft Azure.
- Naviga a Microsoft Entra ID → Applicazioni Aziendali.
- Seleziona Nuova Applicazione → Crea la tua applicazione (oppure utilizza il Toolkit SAML di Microsoft Entra).
- Apri la tua nuova applicazione, naviga a Single sign-on e seleziona SAML.
- Sotto Configurazione SAML di Base, inserisci:
- Identificatore (Entity ID): Il valore Pubblico copiato da EloView.
- URL di Risposta (Assertion Consumer Service URL): L'URL ACS (Consumer) copiato da EloView.
- URL di Accesso: L'URL di Login SAML copiato da EloView.
- Salva la configurazione.
- Sotto Attributi & Dichiarazioni, configura gli attributi richiesti da EloView descritti nel Passo 4.
- Sotto Certificati SAML, copia l'URL di Metadati della Federazione dell'App da utilizzare nel Passo 5.
Okta
- Accedi alla Dashboard dell'Amministratore Okta.
- Naviga a Applicazioni → Applicazioni → Crea Integrazione App.
- Seleziona SAML 2.0 come metodo di Accesso e clicca su Avanti.
- Inserisci un nome descrittivo per l'app e clicca su Avanti.
- Sotto Configura SAML, inserisci:
- URL Single Sign-On: L'URL ACS (Consumer) copiato da EloView.
- URI Pubblico (SP Entity ID): Il valore Pubblico copiato da EloView.
- Sotto Dichiarazioni di Attributo, aggiungi gli attributi richiesti da EloView descritti nel Passo 4.
- Completa la configurazione dell'applicazione.
- Apri la scheda Accesso dell'applicazione, individua il certificato attivo sotto Certificati di Firma SAML, clicca su Azioni e seleziona Visualizza Metadati IdP.
- Copia l'URL della pagina di metadati risultante da utilizzare nel Passo 5.
OneLogin
- Accedi alla Dashboard dell'Amministratore OneLogin.
- Naviga a Applicazioni → Aggiungi App, cerca e seleziona Connettore SAML Personalizzato (Avanzato).
- Fornisci un nome per l'applicazione e clicca su Salva.
- Nella pagina di Configurazione dell'applicazione, inserisci:
- URL ACS (Consumer): L'URL ACS (Consumer) copiato da EloView.
- Validatore URL ACS (Consumer): L'Validatore URL ACS (Consumer) copiato da EloView.
- Pubblico (EntityID): Il valore Pubblico copiato da EloView.
- URL di Login: L'URL di Login SAML copiato da EloView.
- Imposta l'Iniziatore SAML su Fornitore di Servizi e salva.
- Crea campi utente personalizzati per
elo_orgIdeelo_role. - Sotto la scheda Parametri, configura gli attributi personalizzati descritti nel Passo 4 e assicurati che siano inclusi nell'asserzione SAML.
- Assegna gli utenti appropriati all'applicazione e compila i valori richiesti per l'organizzazione e il ruolo.
- Ottieni l'URL dei metadati del provider di identità dalla pagina SSO dell'applicazione da utilizzare nel Passo 5.
Ping Identity / PingFederate
- Accedi alla tua Console di Amministrazione di Ping Identity.
- Naviga a Applicazioni e crea una nuova Applicazione SAML.
- Seleziona configurazione manuale e inserisci l'URL ACS e l'Pubblico (Entity ID) copiati da EloView.
- Apri le impostazioni di Mappatura degli Attributi dell'applicazione e aggiungi gli attributi richiesti descritti nel Passo 4.
- Per
elo_orgIdeelo_role, utilizza i valori specifici forniti da EloView. - Salva le mappature degli attributi e assicurati che l'applicazione sia abilitata.
- Individua e copia l'URL dei metadati del provider di identità nei dettagli di connessione dell'applicazione da utilizzare nel Passo 5.
Passo 4: Configurare le Mappature degli Attributi SAML Richieste
EloView utilizza gli attributi delle asserzioni SAML per verificare i profili degli utenti, autorizzare l'appartenenza all'organizzazione e assegnare dinamicamente permessi. Configura questi attributi nel tuo IdP:
| Nome Attributo | Descrizione | Mappatura/Sorgente / Note |
|---|---|---|
elo_orgId |
Identificatore dell'Organizzazione EloView | Copia il valore specifico dalla pagina di configurazione SAML sotto le Impostazioni dell'Account di EloView. |
elo_role |
ID del Ruolo di EloView assegnato all'utente | Deve usare l'ID del ruolo (non il nome visualizzato). Individua l'ID del Ruolo in EloView → Ruoli. |
firstName |
Nome di Battesimo dell'Utente | ad es. user.givenname / user.firstName
|
lastName |
Cognome dell'Utente | ad es. user.surname / user.lastName
|
email |
Indirizzo Email dell'Utente | ad es. user.email
|
Passo 5: Configurare i Metadati del Provider di Identità in EloView
EloView 4 sfrutta l'importazione diretta dei metadati per eliminare l'immissione manuale degli endpoint di accesso, degli endpoint di logout e dei certificati di sicurezza:
- Torna al tuo Portale EloView 4 nella schermata delle Impostazioni SAML.
- Assicurati di essere in modalità Modifica.
- Sul lato destro della pagina, scegli una di queste due opzioni di configurazione:
- Opzione A (Consigliata): Incolla il link dei Metadati SAML dal tuo Provider di Identità nel campo URL dei Metadati.
- Opzione B: Se il tuo Provider di Identità non offre un URL di metadati pubblico, scarica il file XML dei metadati localmente dal tuo IdP, clicca su Seleziona File sotto Documento dei Metadati e carica il file XML.
- Clicca su Applica / Salva per applicare le configurazioni.
Passo 6: Assegnare gli Utenti e Testare l'Autenticazione
- Assicurati che gli utenti target siano assegnati all'applicazione SAML nel tuo Provider di Identità.
- Verifica che i valori di
elo_orgIdeelo_rolesiano configurati correttamente per gli utenti. - Copia l'URL di Login SAML dalla pagina di configurazione SAML di EloView.
- Apri una finestra di navigazione in incognito o privata e naviga all'URL copiato.
- Autenticati utilizzando le tue credenziali aziendali. Se la riuscita, verrai reindirizzato automaticamente e registrato nel Portale Cloud di EloView.
Opzionale: Configurare il Logout Singolo (SLO)
EloView 4 supporta un flusso di disconnessione dal provider di identità opzionale (Logout Singolo). Quando configurato, effettuare il logout da EloView può coordinare la terminazione sicura della sessione con il tuo provider di identità aziendale.
- Naviga a Account → Impostazioni dell'Account → SAML.
- Clicca su Modifica.
- Spunta la casella per Abilitare il flusso di disconnessione IdP.
- Clicca su Salva.
- Completa eventuali configurazioni di logout aggiuntive o registra i certificati del Fornitore di Servizi (disponibili nella pagina delle impostazioni SAML) all'interno del tuo Provider di Identità se necessario.
Migrazione di una Configurazione SAML Legacy Esistente
EloView 4 supporta l'aggiornamento delle configurazioni SAML legacy al nuovo framework SAML personalizzato.
- Accedi a EloView 4 utilizzando un account amministratore.
- Naviga a Account → Impostazioni dell'Account → SAML.
- Sulla pagina SAML legacy, seleziona Aggiorna SAML.
- Conferma cliccando su Sì.
- Una volta che la configurazione legacy è stata cancellata, segui le istruzioni standard dal Passo 1 al Passo 6 sopra per ricostruire la tua integrazione.
Risoluzione dei Problemi di Autenticazione SAML
- Gli utenti non possono accedere: Verifica che l'applicazione SAML sia abilitata nel tuo IdP e che il Pubblico (Entity ID) e l'URL ACS corrispondano esattamente alle impostazioni di EloView. Controlla che l'URL dei Metadati o il Documento sia corretto e accessibile.
-
Permessi errati al momento del login: Verifica che l'attributo
elo_rolenel tuo IdP corrisponda all'unico ID del Ruolo alfanumerico copiato dal pannello Ruoli di EloView, non al nome visualizzato del ruolo. -
Utenti indirizzati alla giusta organizzazione: Controlla il valore
elo_orgId. Assicurati che le configurazioni multi-tenant nel tuo IdP mappino gli utenti all'organizzazione corretta. -
Gli attributi del profilo utente sono vuoti: Assicurati che gli attributi
firstName,lastNameeemailsiano configurati correttamente e siano sensibili al maiuscolo.
Token API per Accessi SSO (SAML)
Le organizzazioni che limitano l'accesso al login SSO/SAML potrebbero comunque richiedere l'autenticazione API per le integrazioni. EloView supporta token API che consentono l'accesso sicuro senza autenticazione con password utente.
Le credenziali client vengono generate dal profilo utente e utilizzate per creare token di autenticazione tramite l'API EloView DevZone.
Generare Credenziali OAuth
1. Naviga a Profilo Utente e clicca su Genera Credenziali OAuth per creare l'ID Client e il Segreto Client.
- Nota: Salva queste credenziali immediatamente. Non saranno più visibili dopo la conferma.
Generare un Token di Autenticazione
2. Vai alla pagina di Autenticazione API DevZone e inserisci l'ID Client e il Segreto Client nei campi appropriati per generare un token di autenticazione (valore authPayload).
Please report any broken links by emailing elo.support@zebra.com and include a link to the knowledge article