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

  • Articolo

Questa esercitazione descrive come integrare Atlassian Cloud con Microsoft Entra ID. Integrando Atlassian Cloud con Microsoft Entra ID, è possibile:

  • Controllare in Microsoft Entra ID chi può accedere ad Atlassian Cloud.
  • Abilitare gli utenti per l'accesso automatico ad Atlassian Cloud 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 Atlassian Cloud abilitata per l'accesso Single Sign-On (SSO).
  • Per abilitare l'accesso Single Sign-On SAML (Security Assertion Markup Language) per i prodotti Atlassian Cloud, è necessario configurare l'accesso Atlassian. Altre informazioni sull'accesso Atlassian.

Nota

Questa integrazione è disponibile anche per l'uso dall'ambiente cloud US Government di Microsoft Entra. È possibile trovare questa applicazione nella raccolta di applicazioni cloud US Government di Microsoft Entra e configurarla con la stessa procedura usata dal cloud pubblico.

Descrizione dello scenario

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

Per configurare l'integrazione di Atlassian Cloud in Microsoft Entra ID, è necessario aggiungere Atlassian Cloud 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 Atlassian Cloud nella casella di ricerca.
  4. Selezionare Atlassian Cloud 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. Altre informazioni sulle procedure guidate di Microsoft 365 sono disponibili qui.

Configurare e testare l'accesso Single Sign-On di Microsoft Entra

Configurare e testare l'accesso SSO di Microsoft Entra con Atlassian Cloud 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 Atlassian Cloud.

Per configurare e testare l'accesso SSO di Microsoft Entra con Atlassian Cloud, seguire questa procedura:

  1. Configurare Microsoft Entra ID con Atlassian Cloud SSO : per consentire agli utenti di usare l'accesso SSO SAML basato su SAML basato su Microsoft Entra con Atlassian Cloud.
    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. Creare l'utente di test di Atlassian Cloud: per avere una controparte di B.Simon in Atlassian Cloud collegata alla rappresentazione dell'utente in Microsoft Entra.
  3. Testare l'accesso Single Sign-On: per verificare se la configurazione funziona.

Configurare l'ID Microsoft Entra con Atlassian Cloud SSO

Seguire questa procedura per abilitare l'accesso Single Sign-On di Microsoft Entra.

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

  2. Nel portale di amministrazione di ATLASSIAN passare a Provider di identità di>sicurezza>Microsoft Entra ID.

  3. Immettere il nome della directory e fare clic sul pulsante Aggiungi.

  4. Selezionare Il pulsante Configura accesso Single Sign-On SAML per connettere il provider di identità all'organizzazione Atlassian.

    Screenshot che mostra la sicurezza del provider di identità.

  5. Accedere all'Interfaccia di amministrazione di Microsoft Entra almeno come Amministratore applicazione cloud.

  6. Passare alla pagina di integrazione dell'applicazione Atlassian Cloud per applicazioni aziendali di Identity>Applications.>> Trovare la sezione Gestione . In Introduzione selezionare Configura l'accesso Single Sign-On.

  7. Nella pagina Selezionare un metodo di accesso Single Sign-On selezionare SAML.

  8. Nella pagina Configura l'accesso Single Sign-On con SAML scorrere verso il basso fino a Configurare Atlassian Cloud.

    a. Fare clic su URL di configurazione.

    b. Copiare il valore di URL di accesso da portale di Azure, incollarlo nella casella di testo Identity provider SSO URL (URL SSO provider di identità) in Atlassian.

    c. Copiare il valore di Microsoft Entra Identifier da portale di Azure, incollarlo nella casella di testo Identity provider Entity ID (ID entità provider di identità) in Atlassian.

    Screenshot che mostra i valori di configurazione.

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

    Certificato di firma

    Screenshot che mostra il certificato in Azure.

  10. Salvare la configurazione SAML e fare clic su Avanti in Atlassian.

  11. Nella sezione Configurazione SAML di base seguire questa procedura.

    a. Copiare il valore dell'URL dell'entità del provider di servizi da Atlassian, incollarlo nella casella Identificatore (ID entità) in Azure e impostarlo come predefinito.

    b. Copiare il valore url del servizio consumer di asserzione del provider di servizi da Atlassian, incollarlo nella casella URL di risposta (URL del servizio consumer di asserzione) in Azure e impostarlo come predefinito.

    c. Fare clic su Avanti.

    Screenshot che mostra le immagini del provider di servizi.

    Screenshot che mostra i valori del provider di servizi.

  12. L'applicazione Atlassian Cloud prevede un formato specifico per le asserzioni SAML. È quindi necessario aggiungere mapping di attributi personalizzati alla configurazione degli attributi del token SAML. Per modificare il mapping degli attributi, fare clic sull'icona Modifica.

    Attributi

    1. Mapping degli attributi per un tenant di Microsoft Entra con una licenza di Microsoft 365.

      a. Fare clic sull'attestazione Identificatore utente univoco (ID nome).

      Attributi e attestazioni

      b. Atlassian Cloud prevede il mapping di nameidentifier (Identificatore univoco dell'utente) all'indirizzo di posta elettronica dell'utente (user.email). Modificare il valore di Attributo di origine impostandolo su user.mail. Salvare le modifiche apportate all'attestazione.

      ID utente univoco

      c. I mapping finali degli attributi dovrebbero essere simili ai seguenti.

      immagine 2

    2. Mapping degli attributi per un tenant di Microsoft Entra senza una licenza di Microsoft 365.

      a. Fare clic sull'attestazione http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress.

      immagine 3

      b. Anche se Azure non popola l'attributo user.mail per gli utenti creati nei tenant di Microsoft Entra senza licenze di Microsoft 365 e archivia il messaggio di posta elettronica per tali utenti nell'attributo userprincipalname . Atlassian Cloud prevede il mapping di nameidentifier (Identificatore univoco dell'utente) all'indirizzo di posta elettronica dell'utente (user.userprincipalname). Modificare il valore di Attributo di origine impostandolo su user.userprincipalname. Salvare le modifiche apportate all'attestazione.

      Impostare un messaggio di posta elettronica

      c. I mapping finali degli attributi dovrebbero essere simili ai seguenti.

      Immagine 4

  13. Fare clic sul pulsante Arresta e salva SAML .

    Screenshot che mostra l'immagine del salvataggio della configurazione.

  14. Per applicare l'accesso Single Sign-On SAML in un criterio di autenticazione, seguire questa procedura.

    a. Nel portale di amministrazione di Atlassian selezionare la scheda Sicurezza e fare clic su Criteri di autenticazione.

    b. Selezionare Modifica per il criterio da applicare.

    c. In Impostazioni abilitare l'applicazione dell'accesso Single Sign-On agli utenti gestiti per il reindirizzamento SAML riuscito.

    d. Fai clic su Aggiorna.

    Screenshot che mostra i criteri di autenticazione.

    Nota

    Gli amministratori possono testare la configurazione SAML abilitando solo l'accesso SSO applicato per un subset di utenti in un criterio di autenticazione separato e quindi abilitando i criteri per tutti gli utenti in caso di problemi.

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 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 ad Atlassian Cloud.

  1. Accedere all'Interfaccia di amministrazione di Microsoft Entra almeno come Amministratore applicazione cloud.
  2. Passare ad Applicazioni di identità>Applicazioni>aziendali>Atlassian Cloud.
  3. Nella pagina della 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.

Creare l'utente di test di Atlassian Cloud

Per abilitare gli utenti di Microsoft Entra ad accedere ad Atlassian Cloud, effettuare il provisioning manuale degli account utente in Atlassian Cloud seguendo questa procedura:

  1. Passare alla scheda Prodotti , selezionare Utenti e fare clic su Invita utenti.

    Collegamento Users (Utenti) di Atlassian Cloud

  2. Nella casella di testo Indirizzo di posta elettronica immettere l'indirizzo di posta elettronica dell'utente e quindi fare clic su Invita utente.

    Creare un utente di Atlassian Cloud

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 Atlassian Cloud, in cui è possibile avviare il flusso di accesso.

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

Passaggi successivi

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