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

  • Articolo

Questa esercitazione descrive come integrare EasySSO for BitBucket con Microsoft Entra ID. Integrando EasySSO for BitBucket con Microsoft Entra ID, è possibile:

  • Controllare in Microsoft Entra ID chi può accedere a EasySSO for BitBucket.
  • Abilitare gli utenti per l'accesso automatico a EasySSO for BitBucket con gli account Microsoft Entra personali.
  • È possibile gestire gli account in un'unica posizione centrale: il portale di Azure.

Prerequisiti

Per iniziare, hai bisogno di quanto segue:

  • Una sottoscrizione di Microsoft Entra. Se non si possiede una sottoscrizione, è possibile ottenere un account gratuito.
  • Una sottoscrizione di EasySSO for BitBucket 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.

  • EasySSO for BitBucket supporta l'accesso SSO avviato da SP e IdP.
  • EasySSO for BitBucket supporta il provisioning utenti JIT.

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

  1. Accedere all'interfaccia di amministrazione di Microsoft Entra come almeno un'applicazione cloud Amministrazione istrator.
  2. Passare a Applicazioni di identità>Applicazioni>aziendali>Nuova applicazione.
  3. Nella sezione Aggiungi dalla raccolta digitare EasySSO for BitBucket nella casella di ricerca.
  4. Selezionare EasySSO for BitBucket nei risultati e quindi aggiungere l'app. Attendere alcuni secondi che l'app venga aggiunta al tenant.

In alternativa, è anche possibile usare l'Enterprise Configurazione app Wizard. 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 EasySSO for BitBucket

Configurare e testare l'accesso SSO di Microsoft Entra con EasySSO for BitBucket usando un utente di test di nome B.Simon. Per consentire il funzionamento dell'accesso Single Sign-On, è necessario stabilire una relazione collegata tra un utente di Microsoft Entra e l'utente correlato in EasySSO for BitBucket.

Per configurare e testare l'accesso SSO di Microsoft Entra con EasySSO for BitBucket, 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 EasySSO for BitBucket: per configurare le impostazioni di Single Sign-On sul lato applicazione.
    1. Creare un utente di test di EasySSO for BitBucket per avere una controparte di B.Simon in EasySSO for BitBucket 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 come almeno un'applicazione cloud Amministrazione istrator.

  2. Passare alla pagina di integrazione dell'applicazione EasySSO for BitBucket delle applicazioni>Identity>Applications>Enterprise e individuare la sezione Gestione. e 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 relativa a Configurazione SAML di base per modificare le impostazioni.

    Screenshot of Set up Single Sign-On with SAML page, with pencil icon highlighted

  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 l'URL che usa 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. Selezionare Impostare URL aggiuntivi e quindi 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://<server-base-url>/login.jsp

    Nota

    Poiché questi non sono i valori reali, aggiornarli con l'identificatore, l'URL di risposta e l'URL di accesso effettivi. In caso di dubbi, contattare il team di supporto di EasySSO per ottenere questi valori. È anche possibile fare riferimento ai modelli illustrati nella sezione Configurazione SAML di base.

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

    Screenshot of default attributes

  8. L'applicazione EasySSO for BitBucket prevede inoltre il passaggio di altri attributi nella risposta SAML. Tali attributi sono elencati nella tabella seguente. Anche questi attributi vengono prepopolati, ma è possibile esaminarli in base alle 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 user.mail
    urn:oid:2.16.840.1.113730.3.1.241 user.displayname
    urn:oid:2.5.4.4 user.surname
    urn:oid:2.5.4.42 user.givenname

    Se gli utenti di Microsoft Entra hanno configurato sAMAccountName , è necessario eseguire il mapping di urn:oid:0.9.2342.19200300.100.1.1 nell'attributo sAMAccountName .

  9. Nella sezione Certificato di firma SAML della pagina Configura l'accesso Single Sign-On con SAML selezionare i collegamenti di download relativi alle opzioni Certificato (Base64) o XML metadati federazione e salvare una o entrambi nel computer. Tali dati saranno necessari in seguito per configurare EasySSO per BitBucket.

    Screenshot of the SAML Signing Certificate section, with download links highlighted

    Se si prevede di configurare EasySSO for BitBucket manualmente con un certificato, è anche necessario copiare l'URL di accesso e Microsoft Entra Identifier e salvarli nel computer.

Creare un utente di test di Microsoft Entra

In questa sezione si creerà un utente di test, B.Simon, .

  1. Accedere all'interfaccia di amministrazione di Microsoft Entra come almeno un utente Amministrazione istrator.
  2. Passare a Utenti>identità>Tutti gli utenti.
  3. Selezionare Nuovo utente Crea nuovo utente> nella parte superiore della schermata.
  4. Nelle 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 si abiliterà B.Simon all'uso dell'accesso Single Sign-On concedendole l'accesso a EasySSO for BitBucket.

  1. Passare a Applicazioni di identità>Applicazioni>aziendali.
  2. Nell'elenco delle applicazioni selezionare EasySSO for BitBucket.
  3. Nella pagina di panoramica dell'app individuare la sezione Gestione e selezionare Utenti e gruppi.
  4. Seleziona Aggiungi utente. Nella finestra di dialogo Aggiungi assegnazione selezionare Utenti e gruppi.
  5. Nella finestra di dialogo Utenti e gruppi selezionare B.Simon nell'elenco Utenti e quindi scegliere Seleziona nella parte inferiore della schermata.
  6. 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".
  7. Nella finestra di dialogo Aggiungi assegnazione selezionare Assegna.

Configurare l'accesso Single Sign-On di EasySSO for BitBucket

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

  2. Passare alla sezione Administration (Amministrazione).

    Screenshot of BitBucket instance, with gear icon highlighted

  3. Individuare e selezionare EasySSO.

    Screenshot of Easy SSO option

  4. Selezionare SAML. Verrà visualizzata la sezione relativa alla configurazione SAML.

    Screenshot of EasySSO Admin page, with SAML highlighted

  5. Selezionare la scheda Certificates (Certificati). Verrà visualizzata la schermata seguente:

    Screenshot of the Certificates tab, with various options highlighted

  6. Individuare il certificato (Base64) o il file di metadati salvato nella sezione precedente di questa esercitazione. È possibile procedere in uno dei modi seguenti:

    • Usare il file dei metadati di federazione dell'app scaricato come file locale nel computer. Selezionare il pulsante di opzione Upload (Carica) e seguire il percorso specifico del sistema operativo corrente.

    • Aprire il file di metadati di federazione dell'app in qualsiasi editor di testo normale per visualizzarne il contenuto e copiarlo negli Appunti. Selezionare Input e incollare il contenuto degli Appunti nel campo di testo.

    • Eseguire una configurazione completamente manuale. Aprire il certificato (Base64) di federazione dell'app in qualsiasi editor di testo normale per visualizzarne il contenuto. Copiarlo negli Appunti e incollarlo nel campo di testo IdP Token Signing Certificates (Certificati per la firma di token IdP). Passare quindi alla scheda Generale e compilare i campi POST Binding URL (URL di associazione POST) e Entity ID (ID entità) con i rispettivi valori per URL di accesso e Microsoft Entra Identifier salvati in precedenza.

  7. Selezionare Save (Salva) nella parte inferiore della pagina. Si noterà che il contenuto dei file dei metadati o di certificato viene analizzato nei campi di configurazione. La configurazione di EasySSO for BitBucket è stata completata.

  8. Per testare la configurazione, passare alla scheda Look & Feel (Aspetto) e selezionare SAML Login Button (Pulsante di accesso SAML). In questo modo viene abilitato un pulsante separato nella schermata di accesso di BitBucket, in particolare per testare l'integrazione SAML di Microsoft Entra SAML end-to-end. È possibile lasciare attivato questo pulsante e configurarne la posizione, il colore e la traduzione anche per la modalità di produzione.

    Screenshot of SAML page Look & Feel tab, with SAML Login Button highlighted

    Nota

    Se si verificano problemi, contattare il team di supporto di EasySSO.

Creare un utente di test di EasySSO for BitBucket

In questa sezione viene creato un utente di nome Britta Simon in BitBucket. EasySSO for BitBucket supporta il provisioning utenti JIT, che è disabilitato per impostazione predefinita. Per abilitarlo, è necessario selezionare in modo esplicito l'opzione Create user on successful login (Crea utente in caso di accesso riuscito) nella sezione General (Generale) della configurazione del plug-in EasySSO. Se non esiste già un utente in BitBucket, ne viene creato uno nuovo dopo l'autenticazione.

Se però non si vuole abilitare il provisioning utenti automatico al primo accesso, gli utenti devono essere già presenti nelle directory utente usate dall'istanza di BitBucket. Questa directory potrebbe, ad esempio, essere LDAP o Atlassian Crowd.

Screenshot of the General section of EasySSO plug-in configuration, with Create user on successful login highlighted

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 EasySSO for BitBucket in cui è possibile avviare il flusso di accesso.

  • Passare direttamente all'URL di accesso di EasySSO for BitBucket 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'applicazione EasySSO for BitBucket 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 EasySSO for BitBucket in App personali, se è stato configurato in modalità SP, si dovrebbe essere reindirizzati alla pagina di accesso dell'applicazione per avviare il flusso di accesso; se invece è configurato in modalità IDP, si dovrebbe accedere automaticamente all'istanza di EasySSO for BitBucket per cui si è configurato l'accesso SSO. Per altre informazioni su App personali, vedere l'introduzione ad App personali.

Passaggi successivi

Dopo aver configurato EasySSO for BitBucket, è 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 app Microsoft Defender per il cloud.