Condividi tramite

Esercitazione: Integrazione dell'accesso Single Sign-On (SSO) di Microsoft Entra con Nuclino

  • Articolo

In questa esercitazione si apprenderà come integrare Nuclino con Microsoft Entra ID. Integrando Nuclino con Microsoft Entra ID, è possibile:

  • Controllare in Microsoft Entra ID chi può accedere a Nuclino.
  • Abilitare gli utenti per l'accesso automatico a Nuclino con gli account Microsoft Entra personali.
  • Gestire gli account in un'unica posizione centrale.

Prerequisiti

Per iniziare, sono necessari gli elementi seguenti:

  • Una sottoscrizione di Microsoft Entra. Se non si possiede una sottoscrizione, è possibile ottenere un account gratuito.
  • Sottoscrizione di Nuclino abilitata per l'accesso Single Sign-On (SSO).

Descrizione dello scenario

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

  • Nuclino supporta l'accesso SSO avviato da SP e IDP .
  • Nuclino supporta il provisioning utenti JIT .

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

  1. Accedere all'Interfaccia di amministrazione di Microsoft Entra almeno come Amministratore applicazione cloud.
  2. Passare a Identità>Applicazioni>Applicazioni aziendali>Nuova applicazione.
  3. Nella sezione Aggiungi dalla raccolta digitare Nuclino nella casella di ricerca.
  4. Selezionare Nuclino nel pannello dei risultati e quindi aggiungere l'app. Attendere alcuni secondi che l'app venga aggiunta al tenant.

In alternativa, è anche possibile usare Configurazione guidata app aziendali. In questa procedura guidata è possibile aggiungere un'applicazione al tenant, aggiungere utenti/gruppi all'app, assegnare ruoli, nonché esaminare la configurazione dell'accesso SSO. Altre informazioni sulle procedure guidate di Microsoft 365.

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

Configurare e testare l'accesso SSO di Microsoft Entra con Nuclino 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 Nuclino.

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

  1. Configurare l'accesso Single Sign-On di Microsoft Entra 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 test di Microsoft Entra per abilitare B.Simon all'uso dell'accesso Single Sign-On di Microsoft Entra.
  2. Configurare l'accesso Single Sign-On di Nuclino: per configurare le impostazioni di Single Sign-On sul lato applicazione.
    1. Creare l'utente di test di Nuclino: per avere una controparte di B.Simon in Nuclino collegata alla rappresentazione dell'utente in Microsoft Entra.
  3. Testare l'accesso Single Sign-On: per verificare se la configurazione funziona.

Configurare l'accesso Single Sign-On di Microsoft Entra

Seguire questa procedura per abilitare l'accesso Single Sign-On di Microsoft Entra.

  1. Accedere all'Interfaccia di amministrazione di Microsoft Entra almeno come Amministratore applicazione cloud.

  2. Passare ad Applicazioni di identità>Applicazioni>aziendali>Nuclino>Single Sign-On.

  3. Nella pagina Selezionare un metodo di accesso Single Sign-On selezionare SAML.

  4. Nella pagina Configura l'accesso Single Sign-On con SAML fare clic sull'icona della matita per modificare le impostazioni di Configurazione SAML di base.

    Modificare la configurazione SAML di base

  5. Nella sezione Configurazione SAML di base seguire questa procedura se si vuole configurare l'applicazione in modalità avviata da IDP:

    a. Nella casella di testo Identificatore digitare un URL nel formato seguente: https://api.nuclino.com/api/sso/<UNIQUE-ID>/metadata

    b. Nella casella di testo URL di risposta digitare un URL nel formato seguente: https://api.nuclino.com/api/sso/<UNIQUE-ID>/acs

    Nota

    Questi non sono i valori reali. aggiornarli con l'identificatore e URL di risposta effettivi dalla sezione di autenticazione, come descritto più avanti in questa esercitazione.

  6. Fare clic su Impostare URL aggiuntivi e seguire questa procedura se si vuole configurare l'applicazione in modalità avviata da SP:

    Nella casella di testo URL accesso digitare un URL nel formato seguente: https://app.nuclino.com/<UNIQUE-ID>/login

    Nota

    Poiché questi non sono i valori reali, aggiornarli con l'identificatore, l'URL di risposta e l'URL di accesso effettivi. Per ottenere questi valori contattare il team di supporto clienti di Nuclino. È anche possibile fare riferimento ai criteri di cui alla sezione Configurazione SAML di base.

  7. L'applicazione Nuclino prevede un formato specifico per le asserzioni SAML. È quindi necessario aggiungere mapping di attributi personalizzati alla configurazione degli attributi del token SAML. Lo screenshot seguente mostra l'elenco degli attributi predefiniti.

    image

  8. Oltre quelli elencati in precedenza, l'applicazione Nuclino prevede il passaggio di altri attributi nella risposta SAML. Tali attributi sono indicati di seguito. Anche questi attributi vengono prepopolati, ma è possibile esaminarli in base ai requisiti.

    Nome Attributo di origine
    first_name user.givenname
    last_name user.surname

  9. Nella sezione Certificato di firma SAML della pagina Configura l'accesso Single Sign-On con SAML individuare Certificato (Base64) e selezionare Scarica per scaricare il certificato e salvarlo nel computer.

    Collegamento di download del certificato

  10. Nella sezione Configura Nuclino copiare gli URL appropriati in base alle esigenze.

    Copiare gli URL di configurazione

Creare un utente di test di Microsoft Entra

In questa sezione verrà creato un utente di test di nome B.Simon.

  1. Accedere all'interfaccia di amministrazione di Microsoft Entra almeno come Amministratore utenti.
  2. Passare a Identità>Utenti>Tutti gli utenti.
  3. Selezionare Nuovo utente>Crea nuovo utente nella parte superiore della schermata.
  4. In Proprietà utente seguire questa procedura:
    1. Nel campo Nome visualizzato inserire B.Simon.
    2. Nel campo Nome entità utente, immettere username@companydomain.extension. Ad esempio: B.Simon@contoso.com.
    3. Selezionare la casella di controllo Mostra password e quindi prendere nota del valore visualizzato nella casella Password.
    4. Selezionare Rivedi e crea.
  5. Seleziona Crea.

Assegnare l'utente di test di Microsoft Entra

In questa sezione si abiliterà B.Simon all'uso dell'accesso Single Sign-On concedendole l'accesso a Nuclino.

  1. Accedere all'Interfaccia di amministrazione di Microsoft Entra almeno come Amministratore applicazione cloud.
  2. Passare ad Applicazioni di identità>Applicazioni>aziendali>Nuclino.
  3. Nella pagina di panoramica dell'app trovare la sezione Gestione e selezionare Utenti e gruppi.
  4. Selezionare Aggiungi utente e quindi Utenti e gruppi nella finestra di dialogo Aggiungi assegnazione.
  5. Nella finestra di dialogo Utenti e gruppi selezionare B.Simon dall'elenco degli utenti e quindi fare clic sul pulsante Seleziona nella parte inferiore della schermata.
  6. Se si prevede un valore di ruolo nell'asserzione SAML, nella finestra di dialogo Selezionare un ruolo selezionare il ruolo appropriato per l'utente dall'elenco e quindi fare clic sul pulsante Seleziona nella parte inferiore della schermata.
  7. Nella finestra di dialogo Aggiungi assegnazione fare clic sul pulsante Assegna.

Configurare l'accesso Single Sign-On di Nuclino

  1. In un'altra finestra del Web browser accedere al sito aziendale di Nuclino come amministratore

  2. Fare clic su ICONA.

    Screenshot che mostra l'icona

  3. Fare clic su Microsoft Entra SSO e selezionare Team settings (Impostazioni team) nell'elenco a discesa.

  4. Selezionare Autenticazione nel riquadro di spostamento a sinistra.

  5. Nella sezione Autenticazione seguire questa procedura:

    Configurazione di Nuclino

    a. Selezionare Accesso Single Sign-On basato su SAML.

    b. Copiare l'URL ACS (è necessario copiare e incollare questo valore nel provider SSO) e incollarlo nella casella di testo URL di risposta della sezione Configurazione SAML di base.

    c. Copiare l'ID entità (è necessario copiare e incollare il valore nel provider SSO) e incollarlo nella casella di testo Identificatore della sezione Configurazione SAML di base.

    d. Nella casella di testo URL SSO, incollare il valore dell’ URL di accesso copiato in precedenza.

    e. Nella casella di testo ID entità incollare il valore Identificatore Microsoft Entra copiato in precedenza.

    f. Aprire il file del certificato (Base64) scaricato nel blocco note. Copiare il contenuto negli Appunti e quindi incollarlo nella casella di testo Certificato pubblico.

    g. Fare clic su SAVE CHANGES (Salva modifiche).

Creare un utente di test di Nuclino

In questa sezione viene creato un utente di nome B.Simon in Nuclino. Nuclino supporta il provisioning JIT, che è abilitato per impostazione predefinita. Non è necessario alcun intervento dell'utente in questa sezione. Se non esiste già un utente in Nuclino, ne viene creato uno nuovo dopo l'autenticazione.

Nota

Se è necessario creare un utente manualmente, contattare il team di supporto di Nuclino.

Testare l'accesso 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 Test this application (Testa questa applicazione), verrà eseguito il reindirizzamento all'URL di accesso di Nuclino in cui è possibile avviare il flusso di accesso.

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

Avviato da IDP:

  • Fare clic su Test this application (Testa questa applicazione) e si dovrebbe accedere automaticamente all'istanza di Nuclino per cui si è configurato l'accesso SSO.

È anche possibile usare App personali Microsoft per testare l'applicazione in qualsiasi modalità. Quando si fa clic sul riquadro di Nuclino nella App personali, se è stato configurato in modalità SP, si dovrebbe essere reindirizzati alla pagina di accesso dell'applicazione per avviare il flusso di accesso e, se configurato in modalità IDP, si dovrebbe accedere automaticamente all'istanza di Nuclino per cui si è configurato l'accesso SSO. Per altre informazioni su App personali, vedere l'introduzione ad App personali.

Passaggi successivi

Dopo aver configurato Nuclino, è 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 costituisce un'estensione dell'accesso condizionale. Informazioni su come applicare il controllo della sessione con Microsoft Defender for Cloud Apps.