Condividi tramite

Esercitazione: Integrazione dell'accesso Single Sign-On di Microsoft Entra con un'organizzazione GitHub Enterprise Cloud

  • Articolo

In questa esercitazione si apprenderà come integrare un'organizzazione GitHub Enterprise Cloud con Microsoft Entra ID. Integrando un'istanza di un'organizzazione GitHub Enterprise Cloud con Microsoft Entra ID, è possibile:

  • Controllare in Microsoft Entra ID chi può accedere all'organizzazione GitHub Enterprise Cloud.
  • Gestire l'accesso all'organizzazione GitHub Enterprise Cloud in un'unica posizione centrale.

Prerequisiti

Per iniziare, sono necessari gli elementi seguenti:

Descrizione dello scenario

In questa esercitazione, viene configurato e testato l'accesso Single Sign-On di Microsoft Entra in un ambiente di test.

Per configurare l'integrazione di GitHub in Microsoft Entra ID è necessario aggiungere GitHub 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 nella casella di ricerca.
  4. Selezionare GitHub Enterprise Cloud - Organization 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, nonché esaminare la configurazione dell'accesso SSO. Altre informazioni sulle procedure guidate di Microsoft 365.

Configurare e testare l'accesso Single Sign-On di Microsoft Entra per GitHub

Configurare e testare l'accesso SSO di Microsoft Entra con GitHub usando un utente di test di nome B.Simon. Per il corretto funzionamento dell'accesso Single Sign-On è necessario stabilire una relazione di collegamento tra un utente di Microsoft Entra e l'utente correlato in GitHub.

Per configurare e testare l'accesso SSO di Microsoft Entra con GitHub, seguire questa procedura:

  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: per configurare le impostazioni di Single Sign-On sul lato applicazione.
    1. Creare l'utente di test di GitHub: per avere una controparte di B.Simon in GitHub 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. Andare a Identità>Applicazioni>Applicazioni aziendali>GitHub>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 immettere i valori per i campi seguenti:

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

    b. Nella casella di testo URL di risposta digitare un URL nel formato seguente: https://github.com/orgs/<Organization ID>/saml/consume

    c. Nella casella di testo URL di accesso digitare un URL nel formato seguente: https://github.com/orgs/<Organization ID>/sso

    Nota

    Si noti che questi non sono i valori reali. È necessario aggiornare questi valori con l'identificatore, l'URL di risposta e l'URL di accesso effettivi. In questo caso, è consigliabile di usare il valore univoco della stringa nell'identificatore. Passare alla sezione Admin di GitHub per recuperare questi valori.

  6. L'applicazione GitHub 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, mentre l'identificatore utente univoco (ID nome) è mappato a user.userprincipalname. L'applicazione GitHub prevede che Identificatore utente univoco (ID nome) sia associato a user.mail, di conseguenza è necessario modificare il mapping dell'attributo. A questo scopo, fare clic sull'icona Modifica e modificare il mapping dell'attributo.

    Screenshot che mostra la sezione

  7. Nella pagina Configura l'accesso Single Sign-On con SAML, nella sezione Certificato di firma SAML, fare clic su Scarica per scaricare il Certificato (Base64) definito dalle opzioni specificate in base ai propri requisiti e salvarlo in questo computer.

    Collegamento di download del certificato

  8. Nella sezione Configura GitHub copiare gli URL appropriati in base alle proprie esigenze.

    Copiare gli URL di configurazione

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 inserire B.Simon.
    2. Nel campo Nome 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.

  1. Accedere all'Interfaccia di amministrazione di Microsoft Entra almeno come Amministratore applicazione cloud.

  2. Andare a Identità>Applicazioni>Applicazioni aziendali>GitHub.

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

    ruolo utente

  7. Nella finestra di dialogo Aggiungi assegnazione fare clic sul pulsante Assegna.

Configurare l'accesso Single Sign-On di GitHub

  1. In un'altra finestra del Web browser accedere al sito aziendale di GitHub come amministratore.

  2. Passare a Settings (Impostazioni) e fare clic su Security (Sicurezza).

    Screenshot che mostra il menu

  3. Selezionare la casella Enable SAML authentication (Abilita autenticazione SAML) per visualizzare i campi di configurazione dell'accesso Single Sign-On, quindi seguire questa procedura:

    Screenshot che mostra la sezione

    a. Copiare il valore di URL di accesso SSO e incollarlo nella casella di testo URL di accesso nella sezione Configurazione SAML di base.

    b. Copiare il valore di URL del servizio consumer di asserzione e incollarlo nella casella di testo URL di risposta nella sezione Configurazione SAML di base.

  4. Configurare i campi seguenti:

    Screenshot che mostra le caselle di testo

    a. Nella casella di testo URL di accesso, incollare il valore di URL di accesso copiato in precedenza.

    b. Nella casella di testo Autorità di certificazione incollare il valore di Identificatore Microsoft Entra copiato in precedenza.

    c. Aprire il certificato scaricato nel Blocco note dal portale di Azure e incollarne il contenuto nella casella di testo Certificato pubblico.

    d. Fare clic sull'icona Modifica icona per modificare Metodo di firma e Metodo digest da RSA-SHA1 e SHA1alla RSA-SHA256 e SHA256 come illustrato di seguito.

    e. Aggiornare l'URL del servizio consumer di asserzione (URL di risposta) dall'URL predefinito in modo che l'URL in GitHub corrisponda all'URL nella registrazione dell'app di Azure.

    Schermata che mostra l'immagine.

  5. Fare clic su Test SAML configuration (Test configurazione SAML) per confermare l'assenza di errori di convalida o errori durante l'accesso SSO.

    Screenshot che mostra le impostazioni.

  6. Fare clic su Salva

Nota

L'accesso Single Sign-On in GitHub esegue l'autenticazione in un'organizzazione specifica in GitHub e non sostituisce l'autenticazione di GitHub. Pertanto, se la sessione github.com dell'utente è scaduta, potrebbe essere richiesto di eseguire l'autenticazione con l'ID/la password GitHub durante il processo di accesso Single Sign-On.

Creare l'utente di test di GitHub

Questa sezione descrive come creare un utente chiamato Britta Simon in GitHub. GitHub supporta il provisioning utenti automatico, che è abilitato per impostazione predefinita. Altri dettagli su come configurare il provisioning utenti automatico sono disponibili qui.

Per creare un utente manualmente, seguire questa procedura:

  1. Accedere al sito aziendale di GitHub come amministratore.

  2. Fare clic su Persone.

    Screenshot che mostra il sito GitHub con l'opzione People selezionata.

  3. Fare clic su Invite member (Invita membro).

    Screenshot che mostra l'opzione Invita utenti.

  4. Nella finestra di dialogo Invite member (Invita membro) seguire questa procedura:

    a. Nella casella di testo Email (Posta elettronica) digitare l'indirizzo di posta elettronica dell'account di Britta Simon.

    Screenshot che mostra l'opzione Invita persone.

    b. Fare clic su Send Invitation (Invia invito).

    Screenshot che mostra la pagina

    Nota

    Il titolare dell'account Microsoft Entra riceverà un messaggio di posta elettronica con un collegamento da selezionare per confermare l'account e attivarlo.

Testare l'accesso SSO

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

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

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

  • È possibile usare App personali Microsoft. Quando si fa clic sul riquadro di GitHub in App personali, verrà eseguito il reindirizzamento all'URL di accesso di GitHub. Per altre informazioni su App personali, vedere l'introduzione ad App personali.

Passaggi successivi

Dopo aver configurato GitHub, è 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 della sessione con Microsoft Defender for Cloud Apps.