Configura Atlassian Cloud per il provisioning automatico degli utenti con Microsoft Entra ID

Questo articolo descrive i passaggi da eseguire sia nel Cloud di Atlassian che in Microsoft Entra ID per configurare il provisioning automatico degli utenti. Se configurato, Microsoft Entra ID effettua automaticamente il provisioning e il deprovisioning di utenti e gruppi in Atlassian Cloud usando il servizio di provisioning Microsoft Entra. Per informazioni dettagliate sulle caratteristiche e sul funzionamento di questo servizio e per le domande frequenti, consultare la sezione Automatizzare il provisioning e il deprovisioning degli utenti nelle applicazioni SaaS con Microsoft Entra ID.

Capacità supportate

• Creare utenti in Atlassian Cloud
• Rimuovere gli utenti in Atlassian Cloud quando non richiedono più l'accesso
• Mantenere sincronizzati gli attributi utente tra Microsoft Entra ID e Atlassian Cloud
• Effettuare il provisioning di gruppi e appartenenze a gruppi in Atlassian Cloud
• Single Sign-On per Atlassian Cloud (consigliato)

Prerequisiti

Lo scenario descritto in questo articolo presuppone che siano già disponibili i prerequisiti seguenti:

• Un account utente di Microsoft Entra con una sottoscrizione attiva. Se non è già disponibile, è possibile Creare un account gratuitamente.
• Uno dei ruoli seguenti:
  • Amministratore di applicazioni
  • Amministratore di applicazioni cloud
  • proprietario dell'applicazione.

• Assicurarsi di essere un amministratore di un'organizzazione Atlassian. Vedere Amministrazione dell'organizzazione.

• Verifica uno o più dei tuoi domini nell'organizzazione. Vedere Verifica del dominio.

• Iscriviti ad Atlassian Access dalla tua organizzazione. Vedere Criteri e funzionalità di sicurezza di Atlassian Access.

• Un tenant di Atlassian Cloud con una sottoscrizione di Atlassian Access.

• Assicurarsi di essere un amministratore per almeno un sito Jira o Confluence a cui si vuole concedere l'accesso agli utenti sincronizzati.

  Annotazioni

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

Passaggio 1: Pianificare la distribuzione dell'approvvigionamento

1. Scopri di più su come funziona il servizio di provisioning.
2. Determinare chi si trova nell'ambito di per la configurazione.
3. Determinare i dati da mappare tra Microsoft Entra ID e Atlassian Cloud.

Passaggio 2: Configurare Atlassian Cloud per supportare il provisioning con Microsoft Entra ID

1. Passare alla console di amministrazione di Atlassian. Selezionare l'organizzazione se sono presenti più di una.

2. Seleziona Provider di identità di sicurezza >.

3. Selezionare la directory del provider di identità.

4. Selezionare Configura provisioning utenti.

5. Copiare i valori per l'URL di base SCIM e la chiave API. Sono necessari quando si configura Azure.

6. Salvare la configurazione SCIM.

   Annotazioni

   Assicurarsi di archiviare questi valori in un luogo sicuro, perché non verranno visualizzati di nuovo.

   Utenti e gruppi sono assegnati automaticamente alla tua organizzazione. Per altre informazioni sul modo in cui gli utenti e i gruppi vengono sincronizzati con l'organizzazione, vedere la pagina di provisioning degli utenti.

Passaggio 3: Aggiungere Atlassian Cloud dalla raccolta di applicazioni Microsoft Entra

Aggiungere Atlassian Cloud dalla raccolta di applicazioni Microsoft Entra per iniziare a gestire il provisioning in Atlassian Cloud. Se In precedenza è stato configurato Atlassian Cloud per l'accesso SSO, è possibile usare la stessa applicazione. Tuttavia, è consigliabile creare un'app separata durante il test iniziale dell'integrazione. Scopri di più sull'aggiunta di un'applicazione dalla galleria qui.

Passaggio 4: Definire chi è incluso nel processo di provisioning

Il servizio di provisioning di Microsoft Entra consente di delimitare chi viene fornito in base all'assegnazione all'applicazione o in base agli attributi degli utenti o dei gruppi. Se si sceglie di definire l'ambito dell'app in base all'assegnazione, è possibile utilizzare i passaggi per assegnare utenti e gruppi all'applicazione. Se si sceglie di definire l'ambito del provisioning in base esclusivamente agli attributi dell'utente o del gruppo, è possibile usare un filtro di ambito.

• Iniziare con pochi elementi. Eseguire il test con un piccolo insieme di utenti e gruppi prima di distribuirlo a tutti. Quando l'ambito per il provisioning è impostato su utenti e gruppi assegnati, è possibile controllarlo assegnando uno o due utenti o gruppi all'app. Quando l'ambito è impostato su tutti gli utenti e i gruppi, è possibile specificare un filtro di ambito basato su attributi.

• Se sono necessari ruoli aggiuntivi, è possibile aggiornare il manifesto dell'applicazione per aggiungere nuovi ruoli.

Passaggio 5: Configurazione del provisioning automatico degli utenti su Atlassian Cloud

Questa sezione illustra la procedura per configurare il servizio di provisioning di Microsoft Entra per creare, aggiornare e disabilitare utenti e/o gruppi in Atlassian Cloud in base alle assegnazioni di utenti e/o gruppi in Microsoft Entra ID.

Per configurare il provisioning automatico degli utenti per Atlassian Cloud in Microsoft Entra ID:

1. Accedi al Microsoft Entra admin center come almeno un amministratore di applicazioni cloud.

2. Passare ad Entra ID>App aziendali>Atlassian Cloud.

   

3. Nell'elenco delle applicazioni selezionare Atlassian Cloud.

   

4. Selezionare la scheda Provisioning.

   

5. Impostare la Modalità di approvvigionamento su Automatico.

   

6. Nella sezione Credenziali amministratore immettere l'URL del tenant e il token segreto recuperati in precedenza dall'account di Atlassian Cloud. Selezionare Test connessione per assicurarsi che Microsoft Entra ID possa connettersi a Atlassian Cloud. Se la connessione non riesce, verificare che l'account Atlassian Cloud disponga delle autorizzazioni di amministratore e riprovare.

   

7. Nel campo Messaggio di posta elettronica di notifica immettere l'indirizzo di posta elettronica di una persona o un gruppo che riceverà le notifiche di errore relative al provisioning e selezionare la casella di controllo Invia una notifica di posta elettronica in caso di errore.

   

8. Seleziona Salva.

9. Nella sezione Mapping selezionare Synchronize Microsoft Entra users to Atlassian Cloud (Sincronizza utenti di Microsoft Entra in Atlassian Cloud).

10. Esaminare gli attributi utente sincronizzati da Microsoft Entra ID a Atlassian Cloud nella sezione Mapping attributi . L'attributo di posta elettronica viene usato per associare gli account Atlassian Cloud agli account Microsoft Entra. Selezionare il pulsante Salva per confermare le modifiche.

    Attributo	TIPO
    nome utente	Stringa
    attivo	Booleano
    nome.cognome	Stringa
    nome.nomeDato	Stringa
    email[type eq "work"].valore	Stringa

11. Nella sezione Mapping selezionare Synchronize Microsoft Entra groups to Atlassian Cloud (Sincronizza gruppi di Microsoft Entra in Atlassian Cloud).

12. Esaminare gli attributi del gruppo sincronizzati da Microsoft Entra ID agli Atlassian Cloud nella sezione Mappatura degli attributi. L'attributo del nome visualizzato viene usato per abbinare i gruppi di Atlassian Cloud con i tuoi gruppi di Microsoft Entra. Selezionare il pulsante Salva per confermare le modifiche.

    Attributo	TIPO
    nome visualizzato	Stringa
    Id esterno	Stringa
    Membri	Riferimento

13. Per configurare i filtri di ambito, vedere le istruzioni seguenti fornite nell'articolo Filtro di ambito.

14. Per abilitare il servizio di provisioning Microsoft Entra per Atlassian Cloud, impostare Stato del provisioning su Attivato nella sezione Impostazioni.

    

15. Definire gli utenti e/o i gruppi di cui si vuole eseguire il provisioning in Atlassian Cloud scegliendo i valori desiderati in Ambito nella sezione Impostazioni .

    

16. Quando sei pronto a configurare, seleziona Salva.

    

L'operazione avvia la sincronizzazione iniziale di tutti gli utenti e/o i gruppi definiti in Ambito nella sezione Impostazioni. La sincronizzazione iniziale richiede più tempo rispetto alle sincronizzazioni successive, che si verificano approssimativamente ogni 40 minuti, purché il servizio di provisioning di Microsoft Entra sia in esecuzione.

Passaggio 6: Monitorare la distribuzione

Dopo aver configurato il provisioning, usare le risorse seguenti per monitorare la distribuzione:

1. Usare i log di provisioning per determinare gli utenti di cui è stato eseguito il provisioning correttamente o in modo non riuscito
2. Controllare la barra di progresso per visualizzare lo stato del ciclo di provisioning e quanto vicino è al completamento.
3. Se la configurazione del provisioning sembra essere in cattivo stato, l'applicazione entra in quarantena. Per saperne di più sugli stati di quarantena, consulta l'articolo relativo al provisioning delle applicazioni con stato di quarantena.

Limitazioni dei connettori

• Atlassian Cloud supporta solo gli aggiornamenti di provisioning per gli utenti con domini verificati. Le modifiche apportate agli utenti da un dominio non verificato non vengono push in Atlassian Cloud. Altre informazioni sui domini verificati di Atlassian sono disponibili qui.
• Atlassian Cloud non supporta attualmente la ridenominazione dei gruppi. Ciò significa che le modifiche apportate al displayName di un gruppo in Microsoft Entra ID non vengono aggiornate e riflesse in Atlassian Cloud.
• Il valore dell'attributo utente di posta elettronica in Microsoft Entra ID viene popolato solo se l'utente dispone di una cassetta postale di Microsoft Exchange. Se l'utente non ne ha uno, è consigliabile eseguire il mapping di un attributo desiderato diverso all'attributo di posta elettronica in Atlassian Cloud.

Log delle modifiche

• 15/06/2020 - Aggiunto il supporto per PATCH in blocco per i gruppi.
• 21/04/2021 - Aggiunta del supporto per l'individuazione dello schema.
• 14/10/2022 - Limitazioni aggiornate del connettore.

Risorse aggiuntive

• Gestione della creazione degli account utente per le applicazioni aziendali
• Che cos'è l'accesso alle applicazioni e Single Sign-On con Microsoft Entra ID?

Contenuto correlato

• Informazioni su come esaminare i log e ottenere i report sull'attività di fornitura