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.

  • Se l'utilizzo di SSO è obbligatorio (l'opzione Enforce SSO (not applied to access from localhost) è abilitata nella pagina Admin – Settings – Authentication dell'interfaccia browser), agli utenti verrà presentata la pagina di accesso SSO subito dopo aver aperto l'indirizzo di Enterprise Server.

  • L'accesso SSO può essere utilizzato anche quando ci si connette al Workspace di Enterprise Server da Altium Designer. Per ulteriori informazioni, consulta la pagina Accesso al Workspace.

     
     

    Quando EDMS.UnifiedLogin passa allo stato Public, aggiorna il paragrafo seguente con il codice sorgente dello snippet 'La funzionalità Open Beta passa allo stato Public'.

    Nota che, per poter utilizzare la funzionalità di accesso SSO in Altium Designer, è necessario adottare l'approccio di «accesso unificato» per connettersi al Workspace di Enterprise Server tramite un browser esterno. Questa funzionalità è in Open Beta ed è disponibile quando l'opzione EDMS.UnifiedLogin è abilitata nella finestra di dialogo Impostazioni avanzate di Altium Designer.

Per ulteriori informazioni sull'accesso all'interfaccia browser di Enterprise Server, consulta la pagina Esplorazione dell'interfaccia basata su browser.

Quando si utilizza un provider di identità interno, Enterprise Server deve considerare attendibile il certificato HTTPS utilizzato da tale provider. In caso contrario, verrà visualizzato un errore quando si tenta di stabilire una connessione al provider da Enterprise Server. I provider di identità dei principali fornitori (Okta, Entra ID, ecc.) dispongono per impostazione predefinita di certificati attendibili appropriati.

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.

  • Se SSO viene successivamente disabilitato, manualmente o in seguito a una modifica della configurazione, il pulsante  Fai clic e trascina per spostare​ diventa disponibile per consentire di ripetere il test.

  • Se necessario, il campo Entity ID nelle impostazioni Altium Metadata Configuration può essere modificato (ad esempio, per risolvere un'ambiguità tra due istanze del server).

  • Quando configuri SSO, assicurati che il nome utente fornito dal provider di identità corrisponda esattamente al Username dell'utente esistente corrispondente in Enterprise Server (indipendentemente dal fatto che l'utente sia configurato per utilizzare l'autenticazione Built-in o Windows). La corrispondenza dei nomi utente distingue tra maiuscole e minuscole.

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à.

Espandi la sezione comprimibile di seguito per un esempio passo passo del processo di integrazione con Okta come provider di identità.

Espandi la sezione comprimibile qui sotto per un esempio passo passo del processo di integrazione di Microsoft Entra ID come provider di identità.

Espandi la sezione comprimibile qui sotto per un esempio passo passo del processo di integrazione di JumpCloud come provider di identità.

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à.

Espandi la sezione comprimibile qui sotto per un esempio passo passo del processo di integrazione con AWS IAM Identity Center come provider di identità:

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.

Se SSO viene successivamente disabilitato, manualmente o in seguito a una modifica della configurazione, il pulsante  diventa disponibile per consentire di ripetere il test.

Quando utilizzi Entra ID, tieni presente che fornisce due versioni API per gli endpoint OAuth:

  • https://login.microsoftonline.com/{tenantId}/.well-known/openid-configuration

  • https://login.microsoftonline.com/{tenantId}/v2.0/.well-known/openid-configuration

Dovrai ottenere il set corretto di endpoint (token/authorize/userinfo) da una di queste varianti. Combinare endpoint di varianti diverse causerà un errore durante il tentativo di stabilire una connessione a Entra ID da Enterprise Server.

AI-LocalizedLocalizzato tramite A
Se trovi un problema, seleziona il testo/l’immagine e premi Ctrl + Enter per inviarci il tuo feedback.
Contents
Contents