Configurazione dell’autenticazione Single Sign-on
Gli amministratori di Enterprise Server possono configurare e abilitare le funzionalità di Single Sign-On (SSO) per il server. Il sistema di configurazione backend consente agli amministratori di impostare, testare, abilitare e disabilitare la funzionalità SSO per gli utenti del server. L'opzione SSO è disponibile quando si accede all'interfaccia browser di Enterprise Server. Una volta configurato per gli utenti del server, SSO offre la comodità di accedere al server utilizzando le stesse credenziali impiegate per i sistemi aziendali.
Per ulteriori informazioni sull'accesso all'interfaccia browser di Enterprise Server, consulta la pagina Esplorazione dell'interfaccia basata su browser.
Single Sign-On SAML
Quando è configurato e abilitato in Enterprise Server, il sistema SSO stabilisce le identità autorizzate tramite il provider di identità (IdP) designato dall'azienda, ad esempio Okta, OneLogin, ecc., con comunicazioni di asserzione dell'identità basate sullo standard Security Assertion Markup Language (SAML 2.0). L'interfaccia di accesso SSO dell'azienda, se non è già disponibile, si basa solitamente su un modello o un esempio fornito dall'IdP: questo avvia gli scambi di asserzioni di autenticazione basati su SAML e fornisce l'accesso ai servizi aziendali.
Quando l'opzione SAML è selezionata nel menu a discesa SSO nella pagina Amministrazione – Impostazioni – Autenticazione dell'interfaccia browser, la pagina mostra gli URL preconfigurati per il servizio SSO di Enterprise Server (Altium Metadata Configuration) e l'opzione per caricare o inserire manualmente i dati di connessione per l'autorizzazione dell'IdP (SAML Identity Provider Configuration).
I metadati di configurazione dell'IdP dovrebbero essere disponibili presso il provider di identità una volta che è stato configurato per l'integrazione con i servizi aziendali; consulta gli esempi di integrazione con gli IdP riportati di seguito. Per configurare il sistema SSO SAML in Enterprise Server (se non è già stato fatto), utilizza il pulsante
per individuare e caricare il file XML di configurazione dell'IdP SAML generato dall'IdP aziendale. Il sistema analizza il file XML dell'IdP caricato per estrarre i campi di configurazione principali (X509 Certificate, URL Identity Provider Issuer e IdP Single Sign-On URL). In alternativa, aggiungi manualmente i singoli elementi della configurazione (certificato di sicurezza e URL) nei campi corrispondenti.
SSO non viene abilitato finché non viene eseguito un test di integrazione, avviato tramite il pulsante
. Questo verifica il processo di identificazione SSO e l'accesso SSO dell'azienda. Una volta testata con successo la configurazione, puoi salvare le impostazioni facendo clic sul pulsante
, applicandole così a Enterprise Server.
Esempi di integrazione con i provider di identità
Espandi la sezione comprimibile di seguito per un esempio passo passo del processo di integrazione con OneLogin come provider di identità.
Integrazione con OneLogin
-
Accedi a OneLogin come amministratore.
-
Seleziona Applications e poi Add Apps.
-
Cerca 'SAML' e seleziona l'opzione dell'applicazione IdP SAML Test Connector (Advanced).
-
Specifica un nome per l'applicazione (Display Name). Questo viene utilizzato solo per la visualizzazione.
-
Fai clic sul pulsante Save.
-
Copia le voci Entity ID e Single Sign-On URL (Assertion Consumer Service) dalla pagina Admin – Settings – Authentication dell'interfaccia browser di Enterprise Server nei campi specificati di seguito.
Nella configurazione dell'applicazione OneLogin:
-
Incolla il valore Entity ID (nome del provider di servizi) indicato sopra come URL Audience (EntityID).
-
Incolla il valore Single Sign-On URL (Assertion Consumer Service) indicato sopra come ACS (Consumer) URL Validator.
-
Incolla anche il valore Single Sign-On URL (Assertion Consumer Service) come ACS (Consumer) URL.
-
I campi RelayState, Recipient, Single Logout URL e Login URL possono essere lasciati vuoti.
-
-
Assicurati che l'opzione SAML nameID format sia impostata su Email e che SAML signature element sia impostato su Both. Fai clic sul pulsante Save per confermare le impostazioni.
-
Fai clic sul pulsante More Actions e poi sull'opzione di menu SAML Metadata per scaricare i metadati SAML del provider di identità come file XML.
-
Questo file di metadati verrà caricato nella pagina Admin – Settings – Authentication dell'interfaccia browser di Enterprise Server per configurare il servizio SSO OneLogin – vedi di seguito.
-
Se preferisci configurare manualmente il servizio SSO OneLogin in Enterprise Server, puoi trovare i parametri richiesti selezionando l'opzione di menu SSO nell'interfaccia dell'applicazione OneLogin.
-
-
I passaggi successivi consistono nell'aggiungere utenti e assegnare loro l'applicazione.
Espandi la sezione comprimibile di seguito per un esempio passo passo del processo di integrazione con Okta come provider di identità.
Integrazione con Okta
-
Accedi a Okta come amministratore.
-
Fai clic sul link/pulsante Admin e poi sul pulsante Add Application sotto l'azienda Applications.
-
Fai clic sul pulsante Create New App.
-
Seleziona SAML 2.0 come Sign-on method.
-
Specifica un App name. Serve solo per la visualizzazione.
-
Prendi nota delle voci Single Sign On URL (Assertion Consumer Service) e Entity ID nella pagina Admin – Settings – Authentication dell'interfaccia browser di Enterprise Server.
-
Copia e incolla la voce Single Sign-On URL di Enterprise Server nel campo Single sign on URL delle impostazioni SAML di Okta.
-
Copia e incolla la voce Entity ID di Enterprise Server nel campo Audience URI delle impostazioni SAML di Okta.
La voce Default RelayState non è obbligatoria.
-
Imposta i campi rimanenti come segue:
-
Il valore di Name ID format è
EmailAddress. -
Il valore di Application username è (Okta)
Email. -
Nella sezione ATTRIBUTE STATEMENTS, imposta il campo Name su:
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddresse Value su:user.email
-
-
Fai clic sul pulsante Next e seleziona l'opzione ..Okta customer adding an internal app.
-
Fai clic sul pulsante Finish.
-
Fai clic sul link Identity Provider metadata e salva il file XML dei metadati sul computer, oppure fai clic sul pulsante View Setup Instructions per le opzioni di configurazione manuale.
-
Nella sezione SAML Identity Provider configuration della pagina Admin – Settings – Authentication dell'interfaccia browser di Enterprise Server, carica il file XML dei metadati salvato oppure configura manualmente le singole sezioni – vedi sopra.
-
Espandi la sezione comprimibile qui sotto per un esempio passo passo del processo di integrazione di Microsoft Entra ID come provider di identità.
Integrazione con Microsoft Entra ID
-
Accedi al centro di amministrazione di Microsoft Entra.
-
Seleziona Identity e poi l'opzione Enterprise applications.
-
Crea la tua applicazione.
-
Seleziona Users and groups e poi Add user/group.
-
Seleziona Single sign-on, Step 1 e poi Edit.
-
Copia Entity ID e Single Sign-On URL dalla pagina Admin – Settings – Authentication dell'interfaccia browser di Enterprise Server. Incolla le stringhe copiate nei campi Entity ID e Assertion Consumer Service URL nell'area di configurazione SAML dell'app Microsoft Entra. Assicurati che le caselle Default siano selezionate per questi campi e poi salva la configurazione.
-
Scarica il file XML dei metadati di federazione creato.
-
Carica il file XML dei metadati di federazione nella pagina Admin – Settings – Authentication dell'interfaccia browser di Enterprise Server e poi verifica la connessione di integrazione SAML – vedi sopra.
Espandi la sezione comprimibile qui sotto per un esempio passo passo del processo di integrazione di JumpCloud come provider di identità.
Integrazione con JumpCloud
-
Nell'interfaccia di JumpCloud, seleziona SSO dall'albero di navigazione e poi il pulsante Add New Application nella pagina SSO.
-
Inserisci '
saml' nel campo di ricerca della finestra di configurazione per individuare e poi installare Custom SAML App. -
Assegna un nome alla tua istanza di Custom SAML App – in questo esempio, l'etichetta è
Altium. -
Passa alla scheda SSO nell'interfaccia di configurazione di JumpCloud e inserisci le impostazioni di entità/URL dalla pagina Admin – Settings – Authentication dell'interfaccia browser di Enterprise Server, come mostrato.
-
Inserisci l'endpoint JumpCloud IDP URL e abilita l'opzione Declare Redirect Endpoint.
-
Usa l'opzione Export Metadata per scaricare il file XML dei metadati SAML risultante.
-
Carica il file XML dei metadati nella pagina Admin – Settings – Authentication dell'interfaccia browser di Enterprise Server e poi verifica la connessione di integrazione SAML – vedi sopra.
Espandi la sezione comprimibile qui sotto per un esempio passo passo del processo di integrazione di Microsoft Administrative Domain Federated Services (AD FS) come provider di identità.
Integrazione con Microsoft AD FS
-
Apri l'applicazione AD FS Management (solitamente Start → Windows Administrative Tools → AD FS Management).
-
Vai a Relying Party Trusts e fai clic sull'opzione Add Relying Party Trust... (1).
-
Nella finestra popup, assicurati di selezionare Claims aware (2) e fai clic su Start (3).
-
Nel passaggio Select Data Source seleziona Enter data about the relying party manually (1) e fai clic su Next (2).
-
Specifica un nome visualizzato per la relazione di trust. In questo esempio viene utilizzato
AltiumLivecome nome visualizzato. -
A seconda della configurazione di sicurezza, puoi specificare un certificato facoltativo per la crittografia dei token. Ai fini di questa guida non ne utilizzeremo uno.
-
Nel passaggio Configure URL assicurati di selezionare l'opzione Enable support for the SAML 2.0 WebSSO protocol (1) e inserisci Single Sign-On URL, copiato dalla pagina Admin – Settings – Authentication dell'interfaccia browser di Enterprise Server, nel campo Relying party SAML 2.0 SSO service URL: (2). Fai clic su Next (3).
-
Nel passaggio Configure Identifiers inserisci un identificatore per questa relazione di trust nel campo di immissione (1). L'identificatore deve essere ricavato dalla voce Entity ID situata nell'area Altium Metadata Configuration della pagina Admin – Settings – Authentication dell'interfaccia browser di Enterprise Server. Assicurati di fare clic sul pulsante Add (2).
Il risultato dovrebbe essere simile a quello seguente. Fai clic su Next.
-
A seconda della configurazione di sicurezza, nel passaggio successivo puoi scegliere criteri facoltativi di controllo degli accessi. In questo esempio non selezioneremo criteri aggiuntivi e proseguiremo con l'opzione
Permit everyone. -
Controlla la configurazione e seleziona Next.
-
Non tutte le impostazioni sono disponibili durante la configurazione della relazione di trust. Per consentire l'utilizzo di
SHA-1come algoritmo hash sicuro, fai clic con il pulsante destro del mouse sul nome di Relying Party Trust appena aggiunto e seleziona Properties. -
Nella finestra delle proprietà seleziona la scheda Advanced (1) e imposta
SHA-1come algoritmo hash sicuro (2). Fai clic su OK per salvare le modifiche.
-
Torna alla finestra Gestione AD FS, seleziona la relazione di trust della relying party che hai aggiunto e seleziona l'opzione Edit Claim Issuance Policy....
-
Nella finestra Edit Claim Issuance Policy seleziona Add Rule...
-
Nel passaggio Choose Rule Type della procedura guidata assicurati che sia selezionato Send LDAP Attributes as Claims, quindi fai clic su Next.
-
Fornisci un Claim rule name (1), seleziona
Active Directorycome Attribute store (2) e seleziona un LDAP Attribute (3) dall'ID che contiene il nome utente dell'utente di Enterprise Server. Questo attributo deve essere mappato a Name ID nel Outgoing Claim Type (3). Fai clic su Finish (4). -
Assicurati che il criterio di emissione delle attestazioni sia salvato facendo clic su OK.
-
Scarica il file
FederationMetadata.xmldal server appropriato. -
Carica il file XML dei metadati nella pagina Admin – Settings – Authentication dell'interfaccia browser di Enterprise Server, quindi verifica la connessione di integrazione SAML – vedi sopra.
Espandi la sezione comprimibile qui sotto per un esempio passo passo del processo di integrazione con AWS IAM Identity Center come provider di identità:
Integrazione con AWS IAM Identity Center
-
Vai a IAM Identity Center e aggiungi un'applicazione SAML 2.0 personalizzata (Add Application).
-
Compila le impostazioni dell'URL dei metadati AWS con i dati della tua pagina SSO di Altium. Conferma le impostazioni con Submit.
-
Scarica il file dei metadati dall'area IAM Identity Center metadata.
-
Vai a Edit attribute mappings.
-
Specifica un attributo che conterrà il nome utente dell'utente di Enterprise Server e seleziona
unspecifiedper Format. -
Crea nuovi utenti in AWS e assegna l'applicazione agli utenti creati o a un gruppo.
-
Assicurati che gli stessi utenti siano presenti sia in Altium sia in IAM.
-
Carica il file XML dei metadati nella pagina Admin – Settings – Authentication dell'interfaccia browser di Enterprise Server, quindi verifica la connessione di integrazione SAML – vedi sopra.
Single Sign-On OAuth / OIDC
La funzionalità SSO per Enterprise Server può essere configurata anche utilizzando lo standard OAuth / OIDC. Quando viene selezionata l'opzione OAuth / OIDC nel menu a discesa SSO della pagina Amministrazione – Impostazioni – Autenticazione dell'interfaccia browser, la pagina consente di inserire i dati forniti dall'IdP scelto.
-
Application Credentials:
-
Client ID – l'ID dell'applicazione fornito dall'IdP.
-
Client Secret – il segreto dell'applicazione fornito dall'IdP.
-
-
Configuration:
-
Scopes to Request – gli ambiti definiscono il livello di accesso che l'applicazione richiede all'utente.
-
Authentication Endpoint – questo endpoint gestisce l'autenticazione e il consenso dell'utente. L'applicazione reindirizza gli utenti a questo endpoint per accedere e concedere le autorizzazioni.
-
Token Endpoint – questo endpoint viene utilizzato per scambiare un codice di autorizzazione o un token di aggiornamento con un token di accesso. Si tratta di una comunicazione sicura su un canale diretto tra l'applicazione e il server di autorizzazione.
-
User Profile Endpoint – questo endpoint recupera le informazioni del profilo utente (ad esempio nome ed e-mail) utilizzando un token di accesso. I dati restituiti dipendono dagli ambiti concessi durante l'autorizzazione.
-
-
Mappings – nel campo Mapped Attribute della tabella, inserisci l'attributo che verrà mappato al nome utente dell'utente sul lato Enterprise Server.
SSO non viene abilitato finché non viene eseguito un test di integrazione, avviato tramite il pulsante
. Questo test verifica il processo di identificazione SSO e l'accesso SSO della tua azienda. Una volta completato correttamente il test della configurazione, puoi salvare le impostazioni facendo clic sul pulsante
, applicandole così a Enterprise Server.


)















































)