Esercitazione: Integrazione di Azure Active Directory con GitHub

Questa esercitazione descrive come integrare GitHub con Azure Active Directory (Azure AD).

L'integrazione di GitHub con Azure AD offre i vantaggi seguenti:

  • È possibile controllare in Azure AD chi può accedere a GitHub
  • È possibile abilitare gli utenti per l'accesso automatico a GitHub (Single Sign-On) con i propri account Azure AD
  • È possibile gestire gli account da una posizione centrale: il portale di gestione di Azure

Per altre informazioni sull'integrazione di app SaaS con Azure AD, vedere Informazioni sull'accesso alle applicazioni e Single Sign-On con Azure Active Directory.

Prerequisiti

Per configurare l'integrazione di Azure AD con GitHub, sono necessari gli elementi seguenti:

  • Sottoscrizione di Azure AD.
  • Sottoscrizione di GitHub abilitata per l'accesso Single Sign-On

Nota

Non è consigliabile usare un ambiente di produzione per testare i passaggi di questa esercitazione.

A questo scopo, è consigliabile seguire le indicazioni seguenti:

  • Non usare l'ambiente di produzione, a meno che non sia necessario.
  • Se non è disponibile un ambiente di prova di Azure AD, è possibile ottenere una versione di prova di un mese qui.

Descrizione dello scenario

In questa esercitazione viene eseguito il test dell'accesso Single Sign-On di Azure AD in un ambiente di test. Lo scenario descritto in questa esercitazione prevede i due blocchi predefiniti seguenti:

  1. Aggiunta di GitHub dalla raccolta
  2. Configurazione e test dell'accesso Single Sign-On di Azure AD

Per configurare l'integrazione di GitHub in Azure AD, è necessario aggiungere GitHub dalla raccolta al proprio elenco di app SaaS gestite.

Per aggiungere GitHub dalla raccolta, seguire questa procedura:

  1. Nel portale di gestione di Azure fare clic sull'icona di Azure Active Directory nel riquadro di spostamento sinistro.

    Active Directory

  2. Passare ad Applicazioni aziendali. Andare quindi a Tutte le applicazioni.

    Applicazioni

  3. Fare clic sul pulsante Aggiungi nella parte superiore della finestra di dialogo.

    Applicazioni

  4. Nella casella di ricerca digitare GitHub.com.

    Creazione di un utente test di Azure AD

  5. Nel pannello dei risultati selezionare GitHub e quindi fare clic sul pulsante Aggiungi per aggiungere l'applicazione.

    Creazione di un utente test di Azure AD

Configurazione e test dell'accesso Single Sign-On di Azure AD

In questa sezione viene configurato e testato l'accesso Single Sign-On di Azure AD con GitHub in base a un utente test di nome "Britta Simon".

Per il funzionamento dell'accesso Single Sign-On, Azure AD deve conoscere qual è l'utente di GitHub che corrisponde a un utente di Azure AD. In altre parole, deve essere stabilita una relazione di collegamento tra un utente di Azure AD e l'utente correlato in GitHub.

La relazione di collegamento viene stabilita assegnando il valore di nome utente in Azure AD come valore di Username in GitHub.

Per configurare e testare l'accesso Single Sign-On di Azure AD con GitHub, è necessario completare i blocchi predefiniti seguenti:

  1. Configurazione dell'accesso Single Sign-On di Azure AD : per abilitare gli utenti all'utilizzo di questa funzionalità.
  2. Creazione di un utente test di Azure AD : per testare l'accesso Single Sign-On di Azure AD con l'utente Britta Simon.
  3. Creazione di un utente test di GitHub: per avere una controparte di Britta Simon in GitHub collegata alla relativa rappresentazione in Azure AD.
  4. Assegnazione dell'utente test di Azure AD : per abilitare Britta Simon all'uso dell'accesso Single Sign-On di Azure AD.
  5. Testing Single Sign-On : per verificare se la configurazione funziona.

Configurazione dell'accesso Single Sign-On di Azure AD

In questa sezione viene abilitato l'accesso Single Sign-On di Azure AD nel portale di gestione di Azure e viene configurato l'accesso Single Sign-On nell'applicazione GitHub.

Per configurare Single Sign-On di Azure AD con GitHub, seguire questa procedura:

  1. Nella pagina di integrazione dell'applicazione GitHub del portale di gestione di Azure fare clic su Single Sign-On.

    Configura accesso Single Sign-On

  2. Nella finestra di dialogo Single Sign-On in Modalità selezionare Accesso basato su SAML per abilitare l'accesso Single Sign-On.

    Configura accesso Single Sign-On

  3. Nella sezione URL e dominio GitHub seguire questa procedura:

    Configura accesso Single Sign-On

    a. Nella casella di testo URL di accesso digitare il valore come: https://github.com/orgs/<entity-id>/sso

    b. Nella casella di testo Identificatore digitare l'URL adottando il modello seguente: https://github.com/orgs/<entity-id>

    Nota

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

  4. Nella sezione User Attributes (Attributi utente) selezionare User Identifier (Identificatore utente) come user.mail.

    Configura accesso Single Sign-On

  5. Nella sezione Certificato di firma SAML fare clic su Crea nuovo certificato.

    Configura accesso Single Sign-On

  6. Nella finestra di dialogo Crea nuovo certificato fare clic sull'icona del calendario e selezionare una data di scadenza. Fare quindi clic sul pulsante Salva.

    Configura accesso Single Sign-On

  7. Nella sezione Certificato di firma SAML selezionare Make new certificate active (Rendi attivo il nuovo certificato) e fare clic sul pulsante Salva.

    Configura accesso Single Sign-On

  8. Nella finestra popup Rollover certificate (Certificato di rollover) fare clic su OK.

    Configura accesso Single Sign-On

  9. Nella sezione Certificato di firma SAML fare clic su Certificato (Base64) e quindi salvare il file del certificato nel computer.

    Configura accesso Single Sign-On

  10. Nella sezione GitHub Configuration (Configurazione GitHub) fare clic su Configure GitHub (Configura GitHub) per aprire la finestra Configura accesso.

    Configura accesso Single Sign-On

    Configura accesso Single Sign-On

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

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

    Impostazioni

  13. Selezionare la casella Enable SAML authentication (Abilita autenticazione SAML) mostrando i campi di configurazione dell'accesso Single Sign-On. Usare quindi il valore URL di Single Sign-On per aggiornare l'URL di Single Sign-On nella configurazione di Azure AD.

    Impostazioni

  14. Configurare i campi seguenti:

    a. URL di accesso: immettere il SAML Single Sign-On Service URL (URL servizio Single Sign-On SAML) nella sezione Configura GitHub in Azure AD

    b. Autorità di certificazione: immettere l'ID entità SAML dalla sezione Configura GitHub in Azure AD

    c. Public Certificate (Certificato pubblico): aprire il certificato scaricato da Azure AD in blocco note e copiare il contenuto incluso tra "BEGIN CERTIFICATE" ed "END CERTIFICATE".

    Impostazioni

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

    Impostazioni

  16. Fare clic su Save

Creazione di un utente test di Azure AD

Questa sezione descrive come creare un utente test chiamato Britta Simon nel portale di gestione di Azure.

Creare un utente di Azure AD

Per creare un utente test in Azure AD, eseguire la procedura seguente:

  1. Nel portale di gestione di Azure fare clic sull'icona di Azure Active Directory nel riquadro di spostamento sinistro.

    Creazione di un utente test di Azure AD

  2. Andare a Utenti e gruppi e fare clic su Tutti gli utenti per visualizzare l'elenco di utenti.

    Creazione di un utente test di Azure AD

  3. Nella parte superiore della finestra di dialogo fare clic su Aggiungi per aprire la finestra di dialogo Utente.

    Creazione di un utente test di Azure AD

  4. Nella pagina della finestra di dialogo Utente seguire questa procedura:

    Creazione di un utente test di Azure AD

    a. Nella casella di testo Nome digitare BrittaSimon.

    b. Nella casella di testo Nome utente digitare l'indirizzo di posta elettronica di BrittaSimon.

    c. Selezionare Mostra password e prendere nota del valore della Password.

    d. Fare clic su Crea.

Creazione di un utente test GitHub

Per consentire agli utenti di Azure AD di accedere a GitHub, è necessario eseguirne il provisioning in GitHub.
Nel caso di GitHub, il provisioning è un'attività manuale.

Per effettuare il provisioning di un account utente, seguire questa procedura:

  1. Accedere al sito aziendale di GitHub come amministratore.

  2. Fare clic su Persone.

    Persone

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

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

    Invitare persone

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

    Invitare persone

    Nota

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

Assegnazione dell'utente test di Azure AD

In questa sezione Britta Simon viene abilitata per l'uso di Single Sign-On di Azure concedendole l'accesso a GitHub.

Assegna utente

Per assegnare Britta Simon a GitHub, seguire questa procedura:

  1. Nel portale di gestione di Azure aprire la visualizzazione applicazioni, passare alla visualizzazione directory e andare ad Applicazioni aziendali, quindi fare clic su Tutte le applicazioni.

    Assegna utente

  2. Nell'elenco di applicazioni selezionare GitHub.com.

    Configura accesso Single Sign-On

  3. Scegliere Utenti e gruppi dal menu a sinistra.

    Assegna utente

  4. Fare clic sul pulsante Aggiungi. Selezionare quindi Utenti e gruppi nella finestra di dialogo Aggiungi assegnazione.

    Assegna utente

  5. Nella finestra di dialogo Utenti e gruppi selezionare Britta Simon nell'elenco Utenti.

  6. Fare clic sul pulsante Seleziona nella finestra di dialogo Utenti e gruppi.

  7. Fare clic sul pulsante Assegna nella finestra di dialogo Aggiungi assegnazione.

Test dell'accesso Single Sign-On

In questa sezione viene testata la configurazione dell'accesso Single Sign-On di Azure AD usando il pannello di accesso.

Quando si fa clic sul riquadro GitHub nel pannello di accesso, si dovrebbe accedere automaticamente all'applicazione GitHub. L'accesso avverrà con un account aziendale, ma è necessario accedere con l'account personale.

Risorse aggiuntive