Condividi tramite

Integrazione di Microsoft Entra SSO con Onyxia

  • Articolo

In questo articolo si apprenderà come integrare Onyxia con Microsoft Entra ID. Integrando Onyxia con Microsoft Entra ID, è possibile:

  • Controllare in Microsoft Entra ID chi può accedere a Onyxia.
  • Consenti ai tuoi utenti di accedere automaticamente a Onyxia con i loro account Microsoft Entra.
  • Gestire gli account in un'unica posizione centrale.

Prerequisiti

Lo scenario descritto in questo articolo presuppone che siano già disponibili i prerequisiti seguenti:

  • Sottoscrizione abilitata all'accesso Single Sign-On (SSO) di Onyxia.

Descrizione dello scenario

In questo articolo viene configurato e testato l'accesso SSO di Microsoft Entra in un ambiente di test.

  • Onyxia supporta sia l'SSO avviato da SP che quello avviato da IDP.
  • Onyxia supporta il provisioning utenti Just In Time.

Nota

L'identificatore di questa applicazione è un valore stringa fisso, quindi è possibile configurare una sola istanza in un tenant.

Per configurare l'integrazione di Onyxia in Microsoft Entra ID, è necessario aggiungere Onyxia dalla raccolta al proprio elenco di app SaaS gestite.

  1. Accedi all'interfaccia di amministrazione di Microsoft Entra come almeno amministratore di applicazioni cloud.
  2. Passare a Identity>Applications>Enterprise applications>New application.
  3. Nella sezione Aggiungi dalla raccolta, digitare Onyxia nella casella di ricerca.
  4. Selezionare Onyxia nel pannello dei risultati e quindi aggiungere l'app. Attendere qualche secondo mentre l'app viene aggiunta al tenant.

In alternativa, è anche possibile usare Guida alla configurazione app aziendale. In questa procedura guidata è possibile aggiungere un'applicazione al tenant, aggiungere utenti/gruppi all'app, assegnare ruoli e seguire anche la configurazione dell'accesso SSO. Scopri di più sugli strumenti guidati di Microsoft 365.

Configurare e testare l'accesso Single Sign-On di Microsoft Entra per Onyxia

Configurare e testare l'accesso SSO di Microsoft Entra con Onyxia usando un utente di test di nome B.Simon. Per consentire il funzionamento dell'accesso Single Sign-On, è necessario stabilire una relazione di collegamento tra un utente di Microsoft Entra e l'utente correlato in Onyxia.

Per configurare e testare l'accesso SSO di Microsoft Entra con Onyxia, seguire questa procedura:

  1. Configurare Microsoft Entra SSO: per consentire agli utenti di usare questa funzionalità.
    1. Creare un utente di test di Microsoft Entra : per testare l'accesso Single Sign-On di Microsoft Entra con B.Simon.
    2. Assegnare l'utente di Microsoft Entra di test per consentire a B.Simon di usare l'autenticazione Single Sign-On di Microsoft Entra.
  2. Configure Onyxia SSO : per configurare le impostazioni di Single Sign-On sul lato applicazione.
    1. Creare un utente di test Onyxia - per avere un equivalente di B.Simon in Onyxia collegato alla rappresentazione dell'utente in Microsoft Entra.
  3. Testare SSO: per verificare se la configurazione funziona.

Configurare l’accesso unico di Microsoft Entra

Seguire questa procedura per abilitare Microsoft Entra SSO nell'interfaccia di amministrazione di Microsoft Entra.

  1. Accedi all'interfaccia di amministrazione di Microsoft Entra come almeno amministratore di applicazioni cloud.

  2. Passare a Identity>Applications>Enterprise applications>Onyxia>Autenticazione unica.

  3. Nella pagina Seleziona un metodo di accesso Single Sign-On, scegli SAML.

  4. Nella pagina Configura accesso Single Sign-On con SAML, clicca sull'icona a forma di matita per Configurazione SAML di base per modificare le impostazioni.

    Screenshot mostra come modificare la configurazione SAML di base.

  5. Nella sezione configurazione SAML di base l'applicazione è preconfigurata e gli URL necessari sono già precompilati con Microsoft Entra. L'utente deve salvare la configurazione facendo clic sul pulsante salva .

  6. Eseguire il passaggio seguente se si vuole configurare l'applicazione in SP modalità avviata:

    Nella casella di testo URL di accesso digitare l'URL: https://auth.onyxia.io/auth/saml/callback

  7. Nella pagina Configura Single Sign-On con SAML, nella sezione Certificato di firma SAML, trova Certificato (Base64) e seleziona Download per scaricare il certificato e salvarlo nel computer.

    Screenshot mostra il link per il download del Certificato.

  8. Nella sezione Configura Onyxia copiare gli URL appropriati in base alle esigenze.

    La schermata mostra come copiare gli URL di configurazione.

Creare un utente di test di Microsoft Entra

In questa sezione verrà creato un utente di test nell'interfaccia di amministrazione di Microsoft Entra di nome B.Simon.

  1. Effettua l'accesso al centro di amministrazione di Microsoft Entra come almeno un Amministratore di utenti.
  2. Passare a Identità>Utenti>Tutti gli utenti.
  3. Selezionare Nuovo utente>Crea nuovo utente, nella parte superiore della schermata.
  4. Nelle proprietà User seguire questa procedura:
    1. Nel campo Nome visualizzato immettere B.Simon.
    2. Nel campo nome principale utente, immettere il username@companydomain.extension. Ad esempio, B.Simon@contoso.com.
    3. Selezionare la casella di controllo Mostra password e quindi annotare il valore visualizzato nella casella Password.
    4. Selezionare Rivedere e creare.
  5. Selezionare Crea.

Assegnare l'utente di test di Microsoft Entra

In questa sezione abiliterai B.Simon all'uso di Microsoft Entra Single Sign-On concedendo a lui l'accesso a Onyxia.

  1. Accedi all'interfaccia di amministrazione di Microsoft Entra come almeno amministratore di applicazioni cloud.
  2. Accedi a Identity>Applications>Applicazioni aziendali>Onyxia.
  3. Nella pagina di panoramica della app selezionare Utenti e gruppi.
  4. Selezionare Aggiungiutente/gruppo, quindi selezionare Utenti e gruppi nella finestra di dialogo Aggiungi assegnazione.
    1. Nella finestra di dialogo utenti e gruppi selezionare B.Simon dall'elenco Utenti, quindi fare clic sul pulsante Seleziona nella parte inferiore della schermata.
    2. Se si prevede che un ruolo venga assegnato agli utenti, è possibile selezionarlo dall'elenco a discesa Selezionare un ruolo. Se non è stato configurato alcun ruolo per questa app, viene visualizzato il ruolo "Accesso predefinito" selezionato.
    3. Nella finestra di dialogo Aggiungi assegnazione, fare clic sul pulsante Assegna.

Configurare il Single Sign-On (SSO) di Onyxia

  1. Accedere al sito aziendale di Onyxia come amministratore.

  2. Passare a Impostazioni e fare clic su Impostazioni account.

    La screenshot mostra la navigazione alle impostazioni.

  3. Passare alla sezione SSO e fare clic su + Aggiungi nuova connessione.

    Screenshot mostra l'aggiunta di una nuova connessione.

  4. Nella sezione SSO Configuration seguire questa procedura:

    Screenshot mostra la configurazione.

    1. Nella casella di testo Nome di dominio immettere un nome di dominio valido.

    2. Nella casella di testo url SSO incollare l'URL di accesso copiato dall'interfaccia di amministrazione di Microsoft Entra.

    3. Aprire il certificato (Base64) scaricato nel Blocco note e incollare il contenuto nella casella di testo certificato pubblico.

    4. Copiare l'URL ACS e incollarlo nella casella di testo URL di risposta nella sezione Configurazione SAML di base nel centro di amministrazione di Microsoft Entra.

    5. Copiare il SP Entity ID e incollarlo nella casella di testo Identificatore (ID entità) nella sezione Configurazione SAML di Base dell'Interfaccia di Amministrazione di Microsoft Entra.

    6. Fare clic su + Crea.

Creare l'utente di test di Onyxia

In questa sezione viene creato un utente di nome Britta Simon in Onyxia. Onyxia supporta il provisioning degli utenti just-in-time, che è abilitato per impostazione predefinita. In questa sezione non è presente alcun elemento di azione. Se non esiste già un utente in Onyxia, ne viene creato uno nuovo dopo l'autenticazione.

Test SSO

In questa sezione viene testata la configurazione dell'accesso Single Sign-On di Microsoft Entra con le opzioni seguenti.

Avviato da SP:

  • Fare clic su Testare questa applicazione nell'interfaccia di amministrazione di Microsoft Entra. Verrà eseguito il reindirizzamento all'URL di accesso di Onyxia, in cui è possibile avviare il flusso di autenticazione.

  • Passare direttamente all'URL di accesso di Onyxia e avviare il flusso di accesso da questa posizione.

IDP avviato:

  • Fai clic su Prova questa applicazione nell'interfaccia di amministrazione di Microsoft Entra e verrai automaticamente connesso a Onyxia per cui hai configurato l'accesso SSO.

È anche possibile usare Microsoft My Apps per testare l'applicazione in qualsiasi modalità. Quando fai clic sul riquadro Onyxia in "Le mie app", se configurato in modalità SP (servizio provider), verrai reindirizzato alla pagina di accesso dell'applicazione per avviare il processo di autenticazione. Se configurato in modalità IDP (identity provider), accederai automaticamente all'istanza di Onyxia per cui hai impostato l'SSO. Per altre informazioni sulle app personali, vedere Introduzione alle app personali.

Contenuto correlato

Dopo aver configurato Onyxia, è possibile applicare il controllo sessione che consente di proteggere in tempo reale l'esfiltrazione e l'infiltrazione dei dati sensibili dell'organizzazione. Il controllo sessione si estende dall'accesso condizionale. Informazioni su come applicare il controllo sessione con Microsoft Defender for Cloud Apps.