Esercitazione: Integrazione dell'accesso SSO di Microsoft Entra con GitHub Enterprise Server

Questa esercitazione descrive come integrare GitHub Enterprise Server con Microsoft Entra ID. Integrando GitHub Enterprise Server con Microsoft Entra ID, è possibile:

• È possibile controllare in Microsoft Entra ID chi può accedere a GitHub Enterprise Server.
• Abilitare gli utenti per l'accesso automatico a GitHub Enterprise Server 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.
• GitHub Enterprise Server, pronto per l'inizializzazione.
• Insieme all'Amministratore di applicazioni cloud, anche l’Amministratore di applicazioni può aggiungere o gestire applicazioni in Microsoft Entra ID. Per altre informazioni, vedere Ruoli predefiniti di Azure.

Descrizione dello scenario

In questa esercitazione vengono eseguiti la configurazione e il test dell'accesso Single Sign-On di Microsoft Entra in un ambiente di testing.

• GitHub Enterprise Server supporta l'accesso SSO avviato da SP e IDP.
• GitHub Enterprise Server supporta il provisioning utenti Just in Time.
• GitHub Enterprise Server supporta il provisioning utenti automatico.

Aggiunta di GitHub Enterprise Server dalla raccolta

Per configurare l'integrazione di GitHub Enterprise Server in Microsoft Entra ID, è necessario aggiungere GitHub Enterprise Server dalla raccolta al proprio 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 GitHub Enterprise Server nella casella di ricerca.
4. Selezionare GitHub Enterprise Server nel pannello dei risultati, 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.

Configurare e testare l'accesso SSO di Microsoft Entra per GitHub Enterprise Server

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

Per configurare e testare l'accesso SSO di Microsoft Entra con GitHub Enterprise Server, seguire questi passaggi:

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 GitHub Enterprise Server: per configurare le impostazioni di Single Sign-On sul lato applicazione.
   1. Creare un utente di test in GitHub Enterprise Server: per avere una controparte di B.Simon in GitHub Enterprise Server 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 almeno come Amministratore applicazione cloud.

2. Passare a Identità>Applicazioni>Applicazioni aziendali>GitHub Enterprise Server>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 per modificare le impostazioni di Configurazione SAML di base.

   

5. Nella sezione Configurazione SAML di base seguire questa procedura se si vuole configurare l'applicazione in modalità avviata da IDP:

   a. Nella casella di testo Identificatore (ID entità) digitare un URL nel formato seguente: https://<YOUR-GITHUB-ENTERPRISE-SERVER-HOSTNAME>

   b. Nella casella di testo URL di risposta digitare un URL nel formato seguente: https://<YOUR-GITHUB-ENTERPRISE-SERVER-HOSTNAME>/saml/consume

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

   Nella casella di testo URL di accesso digitare un URL nel formato seguente: https://<YOUR-GITHUB-ENTERPRISE-SERVER-HOSTNAME>/sso

   Nota

   Poiché questi non sono i valori reali, è necessario aggiornarli con l'identificatore, l'URL di risposta e l'URL di accesso effettivi. Per ottenere questi valori, contattare il team del supporto clienti di GitHub Enterprise Server. È anche possibile fare riferimento ai modelli illustrati nella sezione Configurazione SAML di base.

7. L'applicazione GitHub Enterprise Server 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.

   

8. Modificare attributi e attestazioni dell'utente.

9. Fare clic su Aggiungi nuova attestazione e immettere il nome come amministratore nella casella di testo (il valore amministratore fa distinzione tra maiuscole e minuscole).

10. Espandere Condizioni dell'attestazione e selezionare Membri da Tipo di utente.

11. Fare clic su Seleziona gruppi e cercare il Gruppo che si desidera includere questa attestazione, in cui i relativi membri devono essere amministratori per GHES.

12. Selezionare Attributo per Origine e immettere true (senza virgolette per Valore.

13. Fare clic su Salva.

    

    Nota

    Per conoscere le istruzioni su come aggiungere un'attestazione, seguire il collegamento.

14. 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.

    

15. Nella sezione Configura GitHub Enterprise Server copiare gli URL appropriati in base alle esigenze.

    

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 immettere B.Simon.
   2. Nel campo Nome dell’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 GitHub Enterprise Server.

1. Accedere all'Interfaccia di amministrazione di Microsoft Entra almeno come Amministratore applicazione cloud.
2. Andare a Identità>Applicazioni>Applicazioni aziendali>GitHub Enterprise Server.
3. Nella pagina di 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.

Configurare l'accesso SSO a GitHub Enterprise Server

Per configurare l'accesso SSO sul lato GitHub Enterprise Server, è necessario seguire le istruzioni menzionate qui.

Creare l'utente di test di GitHub Enterprise Server

In questa sezione, viene creato un utente di nome B.Simon in GitHub Enterprise Server. GitHub Enterprise Server supporta il provisioning utenti JIT, che è abilitato per impostazione predefinita. Non è necessario alcun intervento dell'utente in questa sezione. Se non esiste già un utente in GitHub Enterprise Server, ne viene creato uno nuovo dopo l'autenticazione.

GitHub Enterprise Server supporta anche il provisioning utenti automatico; qui è possibile trovare altre informazioni su come configurare il provisioning utenti automatico.

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:

• Facendo clic su Testa questa applicazione, verrà eseguito il reindirizzamento all'URL di accesso di GitHub Enterprise Server in cui è possibile avviare il flusso di accesso.

• Passare direttamente all'URL di accesso di GitHub Enterprise Server e avviare il flusso di accesso da questa posizione.

Avviato da IDP:

• Dopo aver fatto clic su Testa questa applicazione, si dovrebbe accedere automaticamente all'istanza di GitHub Enterprise Server 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 GitHub Enterprise Server 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 GitHub Enterprise Server per cui si è configurato l'accesso SSO. Per altre informazioni, vedere App personali Microsoft Entra.

Passaggi successivi

• Configurazione del provisioning utenti per l'azienda.

• Dopo aver configurato GitHub Enterprise Server, è 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 Microsoft Defender for Cloud Apps.