Freigeben über

Tutorial: Integration des einmaligen Anmeldens (SSO) von Microsoft Entra mit einer GitHub Enterprise Cloud-Organisation

  • Artikel

In diesem Tutorial erfahren Sie, wie Sie eine GitHub Enterprise Cloud Organization in Microsoft Entra ID integrieren. Die Integration einer GitHub Enterprise Cloud-Organisation mit Microsoft Entra ID ermöglicht Folgendes:

  • Steuern Sie in Microsoft Entra ID, wer Zugriff auf Ihre GitHub Enterprise Cloud-Organisation hat.
  • Verwalten Sie den Zugriff auf Ihre GitHub Enterprise Cloud-Organisation an einem zentralen Ort.

Voraussetzungen

Für die ersten Schritte benötigen Sie Folgendes:

Beschreibung des Szenarios

In diesem Tutorial konfigurieren und testen Sie das einmalige Anmelden von Microsoft Entra in einer Testumgebung.

Um die Integration von GitHub mit Microsoft Entra ID zu konfigurieren, müssen Sie GitHub aus dem Katalog Ihrer Liste der verwalteten SaaS-Apps hinzufügen.

  1. Melden Sie sich beim Microsoft Entra Admin Center mindestens als Cloudanwendungsadministrator an.
  2. Navigieren Sie zu Identität>Anwendungen>Unternehmensanwendungen>Neue Anwendung.
  3. Geben Sie im Abschnitt Aus Katalog hinzufügen den Suchbegriff GitHub in das Suchfeld ein.
  4. Wählen Sie im Ergebnisbereich GitHub Enterprise Cloud - Organization aus, und fügen Sie dann die App hinzu. Warten Sie einige Sekunden, während die App Ihrem Mandanten hinzugefügt wird.

Alternativ können Sie auch den Enterprise App Configuration Wizard verwenden. Mit diesem Assistenten können Sie Ihrem Mandanten eine Anwendung hinzufügen, der App Benutzer/Gruppen hinzufügen, Rollen zuweisen sowie die SSO-Konfiguration durchlaufen. Erfahren Sie mehr über Microsoft 365-Assistenten.

Konfigurieren und Testen des einmaligen Anmeldens (SSO) von Microsoft Entra für GitHub

Konfigurieren und testen Sie das einmalige Anmelden von Microsoft Entra mit GitHub mithilfe einer Testbenutzerin mit dem Namen B. Simon. Damit SSO funktioniert, muss eine Linkbeziehung zwischen einem Microsoft Entra-Benutzer und dem entsprechenden Benutzer in GitHub eingerichtet werden.

Führen Sie zum Konfigurieren und Testen des einmaligen Anmeldens von Microsoft Entra mit GitHub die folgenden Schritte aus:

  1. Konfigurieren des einmaligen Anmeldens von Microsoft Entra, um Ihren Benutzer*innen die Verwendung dieses Features zu ermöglichen.
    1. Erstellen Sie einen Microsoft Entra-Testbenutzer, um Microsoft Entra-SSO mit dem Testbenutzer B. Simon zu testen.
    2. Zuweisen der Microsoft Entra-Testbenutzerin, um B.Simon die Verwendung des einmaligen Anmeldens von Microsoft Entra zu ermöglichen.
  2. Konfigurieren des einmaligen Anmeldens für GitHub , um die Einstellungen für einmaliges Anmelden auf der Anwendungsseite zu konfigurieren
    1. Erstellen einer GitHub-Testbenutzerin, um eine Entsprechung von B. Simon in GitHub zu erhalten, die mit ihrer Darstellung in Microsoft Entra verknüpft ist.
  3. Testen des einmaligen Anmeldens , um zu überprüfen, ob die Konfiguration funktioniert

Konfigurieren des einmaligen Anmeldens (SSO) von Microsoft Entra

Gehen Sie wie folgt vor, um das einmalige Anmelden von Microsoft Entra zu aktivieren.

  1. Melden Sie sich beim Microsoft Entra Admin Center mindestens als Cloudanwendungsadministrator an.

  2. Navigieren Sie zu Identität>Anwendungen>Unternehmensanwendungen>GitHub>Einmaliges Anmelden.

  3. Wählen Sie auf der Seite SSO-Methode auswählen die Methode SAML aus.

  4. Klicken Sie auf der Seite Einmaliges Anmelden (SSO) mit SAML einrichten auf das Stiftsymbol für Grundlegende SAML-Konfiguration, um die Einstellungen zu bearbeiten.

    Bearbeiten der SAML-Basiskonfiguration

  5. Geben Sie im Abschnitt Grundlegende SAML-Konfiguration die Werte für die folgenden Felder ein:

    a. Geben Sie im Textfeld Bezeichner (Entitäts-ID) eine URL im folgenden Format ein: https://github.com/orgs/<Organization ID>.

    b. Geben Sie im Textfeld Antwort-URL eine URL im folgenden Format ein: https://github.com/orgs/<Organization ID>/saml/consume

    c. Geben Sie im Textfeld Anmelde-URL eine URL im folgenden Format ein: https://github.com/orgs/<Organization ID>/sso.

    Hinweis

    Hinweis: Hierbei handelt es sich um Beispielwerte. Sie müssen diese Werte durch den tatsächlichen Bezeichner und die tatsächliche Antwort- und Abmelde-URL ersetzen. Hier empfehlen wir Ihnen, den eindeutigen Wert der Zeichenfolge im Bezeichner zu verwenden. Navigieren Sie zum Abschnitt „GitHub Admin“ (GitHub-Verwaltung), um diese Werte abzurufen.

  6. Die GitHub-Anwendung erwartet die SAML-Assertionen in einem bestimmten Format. Daher müssen Sie Ihrer Konfiguration der SAML-Tokenattribute benutzerdefinierte Attributzuordnungen hinzufügen. Der folgende Screenshot zeigt die Liste der Standardattribute, wobei Eindeutiger Benutzerbezeichner (Namens-ID) hier user.userprincipalname zugeordnet wird. Die GitHub-Anwendung erwartet, dass Eindeutiger Benutzerbezeichner (Namens-ID) der Wert user.mail zugeordnet ist. Sie müssen die Attributzuordnung daher bearbeiten, indem Sie auf das Symbol Bearbeiten klicken und die Zuordnung entsprechend ändern.

    Screenshot: Abschnitt „User Attributes“ (Benutzerattribute) mit dem Symbol „Bearbeiten“ ausgewählt

  7. Klicken Sie auf der Seite Einmaliges Anmelden (SSO) mit SAML einrichten im Abschnitt SAML-Signaturzertifikat auf Herunterladen, um das Ihrer Anforderung entsprechende Zertifikat (Base64) aus den angegebenen Optionen herunterzuladen und auf Ihrem Computer zu speichern.

    Downloadlink für das Zertifikat

  8. Kopieren Sie im Abschnitt GitHub einrichten die entsprechenden URLs gemäß Ihren Anforderungen.

    Kopieren der Konfiguration-URLs

Erstellen einer Microsoft Entra-Testbenutzerin

In diesem Abschnitt erstellen Sie einen Testbenutzer mit dem Namen B. Simon.

  1. Melden Sie sich beim Microsoft Entra Admin Center mindestens als Benutzeradministrator an.
  2. Browsen Sie zu Identität>Benutzer>Alle Benutzer.
  3. Wählen Sie oben auf dem Bildschirm Neuer Benutzer>Neuen Benutzer erstellen aus.
  4. Führen Sie unter den Eigenschaften für Benutzer die folgenden Schritte aus:
    1. Geben Sie im Feld Anzeigename den Namen B.Simon ein.
    2. Geben Sie im Feld Benutzerprinzipalname ein username@companydomain.extension. Beispiel: B.Simon@contoso.com.
    3. Aktivieren Sie das Kontrollkästchen Kennwort anzeigen, und notieren Sie sich den Wert aus dem Feld Kennwort.
    4. Klicken Sie auf Überprüfen + erstellen.
  5. Klicken Sie auf Erstellen.

Zuweisen der Microsoft Entra-Testbenutzerin

In diesem Abschnitt ermöglichen Sie B. Simon die Verwendung des einmaligen Anmeldens, indem Sie ihr Zugriff auf GitHub gewähren.

  1. Melden Sie sich beim Microsoft Entra Admin Center mindestens als Cloudanwendungsadministrator an.

  2. Navigieren Sie zu Identität>Anwendungen>Unternehmensanwendungen>GitHub.

  3. Navigieren Sie auf der Übersichtsseite der App zum Abschnitt Verwalten, und wählen Sie Benutzer und Gruppen aus.

  4. Wählen Sie Benutzer hinzufügen und anschließend im Dialogfeld Zuweisung hinzufügen die Option Benutzer und Gruppen aus.

  5. Wählen Sie im Dialogfeld Benutzer und Gruppen in der Liste „Benutzer“ den Eintrag B. Simon aus, und klicken Sie dann unten auf dem Bildschirm auf die Schaltfläche Auswählen.

  6. Wenn den Benutzern eine Rolle zugewiesen werden soll, können Sie sie im Dropdownmenü Rolle auswählen auswählen. Wurde für diese App keine Rolle eingerichtet, ist die Rolle „Standardzugriff“ ausgewählt.

    Benutzerrolle

  7. Klicken Sie im Dialogfeld Zuweisung hinzufügen auf die Schaltfläche Zuweisen.

Konfigurieren des einmaligen Anmeldens für GitHub

  1. Melden Sie sich in einem anderen Webbrowserfenster bei der GitHub-Organisationswebsite als Administrator an.

  2. Navigieren Sie zu Settings (Einstellungen), und klicken Sie auf Security (Sicherheit).

    Screenshot: GitHub-Menü „Organization settings“ (Organisationseinstellungen) mit ausgewählter Option „Security“ (Sicherheit)

  3. Aktivieren Sie das Kontrollkästchen Enable SAML authentication (SAML-Authentifizierung aktivieren), um die Felder für die Konfiguration des einmaligen Anmeldens anzuzeigen, und führen Sie die folgenden Schritte aus:

    Screenshot: Abschnitt „SAML Single Sign-On“ (Einmalige SAML-Anmeldung) mit aktiviertem Kontrollkästchen „Enable SAML authentication“ (SAML-Authentifizierung aktivieren) und hervorgehobenen URL-Textfeldern

    a. Kopieren Sie den Wert für single sign-on URL, und fügen Sie ihn unter Grundlegende SAML-Konfiguration im Textfeld Anmelde-URL ein.

    b. Kopieren Sie den Wert für assertion consumer service URL, und fügen Sie ihn im Abschnitt Grundlegende SAML-Konfiguration in das Textfeld Antwort-URL ein.

  4. Konfigurieren Sie die folgenden Felder:

    Screenshot: Textfelder „Anmelde-URL“, „Aussteller“ und „Öffentliches Zertifikat“

    a. Fügen Sie in das Textfeld Sign on URL den Wert für die Anmelde-URL ein, den Sie zuvor kopiert haben.

    b. Fügen Sie in das Textfeld Issuer (Aussteller) den Wert von Microsoft Entra-Bezeichner ein, den Sie zuvor kopiert haben.

    c. Öffnen Sie das aus dem Azure-Portal heruntergeladene Zertifikat im Editor, und fügen Sie es in das Textfeld Public Certificate (Öffentliches Zertifikat) ein.

    d. Klicken Sie auf das Symbol Bearbeiten, um die Signaturmethode und die Digestmethode von RSA-SHA1 und SHA1 in RSA-SHA256 und SHA256 wie unten gezeigt zu ändern.

    e. Aktualisieren Sie die standardmäßige Assertionsverbraucherdienst-URL (Antwort-URL) , sodass die URL auf GitHub mit der URL in der Azure-App-Registrierung übereinstimmt.

    Screenshot des Bildes.

  5. Klicken Sie auf Test SAML configuration (SAML-Konfiguration testen), um sich zu vergewissern, dass beim einmaligen Anmelden keine Validierungsfehler oder anderen Fehler auftreten.

    Screenshot, der die Einstellungen zeigt.

  6. Klicken Sie unten auf der Seite auf Speichern.

Hinweis

Einmaliges Anmelden auf GitHub führt die Authentifizierung für eine bestimmte Organisation in GitHub aus und ersetzt nicht die Authentifizierung von GitHub selbst. Wenn die github.com-Sitzung des Benutzers abgelaufen ist, werden Sie während des SSO-Prozesses möglicherweise aufgefordert, sich mit der ID und dem Kennwort für GitHub zu authentifizieren.

Erstellen eines GitHub-Testbenutzers

In diesem Abschnitt wird in GitHub eine Benutzerin namens Britta Simon erstellt. GitHub unterstützt die automatische Benutzerbereitstellung, die standardmäßig aktiviert ist. Weitere Details zur Konfiguration der automatischen Benutzerbereitstellung finden Sie hier.

Wenn Sie einen Benutzer manuell erstellen möchten, führen Sie die folgenden Schritte aus:

  1. Melden Sie sich bei der GitHub-Unternehmenswebsite als Administrator an.

  2. Klicken Sie auf People.

    Screenshot: GitHub-Website mit ausgewählter Option „People“ (Personen).

  3. Klicken Sie auf Invite member (Mitglied einladen).

    Screenshot: Benutzer einladen.

  4. Führen Sie auf der Dialogfeldseite Invite member (Mitglied einladen) die folgenden Schritte aus:

    a. Geben Sie im Textfeld E-Mail die E-Mail-Adresse des Kontos von Britta Simon ein.

    Screenshot: Personen einladen.

    b. Klicken Sie auf Einladung senden.

    Screenshot: Dialogfeldseite „Invite Member“ (Mitglied einladen) mit dem Kontrollkästchen „Member“ (Mitglied) aktiviert und hervorgehobener Schaltfläche „Send invitation“ (Einladung senden).

    Hinweis

    Der Besitzer oder die Besitzerin des Microsoft Entra-Kontos erhält eine E-Mail mit einem Link zur Bestätigung des Kontos, bevor es aktiv wird.

Testen des einmaligen Anmeldens

In diesem Abschnitt testen Sie die Microsoft Entra-Konfiguration für einmaliges Anmelden mit den folgenden Optionen.

  • Klicken Sie auf Diese Anwendung testen. Dadurch werden Sie zur Anmelde-URL von GitHub weitergeleitet, wo Sie den Anmeldeflow initiieren können.

  • Rufen Sie direkt die GitHub-Anmelde-URL auf, und initiieren Sie den Anmeldeflow.

  • Sie können „Meine Apps“ von Microsoft verwenden. Wenn Sie in „Meine Apps“auf die Kachel „GitHub“ klicken, werden Sie zur Anmelde-URL für GitHub weitergeleitet. Weitere Informationen zu „Meine Apps“ finden Sie in dieser Einführung.

Nächste Schritte

Nach dem Konfigurieren von GitHub können Sie die Sitzungssteuerung erzwingen, die in Echtzeit vor der Exfiltration und Infiltration vertraulicher Unternehmensdaten schützt. Die Sitzungssteuerung basiert auf bedingtem Zugriff. Erfahren Sie, wie Sie die Sitzungssteuerung mit Microsoft Defender for Cloud Apps erzwingen.