Condividi tramite

Esercitazione: Integrazione dell'accesso SSO di Microsoft Entra con GitHub Enterprise Cloud - Enterprise Account

  • Articolo

Questa esercitazione descrive come configurare un'integrazione SAML di Microsoft Entra con un account GitHub Enterprise Cloud - Enterprise Account. Integrando GitHub Enterprise Cloud - Enterprise Account con Microsoft Entra ID, è possibile:

  • Controllare in Microsoft Entra ID quali utenti sono autorizzati ad accedere a un'istanza di GitHub Enterprise Account e a eventuali organizzazioni all'interno di Enterprise Account.

Prerequisiti

Per iniziare, sono necessari gli elementi seguenti:

Descrizione dello scenario

In questa esercitazione, si configurerà un'integrazione SAML per un account GitHub Enterprise Account e si testeranno l'autenticazione e l'accesso dei membri dell'organizzazione/azienda e del proprietario dell'account.

Nota

L'applicazione GitHub Enterprise Cloud - Enterprise Account non supporta l'abilitazione del provisioning SCIM automatico. Se è necessario configurare il provisioning per l'ambiente GitHub Enterprise Cloud, SAML deve essere configurato a livello di organizzazione e l'applicazione GitHub Enterprise Cloud - Organization Microsoft Entra deve essere invece usata. Se si configura un'integrazione del provisioning SAML e SCIM per un'azienda abilitata per Enterprise Managed User (EMU), è necessario usare l'applicazione GitHub Enterprise Managed User Microsoft Entra per le integrazioni SAML/Provisioning o l'applicazione GitHub Enterprise Managed User (OIDC) Microsoft Entra per le integrazioni OIDC/Provisioning.

  • GitHub Enterprise Cloud - Enterprise Account supporta l'accesso SSO avviato da SP e IDP.

Aggiunta di GitHub Enterprise Cloud - Enterprise Account dalla raccolta

Per configurare l'integrazione di GitHub Enterprise Cloud - Enterprise Account in Microsoft Entra ID, è necessario aggiungere GitHub Enterprise Cloud - Enterprise Account 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 GitHub Enterprise Cloud - Enterprise Account nella casella di ricerca.
  4. Selezionare GitHub Enterprise Cloud - Enterprise Account nel pannello 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 e seguire anche 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 Cloud - Enterprise Account

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

Per configurare e testare l'accesso SSO di Microsoft Entra con GitHub Enterprise Cloud - Enterprise Account, 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'account utente di Microsoft Entra e l'account utente di test all'app GitHub: per abilitare l'account utente e l'utente di test B.Simon per l'uso dell'accesso Single Sign-On di Microsoft Entra.
  2. Abilitare e testare SAML per Enterprise Account e le rispettive organizzazioni: per configurare le impostazioni dell'accesso Single Sign-On sul lato applicazione.
    1. Testare l'accesso Single Sign-On con un altro proprietario Enterprise Account o account membro dell'organizzazione: 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. Andare a Identità>Applicazioni>Applicazioni aziendali>GitHub Enterprise Cloud - Enterprise Account>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.

    Modificare la configurazione SAML di base

  5. Nella sezione Configurazione SAML di base seguire questa procedura:

    a. Nella casella di testo Identificatore (ID entità) digitare un URL nel formato seguente: https://github.com/enterprises/<ENTERPRISE-SLUG>

    b. Nella casella di testo URL di risposta digitare un URL nel formato seguente: https://github.com/enterprises/<ENTERPRISE-SLUG>/saml/consume

  6. Seguire questa procedura per configurare l'applicazione in modalità avviata da SP:

    Nella casella di testo URL di accesso digitare un URL nel formato seguente: https://github.com/enterprises/<ENTERPRISE-SLUG>/sso

    Nota

    Sostituire <ENTERPRISE-SLUG> con il nome effettivo di GitHub Enterprise Account.

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

    Collegamento di download del certificato

  8. Nella sezione Configura GitHub Enterprise Cloud - Enterprise Account copiare gli URL appropriati in base alle esigenze.

    Copiare gli URL di configurazione

Creare un utente di test di Microsoft Entra

In questa sezione verrà creato un utente di test denominato B.Simon nel portale di Azure.

  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 Microsoft Entra e l'account utente di test all'app GitHub

In questa sezione si abiliterà B.Simon e l'account utente all'uso dell'accesso Single Sign-On di Azure concedendo l'accesso a GitHub Enterprise Cloud - Enterprise Account.

  1. Accedere all'Interfaccia di amministrazione di Microsoft Entra almeno come Amministratore applicazione cloud.
  2. Andare a Identità>Applicazioni>Applicazioni aziendali>GitHub Enterprise Cloud - Enterprise Account.
  3. Nella pagina di panoramica dell'app trovare la sezione Gestione e selezionare Utenti e gruppi.
  4. Selezionare Aggiungi utente e quindi Utenti e gruppi nella finestra di dialogo Aggiungi assegnazione.
  5. Nella finestra di dialogo Utenti e gruppi selezionare B.Simon e il proprio account utente dall'elenco degli utenti e quindi fare clic sul pulsante Seleziona nella parte inferiore della schermata.
  6. 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".
  7. Nella finestra di dialogo Aggiungi assegnazione fare clic sul pulsante Assegna.

Abilitare e testare SAML per Enterprise Account e le rispettive organizzazioni

Per configurare l'accesso Single Sign-On sul lato GitHub Enterprise Cloud - Enterprise Account, seguire la procedura illustrata in questa documentazione di GitHub.

  1. Accedere a GitHub.com con un account utente proprietario di Enterprise Account.
  2. Copiare il valore dal campo Login URL nell'app e incollarlo nel campo Sign on URL nelle impostazioni SAML di GitHub Enterprise Account.
  3. Copiare il valore dal campo Azure AD Identifier nell'app e incollarlo nel campo Issuer nelle impostazioni SAML di GitHub Enterprise Account.
  4. Copiare i contenuti del file Certificato (Base64) scaricato nei passaggi precedenti dal portale di Azure e incollarli nel campo appropriato nelle impostazioni SAML di GitHub Enterprise Account.
  5. Fare clic su Test SAML configuration e confermare che è possibile eseguire l'autenticazione di GitHub Enterprise Account in Microsoft Entra ID.
  6. Quando il test ha esito positivo, salvare le impostazioni.
  7. Dopo l'esecuzione dell'autenticazione tramite SAML per la prima volta da GitHub Enterprise Account, verrà creata un'identità esterna collegata in GitHub Enterprise Account che associa l'account utente connesso di GitHub con l'account utente di Microsoft Entra.

Dopo l'abilitazione dell'accesso Single Sign-On SAML per l'account GitHub Enterprise, l'accesso Single Sign-On SAML sarà abilitato per impostazione predefinita per tutte le organizzazioni di proprietà dell'account Enterprise. Tutti i membri dovranno eseguire l'autenticazione usando l'accesso Single Sign-On SAML per ottenere l'accesso alle organizzazioni di cui sono membri e i proprietari di Enterprise Account dovranno eseguire l'autenticazione usando l'accesso Single Sign-On quando accedono a un'istanza di Enterprise Account.

Testare l'accesso Single Sign-On con un altro proprietario di Enterprise Account o account membro dell'organizzazione

Dopo la configurazione dell'integrazione SAML per GitHub Enterprise Account, applicabile anche alle organizzazioni di GitHub in Enterprise Account, gli altri proprietari di Enterprise Account assegnati all'app in Microsoft Entra ID dovrebbero riuscire a passare all'URL (https://github.com/enterprises/<enterprise account>) di GitHub Enterprise Account, eseguire l'autenticazione tramite SAML e accedere a criteri e impostazioni con GitHub Enterprise Account.

Un proprietario dell'organizzazione per un'organizzazione in un'istanza di Enterprise Account dovrebbe riuscire a invitare un utente a entrare nella propria organizzazione di GitHub. Accedere a GitHub.com con un account di tipo proprietario dell'organizzazione e seguire la procedura illustrata nell'articolo per invitare B.Simon nell'organizzazione. Sarà necessario creare un account utente di GitHub per B.Simon, se non ne esiste già uno.

Per testare l'accesso all'organizzazione di GitHub in Enterprise Account con l'account utente di test B.Simon:

  1. Invitare B.Simon a un'organizzazione in Enterprise Account come proprietario dell'organizzazione.
  2. Accedere a GitHub.com usando l'account utente da collegare all'account utente B.Simon di Microsoft Entra.
  3. Accedere all'ID Microsoft Entra usando l'account utente B.Simon.
  4. Passare all'organizzazione di GitHub. Deve essere chiesto all'utente di eseguire l'autenticazione tramite SAML. Dopo l'autenticazione SAML, B.Simon dovrebbe riuscire ad accedere alle risorse dell'organizzazione.

Passaggi successivi

Dopo aver configurato GitHub Enterprise Cloud - Enterprise Account, è 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.