Condividi tramite

Esercitazione: Integrazione dell'accesso Single Sign-On di Microsoft Entra con Oneteam

  • Articolo

Questa esercitazione descrive come integrare Oneteam con Microsoft Entra ID. Integrando Oneteam con Microsoft Entra ID è possibile:

  • controllare in Microsoft Entra ID chi può accedere a Oneteam.
  • abilitare gli utenti all'accesso automatico a Oneteam 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 Oneteam abilitata per l'accesso Single Sign-On (SSO).

Descrizione dello scenario

In questa esercitazione viene configurato e testato l'accesso Single Sign-On di Microsoft Entra in un ambiente di testing.

  • Oneteam supporta l'accesso SSO avviato da SP e IDP

  • Oneteam supporta il provisioning utenti JIT

Per configurare l'integrazione di Oneteam in Microsoft Entra ID è necessario aggiungere Oneteam 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 Oneteam nella casella di ricerca.
  4. Selezionare Oneteam 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 Oneteam

Configurare e testare l'accesso SSO di Microsoft Entra con Oneteam usando un utente di test chiamato 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 Oneteam.

Per configurare e testare l'accesso SSO di Microsoft Entra con Oneteam 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 Oneteam: per configurare le impostazioni di Single Sign-On sul lato applicazione.
    1. Creare l'utente di test di Oneteam: per avere una controparte di B. Simon in Oneteam 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>Oneteam>Accesso 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.one-team.io/teams/<team name>

    b. Nella casella di testo URL di risposta digitare un URL nel formato seguente: https://api.one-team.io/teams/<team name>/auth/saml/callback

  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://<team name>.one-team.io/

    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 Oneteam. È anche possibile fare riferimento ai modelli mostrati nella sezione Configurazione SAML di base.

  7. Nella sezione Certificato di firma SAML della pagina Configura l'accesso Single Sign-On con SAML fare clic su Scarica per scaricare il file XML dei metadati della federazione definito dalle opzioni specificate in base ai propri requisiti e salvarlo nel computer in uso.

    Collegamento di download del certificato

  8. Nella sezione Configura Oneteam 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 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 l’utente B.Simon verrà abilitato all'uso dell'accesso Single Sign-On che concede l'accesso a Oneteam.

  1. Accedere all'Interfaccia di amministrazione di Microsoft Entra almeno come Amministratore applicazione cloud.
  2. Passare a Identità>Applicazioni>Applicazioni aziendali>Oneteam.
  3. Nella pagina di panoramica dell'app selezionare Utenti e gruppi.
  4. Selezionare Aggiungi utente/gruppo, poi selezionare 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 Oneteam

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

Creare l'utente di test di Oneteam

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

Nota

Se è necessario creare manualmente un utente, è possibile generare il ticket di supporto con il team di supporto Oneteam.

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:

  • Facendo clic su Testa questa applicazione, verrà eseguito il reindirizzamento all'URL di accesso di Oneteam in cui è possibile avviare il flusso di accesso.

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

Avviato da IDP:

  • Facendo clic su Testa questa applicazione, si accederà automaticamente a Oneteam, per cui è stato configurato l'accesso SSO.

È anche possibile usare App personali Microsoft per testare l'applicazione in qualsiasi modalità. Se configurato in modalità SP, facendo click sul riquadro di Oneteam in App personali, si verrà reindirizzati alla pagina di accesso dell'applicazione per avviare il flusso di accesso; se configurato in modalità IDP, si accederà automaticamente a Oneteam per cui è stato configurato l'accesso SSO. Per altre informazioni vedere App personali di Microsoft Entra.

Passaggi successivi

Dopo aver configurato Oneteam, è possibile applicare il controllo sessione che protegge in tempo reale dall'esfiltrazione e dall'infiltrazione dei dati sensibili dell'organizzazione. Il controllo sessione costituisce un'estensione dell'accesso condizionale. Informazioni su come applicare il controllo sessione con Microsoft Cloud App Security.