Condividi tramite

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

  • Articolo

In questa esercitazione si apprenderà come integrare KnowledgeOwl con Microsoft Entra ID. L’integrazione di KnowledgeOwl con Microsoft Entra ID permette di:

  • Controllare in Microsoft Entra ID chi può accedere a KnowledgeOwl.
  • Abilitare gli utenti all'accesso automatico a KnowledgeOwl 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 KnowledgeOwl 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 testing.

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

Per configurare l'integrazione di KnowledgeOwl in Microsoft Entra ID, è necessario aggiungere KnowledgeOwl dalla raccolta all'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 KnowledgeOwl nella casella di ricerca.
  4. Selezionare KnowledgeOwl 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 SSO di Microsoft Entra per KnowledgeOwl

Configurare e testare l'accesso SSO di Microsoft Entra con KnowledgeOwl usando un utente di test denominato B. Simon. Per il corretto funzionamento dell'accesso SSO è necessario stabilire una relazione di collegamento tra un utente di Microsoft Entra e l'utente correlato in KnowledgeOwl.

Per configurare e testare l'accesso SSO di Microsoft Entra con KnowledgeOwl, 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 KnowledgeOwl: per configurare le impostazioni di Single Sign-On sul lato applicazione.
    1. Creare l'utente di test di KnowledgeOwl: per avere una controparte di B. Simon in KnowledgeOwl 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 Applicazioni>di identità>Applicazioni aziendali>KnowledgeOwl>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 immettere i valori per i campi seguenti se si vuole configurare l'applicazione in modalità avviata da IDP:

    a. Nella casella di testo Identificatore digitare un URL usando uno dei criteri seguenti:

    https://app.knowledgeowl.com/sp
https://app.knowledgeowl.com/sp/id/<unique ID>

    b. Nella casella di testo URL di risposta digitare un URL usando uno dei criteri seguenti:

    https://subdomain.knowledgeowl.com/help/saml-login
https://subdomain.knowledgeowl.com/docs/saml-login
https://subdomain.knowledgeowl.com/home/saml-login
https://privatedomain.com/help/saml-login
https://privatedomain.com/docs/saml-login
https://privatedomain.com/home/saml-login

  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 di accesso digitare un URL usando uno dei criteri seguenti:

    https://subdomain.knowledgeowl.com/help/saml-login
https://subdomain.knowledgeowl.com/docs/saml-login
https://subdomain.knowledgeowl.com/home/saml-login
https://privatedomain.com/help/saml-login
https://privatedomain.com/docs/saml-login
https://privatedomain.com/home/saml-login

    Nota

    Poiché questi non sono i valori reali, è necessario aggiornarli in seguito con l'identificatore, l'URL di risposta e l'URL di accesso effettivi. La procedura è descritta più avanti nell'esercitazione.

  7. L'applicazione KnowledgeOwl 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 KnowledgeOwl 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 Spazio dei nomi
    ssoid user.mail http://schemas.xmlsoap.org/ws/2005/05/identity/claims

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

    Collegamento di download del certificato

  10. Nella sezione Configura KnowledgeOwl 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 immettere B.Simon.
    2. Nel campo Nome dell’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 KnowledgeOwl.

  1. Accedere all'Interfaccia di amministrazione di Microsoft Entra almeno come Amministratore applicazione cloud.
  2. Passare a Applicazioni>di identità>Applicazioni aziendali>KnowledgeOwl.
  3. Nella pagina di panoramica dell'app selezionare Utenti e gruppi.
  4. Selezionare Aggiungi utente/gruppo, quindi Utenti e gruppi nella finestra di dialogo Aggiungi assegnazione.
    1. 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.
    2. Se si prevede che agli utenti venga assegnato un ruolo, è possibile selezionarlo nell'elenco a discesa Selezionare un ruolo. Se per questa app non è stato configurato alcun ruolo, il ruolo selezionato è "Accesso predefinito".
    3. Nella finestra di dialogo Aggiungi assegnazione fare clic sul pulsante Assegna.

Configurare l'accesso Single Sign-On di KnowledgeOwl

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

  2. Fare clic su Settings (Impostazioni) e quindi selezionare SSO.

    Screenshot che mostra l'opzione SSO selezionata nel menu Settings.

  3. Scorrere fino alla scheda Impostazioni SAML e seguire questa procedura:

    Screenshot che mostra la pagina SAML SSO Integration in cui è possibile apportare le modifiche descritte qui.

    a. Selezionare Enable SAML SSO (Abilita SSO SAML).

    b. Copiare il valore di SP Entity ID (ID entità SP) e incollarlo in Identifier (Entity ID) (Identificatore - ID entità) nella sezione Configurazione SAML di base del portale di Azure.

    c. Copiare il valore di SP Login URL (URL di accesso del provider di servizi) e incollarlo nelle caselle di testo URL di accesso e URL di risposta nella sezione Configurazione SAML di base del portale di Azure.

    d. Nella casella di testo IdP entityID incollare il valore dell’identificatore di Microsoft Entra copiato in precedenza.

    e. Nella casella di testo URL di accesso IdP incollare il valore dell’URL di accesso copiato in precedenza.

    f. Nella casella di testo URL di disconnessione IdP, incollare il valore dell’URL di disconnessione copiato in precedenza.

    g. Caricare il certificato scaricato dal portale di Azure facendo clic sul collegamento Carica sotto a Certificato IdP..

    h. Fare clic su Save nella parte inferiore della pagina.

    Screenshot che mostra il pulsante Save.

    i. Aprire la scheda Esegui il mapping degli attributi SAML per eseguire il mapping degli attributi e seguire questa procedura:

    Screenshot che mostra la pagina Map SAML Attributes in cui è possibile apportare le modifiche descritte qui.

    • Immettere http://schemas.xmlsoap.org/ws/2005/05/identity/claims/ssoid nella casella di testo ID SSO.
    • Immettere http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress nella casella di testo Username/Email (Nome utente/indirizzo di posta elettronica).
    • Immettere http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname nella casella di testo First Name (Nome).
    • Immettere http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname nella casella di testo Last Name (Cognome).

    j. Fare clic su Save nella parte inferiore della pagina.

    Screenshot che mostra il pulsante Salva1.

Creare un utente di test di KnowledgeOwl

In questa sezione viene creato un utente di nome B.Simon in KnowledgeOwl. KnowledgeOwl 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 KnowledgeOwl, ne viene creato uno nuovo dopo l'autenticazione.

Nota

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

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

  • Quando si fa clic su Testa questa applicazione, si verrà reindirizzati all'URL di accesso di KnowledgeOwl, dove è possibile avviare il flusso di accesso.

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

Avviato da IDP

  • Dopo aver fatto clic su Testa l'applicazione nel portale di Azure, si dovrebbe accedere automaticamente all'applicazione KnowledgeOwl per cui si è configurato l'accesso SSO.

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

Passaggi successivi

Dopo aver configurato KnowledgeOwl, è 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 sessione con Microsoft Defender for Cloud Apps.