Condividi tramite

Esercitazione: Integrazione di Microsoft Entra SSO con Cognidox

  • Articolo

In questa esercitazione si imparerà a integrare Cognidox con Microsoft Entra ID. Integrando Cognidox con Microsoft Entra ID, è possibile:

  • Controllare in Microsoft Entra ID chi ha accesso a Cognidox.
  • Abilitare i propri per l'accesso automatico a Cognidox con i loro account di Microsoft Entra.
  • 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 Cognidox abilitata per l'accesso Single Sign-On (SSO).

Descrizione dello scenario

In questa esercitazione si configura e si testa Microsoft Entra SSO in un ambiente di test.

  • Cognidox supporta l'accesso SSO avviato da SP e IDP.
  • Cognidox supporta il provisioning degli utenti just-in time.

Per configurare l'integrazione di Cognidox in Microsoft Entra ID è necessario aggiungere Cognidox dalla raccolta all'elenco delle 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 Cognidox nella casella di ricerca.
  4. Selezionare Cognidox nel riquadro 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. Ulteriori informazioni sulle procedure guidate di Microsoft 365.

Configurare e testare Microsoft Entra SSO per Cognidox

Configurare e testare Microsoft Entra SSO con Cognidox utilizzando un utente di test chiamato B.Simon. Affinché l'accesso SSO funzioni è necessario stabilire una relazione di collegamento tra un utente di Microsoft Entra e l'utente correlato in Cognidox.

Per configurare e testare Microsoft Entra SSO con Cognidox, procedere come segue:

  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 SSO per Cognidox SSO, per configurare le impostazioni dell'accesso Single Sign-On sul lato dell'applicazione.
    1. Creare un utente di test di Cognidox per avere in Cognidox una controparte di B.Simon 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 a Identità>Applicazioni>Applicazioni aziendali>Cognidox e nella pagina dell'integrazione delle applicazioni individuare la sezione Gestione quindi selezionare 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 valore seguendo questa struttura: urn:net.cdox.<YOURCOMPANY>

    b. Nella casella di testo URL di risposta digitare un URL nel formato seguente: https://<YOURCOMPANY>.cdox.net/auth/postResponse

  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://<YOURCOMPANY>.cdox.net/

    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 Cognidox. È anche possibile fare riferimento ai criteri di cui alla sezione Configurazione SAML di base.

  7. L'applicazione Cognidox 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. Fare clic su Modifica per aprire la finestra di dialogo Attributi utente.

    image

  8. Oltre a quelli elencati in precedenza, l'applicazione Cognidox prevede il passaggio di altri attributi nella risposta SAML. Nella sezione Attestazioni utente della finestra di dialogo Attributi utente eseguire la procedura seguente per aggiungere l'attributo del token SAML come illustrato nella tabella seguente:

    Nome Spazio dei nomi Trasformazione Parametro 1
    wanshort http://appinux.com/windowsaccountname2 ExtractMailPrefix() user.userprincipalname

    a. Fare clic su Aggiungi nuova attestazione per aprire la finestra di dialogo Gestisci attestazioni utente.

    b. Nella casella di testo Nome digitare il nome dell'attributo indicato per la riga.

    c. Nella casella di testo Spazio dei nomi digitare lo spazio dei nomi indicato per la riga.

    d. Per Origine selezionare Trasformazione.

    e. Nell'elenco Trasformazione digitare il valore indicato per la riga.

    f. Nell'elenco Parametro 1 digitare il valore indicato per la riga.

    g. Fare clic su Salva.

  9. Nella sezione Certificato di firma SAML della pagina Configura l'accesso Single Sign-On con SAML individuare il file XML dei metadati della federazione e selezionare Scarica per scaricare il certificato e salvarlo nel computer.

    Collegamento di download del certificato

  10. Nella sezione Configura Cognidox 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 dell'entità utente inserire 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 abilita l'utente B.Simon all'uso dell'accesso Single Sign-On concedendo l'accesso a Cognidox.

  1. Accedere all'Interfaccia di amministrazione di Microsoft Entra almeno come Amministratore applicazione cloud.
  2. Passare a Identità>Applicazioni>Applicazioni aziendali>Cognidox.
  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 SSO di Cognidox

Per configurare l'accesso Single Sign-On sul lato di Cognidox è necessario inviare il file XML dei metadati di federazione scaricato e gli URL appropriati copiati dall'applicazione al team di supporto di Cognidox. La configurazione viene eseguita in modo che la connessione SSO SAML sia impostata correttamente su entrambi i lati.

Creare l'utente di test di Cognidox

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

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 Prova questa applicazione: si passerà all'URL di accesso di Cognidox da cui è possibile avviare il flusso di accesso.

  • Passare direttamente all'URL di accesso di Cognidox e avviare il flusso di accesso.

Avviato da IDP:

  • Fare clic su Prova questa applicazione: si dovrebbe accedere automaticamente alla sessione di Cognidox per cui è stato configurato l'accesso SSO.

È anche possibile usare App personali Microsoft per testare l'applicazione in qualsiasi modalità. Quando si fa clic sulla tessera di Cognidox nella sezione App personali, se è configurato in modalità SP, si verrà reindirizzati alla pagina di accesso all'applicazione per avviare il flusso di accesso; se è configurato in modalità IDP si dovrebbe accedere automaticamente alla sessione di Cognidox per cui è stato configurato l'accesso SSO. Per ulteriori informazioni, consultare la sezione App personali in Microsoft Entra.

Passaggi successivi

Dopo aver configurato Cognidox è possibile applicare il controllo della sessione, che consente di proteggere in tempo reale l'estrazione e l'introduzione 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.