Condividi tramite

Configurare GitHub Enterprise Server per l'accesso Single Sign-On con Microsoft Entra ID

Questo articolo illustra come integrare GitHub Enterprise Server con Microsoft Entra ID. Integrando GitHub Enterprise Server con Microsoft Entra ID, è possibile:

  • Controllare in Microsoft Entra ID chi può accedere a GitHub Enterprise Server.
  • Consenti agli utenti di effettuare l'accesso automatico a GitHub Enterprise Server con i loro account Microsoft Entra.
  • Gestire gli account in un'unica posizione centrale.

Prerequisiti

Per iniziare, sono necessari gli elementi seguenti:

  • Sottoscrizione di Microsoft Entra. Se non si ha una sottoscrizione, è possibile ottenere un account gratuito .
  • GitHub Enterprise Server, pronto per l'inizializzazione.
  • Insieme all'amministratore di applicazioni cloud, l'amministratore dell'applicazione può anche aggiungere o gestire applicazioni in Microsoft Entra ID. Per altre informazioni, vedere Ruoli predefiniti di Azure.

Descrizione dello scenario

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

  • GitHub Enterprise Server supporta l'accesso SSO avviato da SP e IDP .
  • GitHub Enterprise Server supporta il provisioning degli utenti Just In Time.
  • GitHub Enterprise Server supporta l'approvvigionamento automatizzato degli utenti.

Annotazioni

L'applicazione GitHub Enterprise Server attualmente non supporta alcuna piattaforma cloud per enti pubblici.

Per configurare l'integrazione di GitHub Enterprise Server in Microsoft Entra ID, è necessario aggiungere GitHub Enterprise Server dalla raccolta all'elenco di app SaaS gestite.

  1. Accedi al Microsoft Entra admin center come almeno un amministratore di applicazioni cloud.
  2. Naviga su Entra ID>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 e quindi aggiungere l'app. Attendere alcuni secondi mentre l'app viene aggiunta al tuo tenant.

In alternativa, è possibile usare la Configurazione Guidata per App Aziendale. In questa procedura guidata è possibile aggiungere un'applicazione al tenant, aggiungere utenti/gruppi all'app, assegnare ruoli e seguire anche la configurazione dell'accesso SSO. Scopri di più 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 questa procedura:

  1. Configurare Microsoft Entra SSO: 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 l'utente di test di GitHub Enterprise Server : per avere una controparte di B.Simon in GitHub Enterprise Server collegata alla rappresentazione dell'utente in Microsoft Entra.
  3. Testare SSO: per verificare se la configurazione funziona.

Configurare Single Sign-On di Microsoft Entra

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

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

  2. Passare a Entra ID>app aziendali>GitHub Enterprise Server>autenticazione singola.

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

  4. Nella pagina Configura accesso Single Sign-On con SAML, selezionare l'icona a forma di matita accanto a Configurazione SAML di Base per modificare le impostazioni.

    Screenshot mostra come modificare la Configurazione di Base di S A M L.

  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 usando il modello 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. Selezionare Imposta 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

    Annotazioni

    Questi valori non sono reali. Aggiornare questi valori con l'identificatore effettivo, l'URL di risposta e l'URL di accesso. Per ottenere questi valori, contattare il team di 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.

    Screenshot che mostra l'immagine dell'applicazione Enterprise Server.

  8. Modifica attributi utente e attestazioni.

  9. Selezionare Aggiungi nuova attestazione e immettere il nome come administrator nella casella di testo (il valore fa distinzione tra administrator maiuscole e minuscole).

  10. Espandi Condizioni attestazione e seleziona Membri dal Tipo di utente.

  11. Seleziona gruppi e cerca il gruppo nel quale si desidera includere questa attestazione, dove i membri devono essere amministratori per GHES.

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

  13. Seleziona Salva.

    Screenshot che mostra la gestione dei claim per gli attributi.

  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.

    Screenshot che mostra il collegamento per scaricare il certificato.

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

    Lo screenshot mostra come copiare l'URL di configurazione appropriata.

Creare e assegnare l'utente di test di Microsoft Entra

Segui le linee guida nel quickstart per creare e assegnare un account utente per creare un account di test chiamato B.Simon.

Configurare l'accesso Single Sign-On di GitHub Enterprise Server

Per configurare l'accesso SSO sul lato GitHub Enterprise Server, è necessario seguire le istruzioni indicate 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 c'è alcun elemento d'azione per te 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 automatico degli utenti. Puoi trovare maggiori dettagli qui su come configurare il provisioning automatico degli utenti.

Testare la funzionalità SSO

In questa sezione viene testata la configurazione dell'accesso Single Sign-On di Microsoft Entra con le opzioni seguenti.

Inizializzato da SP:

  • Selezionare Test this application (Testa questa applicazione), questa opzione reindirizza 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.

IDP avviato:

  • Selezionare Test this application (Testa questa applicazione) e si dovrebbe accedere automaticamente all'istanza di GitHub Enterprise Server per cui si è configurato l'accesso SSO.

È anche possibile usare Microsoft My Apps per testare l'applicazione in qualsiasi modalità. Quando si seleziona il riquadro di GitHub Enterprise Server in App personali, se 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 GitHub Enterprise Server per cui si è configurato l'accesso SSO. Per altre informazioni, vedere Microsoft Entra My Apps.

Contenuti correlati

  • Last updated on