Configurare GitHub Enterprise Server per il provisioning utenti automatico con Microsoft Entra ID

Questo articolo descrive i passaggi da eseguire sia in GitHub Enterprise Server che in Microsoft Entra ID per configurare il provisioning utenti automatico. Se configurato, Microsoft Entra ID effettua automaticamente il provisioning e il deprovisioning di utenti e/o gruppi in GitHub Enterprise Server usando il servizio di provisioning Microsoft Entra. Per informazioni importanti sul funzionamento di questo servizio e sulle domande frequenti, vedere Automatizzare il provisioning e il deprovisioning degli utenti nelle applicazioni SaaS con Microsoft Entra ID.

Capacità supportate

• Creare utenti in GitHub Enterprise Server
• Rimuovere gli utenti in GitHub Enterprise Server quando non richiedono più l'accesso
• Mantenere sincronizzati gli attributi utente tra Microsoft Entra ID e GitHub Enterprise Server
• Effettuare il provisioning di gruppi e appartenenze a gruppi in GitHub Enterprise Server
• Accesso Single Sign-On a GitHub Enterprise Server (scelta consigliata)

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.

• GitHub Enterprise Server, completamente inizializzato e configurato per l'accesso con SAML SSO tramite il tenant di Microsoft Entra.

Passaggio 1: Pianificare la distribuzione dell'approvvigionamento

1. Scopri di più su come funziona il servizio di provisioning.
2. Determinare chi è incluso nell'ambito per l'approvvigionamento.
3. Determinare quali dati eseguire il mapping tra Microsoft Entra ID e GitHub Enterprise Server.

Passaggio 2: Configurare GitHub Enterprise Server per supportare il provisioning con Microsoft Entra ID

Informazioni su come abilitare il provisioning per GitHub Enterprise Server qui.

Passaggio 3: Aggiungere GitHub Enterprise Server dalla raccolta di applicazioni Microsoft Entra

Aggiungere GitHub Enterprise Server dalla raccolta di applicazioni Microsoft Entra per iniziare a gestire il provisioning in GitHub Enterprise Server. Se GitHub Enterprise Server per l'accesso SSO è stato configurato in precedenza, è possibile usare la stessa applicazione. Tuttavia, è consigliabile creare un'app separata durante il test iniziale dell'integrazione. Altre informazioni sull'aggiunta di un'applicazione dalla raccolta sono disponibili 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 scegli di definire chi viene fornito alla tua app in base all'assegnazione, puoi usare la procedura per assegnare utenti e gruppi all'applicazione. Se si sceglie di definire l'ambito degli utenti a cui è stato fornito accesso esclusivamente in base 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: Configurare il provisioning utenti automatico in GitHub Enterprise Server

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

Per configurare il provisioning utenti automatico per GitHub Enterprise Server in Microsoft Entra ID:

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

2. Passare alle app Entra ID>Enterprise

   

3. Nell'elenco delle applicazioni selezionare GitHub Enterprise Server.

   

4. Selezionare la scheda Provisioning.

   

5. Impostare Modalità di provisioning su Automatico.

   

6. Nella sezione Credenziali amministratore immettere l'URL del tenant di GitHub Enterprise Server e il token segreto. I valori dei campi sono nel formato seguente:

   • URL tenant: https://<your-github-server-domain>/api/v3/scim
   • Token segreto: token di accesso personale creato per l'account di provisioning nell'istanza di GitHub Enterprise Server.

   Selezionare Test connessione per assicurarsi che Microsoft Entra ID possa connettersi a GitHub Enterprise Server. Se la connessione non riesce, verificare che l'account GitHub Enterprise Server 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 di un gruppo che deve ricevere le notifiche di errore di provisioning e selezionare la casella di controllo Invia una notifica di posta elettronica quando si verifica un errore .

   

8. Seleziona Salva.

9. Nella sezione Mapping selezionare ProvisionIng Microsoft Entra ID Users (ProvisionIng Microsoft Entra ID Users).

10. Esaminare gli attributi utente sincronizzati da Microsoft Entra ID a GitHub Enterprise Server nella sezione Mapping attributi . Gli attributi selezionati come proprietà corrispondenti vengono usati per trovare le corrispondenze con gli account utente in GitHub Enterprise Server per le operazioni di aggiornamento. Se si sceglie di modificare l'attributo di destinazione corrispondente, è necessario assicurarsi che l'API Di GitHub Enterprise Server supporti il filtro degli utenti in base a tale attributo. Selezionare il pulsante Salva per confermare le modifiche.

    Attribute	TIPO
    userName	String
    externalId	String
    emails[type eq "work"].value	String
    active	Boolean
    name.givenName	String
    name.familyName	String
    name.formatted	String
    displayName	String

11. Nella sezione Mapping selezionare ProvisionIng Microsoft Entra ID Groups (ProvisionIng Microsoft Entra ID Groups).

12. Esaminare gli attributi del gruppo sincronizzati da Microsoft Entra ID a GitHub Enterprise Server nella sezione Mapping attributi . Gli attributi selezionati come proprietà corrispondenti vengono usati per trovare le corrispondenze con i gruppi in GitHub Enterprise Server per le operazioni di aggiornamento. Selezionare il pulsante Salva per confermare le modifiche.

    Attribute	TIPO
    displayName	String
    externalId	String
    members	Reference

13. Per configurare i filtri di ambito, vedere le istruzioni seguenti fornite nell'articolo Definizione dell'ambito del filtro.

14. Per abilitare il servizio di provisioning Microsoft Entra per GitHub Enterprise Server, impostare Stato del provisioning su Sì nella sezione Impostazioni .

    

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

    

16. Quando sei pronto a configurare, seleziona Salva.

    

Questa operazione avvia il ciclo di sincronizzazione iniziale di tutti gli utenti e/o i gruppi definiti in Ambito nella sezione Impostazioni . Il ciclo iniziale richiede più tempo rispetto ai cicli successivi, 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 sia al completamento.
3. Se la configurazione del provisioning sembra essere in cattivo stato, l'applicazione entra in quarantena. Ulteriori informazioni sugli stati di quarantena sono disponibili nell'articolo sullo stato di quarantena del provisioning delle applicazioni.

Log delle modifiche

• 18/02/2021 - Aggiunta del supporto per il provisioning dei gruppi.
• 19/08/2025 - Collegamenti aggiornati e menzioni di "GitHub AE" a "GitHub Enterprise Server" per riflettere il nome del prodotto corrente.

Risorse aggiuntive

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

Contenuti correlati

• Scopri come esaminare i log e ottenere report sull'attività di distribuzione