Condividi tramite


Integrazione dell'accesso Single Sign-On (SSO) di Microsoft Entra con EasySSO for Bamboo

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

  • Controllare in Microsoft Entra ID chi può accedere a Bamboo.
  • Consenti agli utenti di accedere automaticamente a Bamboo 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 per l'accesso Single Sign-On (SSO) di EasySSO per Bamboo.

Descrizione dello scenario

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

  • EasySSO for Bamboo supporta l'avvio dell'SSO da parte di SP e IDP.
  • EasySSO for Bamboo supporta il provisioning utenti JIT.

Per configurare l'integrazione di EasySSO for Bamboo in Microsoft Entra ID, è necessario aggiungere EasySSO for Bamboo dalla raccolta all'elenco di app SaaS gestite.

  1. Accedi all'interfaccia di amministrazione di Microsoft Entra come almeno un Cloud Application Administrator .
  2. Passare a Identity>Applications>Enterprise applications>New application.
  3. Nella sezione Aggiungi dalla galleria digitare EasySSO for Bamboo nella casella di ricerca.
  4. Selezionare EasySSO for Bamboo nel pannello dei risultati e quindi aggiungere l'app. Attendere alcuni secondi mentre l'app viene aggiunta al tenant.

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

Configurare e testare il Single Sign-On di Microsoft Entra per EasySSO per Bamboo

Configurare e testare SSO di Microsoft Entra con EasySSO for Bamboo 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 EasySSO for Bamboo.

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

  1. Configurare il 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 EasySSO per Bamboo SSO: per configurare le impostazioni del single sign-on dal lato dell'applicazione.
    1. Creare un utente di test EasySSO per Bamboo: per avere una controparte di B.Simon in EasySSO per Bamboo collegata alla rappresentazione dell'utente in Microsoft Entra.
  3. Testare SSO: 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 un amministratore di applicazioni cloud .

  2. Vai a Identity>Applications>Enterprise applications>EasySSO for Bamboo>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 a forma di matita per Configurazione SAML di Base per modificare le impostazioni.

    Modificare la configurazione SAML di base

  5. Nella sezione configurazione SAML di base, se si desidera configurare l'applicazione in modalità avviata da IDP, seguire i seguenti passaggi:

    un. Nella casella di testo identificatore digitare un URL usando il modello seguente: https://<SERVER_BASE_URL>/plugins/servlet/easysso/saml

    b. Nella casella di testo URL di risposta digitare un URL nel formato seguente: https://<SERVER_BASE_URL>/plugins/servlet/easysso/saml

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

    Nella casella di testo URL di accesso digitare un URL usando il modello seguente: https://<SERVER_BASE_URL>/login.jsp

    Nota

    Questi valori non sono reali. Aggiornare questi valori con l'identificatore effettivo, l'URL di risposta e l'URL di accesso. Contattare il team di supporto EasySSO per ottenere questi valori in caso di dubbi. È anche possibile fare riferimento ai modelli illustrati nella sezione configurazione SAML di base.

  7. L'applicazione EasySSO for Bamboo 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.

    'immagine

  8. Oltre a quanto sopra riportato, l'applicazione EasySSO for Bamboo prevede il passaggio di altri attributi nella risposta SAML, come illustrato di seguito. Questi attributi sono già pre-popolati, ma puoi esaminarli in base alle tue esigenze.

    Nome Attributo di origine
    urn:oid:0.9.2342.19200300.100.1.1 user.userprincipalname
    urn:oid:0.9.2342.19200300.100.1.3 utente.email
    urn:oid:2.16.840.1.113730.3.1.241 user.displayname
    urn:oid:2.5.4.4 Cognome utente
    urn:oid:2.5.4.42 utente.nome

    Nel caso in cui gli utenti di Microsoft Entra abbiano configurato sAMAccountName, è necessario associare urn:oid:0.9.2342.19200300.100.1.1 all'attributo sAMAccountName.

  9. Nella pagina Configura il Single Sign-On con SAML, nella sezione Certificato di firma SAML, fai clic sui link Download per le opzioni Certificate (Base64) o Federation Metadata XML e salva uno o tutti nel tuo computer. Sarà necessario in un secondo momento per configurare Bamboo EasySSO.

    Collegamento di download del certificato

    Se si prevede di eseguire manualmente la configurazione di EasySSO for Bamboo con il certificato, è anche necessario copiare URL di accesso e Microsoft Entra Identifier dalla sezione seguente e salvarli nel computer.

Creare un utente di test di Microsoft Entra

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

  1. Effettua l'accesso al centro di amministrazione di Microsoft Entra come almeno un amministratore utente .
  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, inserire B.Simon.
    2. Nel campo Nome principale utente immettere il testo richiesto 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 Rivedi e crea.
  5. Selezionare Crea.

Assegnare l'utente di test di Microsoft Entra

In questa sezione, abiliterai B.Simon all'uso del Single Sign-On concedendogli l'accesso a EasySSO for Bamboo.

  1. Accedi all'interfaccia di amministrazione di Microsoft Entra come almeno un Amministratore di applicazioni cloud .
  2. Passare a Identity>Applications>Enterprise applications>EasySSO for Bamboo.
  3. Nella pagina panoramica dell'app, selezionare Utenti e gruppi.
  4. Selezionare Aggiungi utente/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.

Configura EasySSO per Bamboo SSO

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

  2. Vai alla sezione Gestisci app.

    Gestire le app

  3. Sul lato sinistro individuare EasySSO e fare clic su di esso.

    Easy SSO

  4. Selezionare l'opzione SAML. Verrà visualizzata la sezione configurazione SAML.

    SAML

  5. Seleziona la scheda Certificati in alto, e verrà visualizzata la schermata seguente:

    URL dei metadati

  6. Individua ora Certificato (Base64) o File di Metadati che hai salvato nei passaggi precedenti di configurazione di Microsoft Entra SSO. Sono disponibili le opzioni seguenti su come procedere:

    un. Usare il file di metadati di federazione dell'app, che hai scaricato come file locale sul tuo computer. Selezionare pulsante di opzione Carica e seguire la finestra di dialogo carica file specifica del sistema operativo.

    OR

    b. Apri il file di metadati della Federazione dell'app per visualizzare il contenuto (in un qualsiasi editor di testo semplice) e copiarlo negli appunti. Seleziona l'opzione Input e incolla il contenuto degli appunti nel campo di testo.

    OR

    c. Configurazione completamente manuale. Apri il certificato di federazione dell'app (Base64) per visualizzare il contenuto del file in qualsiasi editor di testo semplice e copiarlo negli appunti. Incollarlo nel campo di testo Certificati di firma token IdP . Passare quindi alla scheda Generale e compilare i campi URL di associazione POST e ID entità con i rispettivi valori per URL di accesso e Identificatore Microsoft Entra salvati in precedenza.

  7. Fare clic sul pulsante Salva in fondo alla pagina. Si noterà che il contenuto dei file di metadati o certificato viene analizzato nei campi di configurazione. La configurazione di EasySSO for Bamboo è completa.

  8. Per un'esperienza di test ottimale, passare alla scheda Look & Feel e attivare l'opzione pulsante di accesso SAML. In questo modo verrà abilitato un pulsante separato nella schermata di accesso di Bamboo specificamente per testare da capo a fondo l'integrazione SAML di Microsoft Entra. È possibile lasciare attivo questo pulsante e configurarne anche la posizione, il colore e la traduzione per la modalità di produzione.

    Aspetto & Sensazione

    Nota

    In caso di problemi, contattare team di supporto di EasySSO.

Creare l'utente di test di EasySSO for Bamboo

In questa sezione viene creato un utente di nome Britta Simon in Bamboo. EasySSO for Bamboo supporta il provisioning utenti JIT, che è disabilitato per impostazione predefinita. Per abilitare il provisioning degli utenti, è necessario selezionare l'opzione "Crea utente in caso di accesso riuscito" nella sezione Generale della configurazione del plug-in EasySSO. Se non esiste già un utente in Bamboo, ne viene creato uno nuovo dopo l'autenticazione.

Tuttavia, se non si desidera abilitare il provisioning utenti automatico al primo accesso dell'utente, gli utenti devono esistere nelle directory utente back-end utilizzate dall'istanza di Bamboo, come LDAP o Atlassian Crowd.

provisioning degli utenti

Test SSO

Flusso di lavoro avviato da IdP

In questa sezione viene testata la configurazione dell'accesso Single Sign-On di Microsoft Entra usando My Apps.

Quando si fa clic sul riquadro di EasySSO for Bamboo in My Apps, si dovrebbe accedere automaticamente all'istanza di Bamboo per cui si è configurato l'accesso SSO. Per altre informazioni sulle app personali, vedere Introduzione alle app personali.

Flusso di lavoro avviato da SP

In questa sezione, viene testata la configurazione dell'accesso Single Sign-On di Microsoft Entra usando il pulsante SAML di accesso Bamboo .

accesso utente SAML

Questo scenario presuppone che sia stato abilitato il pulsante di accesso SAML nella scheda Look & Feel nella pagina di configurazione di Bamboo EasySSO (vedere sopra). Aprire l'URL di accesso bamboo in modalità in incognito del browser per evitare interferenze con le sessioni esistenti. Fai clic sul pulsante SAML Login (Accesso SAML) e verrai reindirizzato al flusso di autenticazione utente di Microsoft Entra. Una volta completato con successo, sarete reindirizzati alla vostra istanza di Bamboo come utente autenticato tramite SAML.

Potresti incontrare la seguente schermata dopo essere stato reindirizzato dall'ID Microsoft Entra.

schermata di errore easySSO

In questo caso è necessario seguire le istruzioni in questa pagina per ottenere l'accesso al file di atlassian-bamboo.log. I dettagli dell'errore saranno disponibili in base all'ID di riferimento trovato nella pagina di errore di EasySSO.

In caso di problemi durante il digest dei messaggi di log, contattare team di supporto di EasySSO.

Dopo aver configurato EasySSO for Bamboo, è 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.