Konfigurieren von GitHub Enterprise Server für die automatische Benutzerbereitstellung mit Microsoft Entra-ID

In diesem Artikel werden die Schritte beschrieben, die Sie in GitHub Enterprise Server und Microsoft Entra ID ausführen müssen, um die automatische Benutzerbereitstellung zu konfigurieren. Bei der Konfiguration stellt Die Microsoft Entra-ID Benutzer und/oder Gruppen automatisch mithilfe des Microsoft Entra-Bereitstellungsdiensts auf GitHub Enterprise Server bereit. Wichtige Informationen dazu, was dieser Dienst tut, wie er funktioniert, und häufig gestellte Fragen finden Sie unter Automatisieren der Benutzerbereitstellung und -bereitstellung für SaaS-Anwendungen mit Microsoft Entra ID.

Unterstützte Funktionen

• Erstellen von Benutzern in GitHub Enterprise Server
• Entfernen von Benutzern in GitHub Enterprise Server, wenn sie keinen Zugriff mehr benötigen
• Synchronisieren von Benutzerattributen zwischen Microsoft Entra-ID und GitHub Enterprise Server
• Bereitstellen von Gruppen und Gruppenmitgliedschaften in GitHub Enterprise Server
• Einmaliges Anmelden bei GitHub Enterprise Server (empfohlen)

Voraussetzungen

In diesem Artikel wird davon ausgegangen, dass Sie bereits über die folgenden Voraussetzungen verfügen:

• Ein Microsoft Entra-Benutzerkonto mit einem aktiven Abonnement. Wenn Sie noch kein Konto besitzen, können Sie kostenlos ein Konto erstellen.
• Eine der folgenden Rollen:
  • Anwendungsadministrator
  • Cloudanwendungsadministrator
  • Anwendungsbesitzer.

• GitHub Enterprise Server, vollständig initialisiert und für die Anmeldung mit SAML SSO über Ihren Microsoft Entra-Mandanten konfiguriert.

Schritt 1: Planen Sie Ihren Bereitstellungsprozess

1. Erfahren Sie , wie der Bereitstellungsdienst funktioniert.
2. Identifizieren Sie, wer im Umfang der Bereitstellung enthalten ist.
3. Bestimmen Sie, welche Daten zwischen Microsoft Entra ID und GitHub Enterprise Server zugeordnet werden sollen.

Schritt 2: Konfigurieren von GitHub Enterprise Server zur Unterstützung der Bereitstellung mit Microsoft Entra ID

Hier erfahren Sie, wie Sie die Bereitstellung für GitHub Enterprise Server aktivieren.

Schritt 3: Hinzufügen von GitHub Enterprise Server aus dem Microsoft Entra-Anwendungskatalog

Fügen Sie GitHub Enterprise Server aus dem Microsoft Entra-Anwendungskatalog hinzu, um mit der Verwaltung der Bereitstellung auf GitHub Enterprise Server zu beginnen. Wenn Sie zuvor GitHub Enterprise Server für SSO eingerichtet haben, können Sie dieselbe Anwendung verwenden. Es wird jedoch empfohlen, beim anfänglichen Testen der Integration eine separate App zu erstellen. Weitere Informationen zum Hinzufügen einer Anwendung aus dem Katalog finden Sie hier.

Schritt 4: Definieren, wer in die Bereitstellung einbezogen werden soll

Mit dem Microsoft Entra-Bereitstellungsdienst können Sie festlegen, wer basierend auf der Zuweisung zur Anwendung oder basierend auf Attributen des Benutzers oder der Gruppe bereitgestellt wird. Wenn Sie sich dazu entscheiden, den Kreis der Benutzer und Gruppen, die Ihrer App basierend auf der Zuweisung zugeordnet werden, zu bestimmen, können Sie die Schritte zum Zuweisen von Benutzern und Gruppen zur Anwendung verwenden. Wenn Sie festlegen möchten, für wen die Bereitstellungen ausschließlich basierend auf den Attributen des Benutzers oder der Gruppe erfolgen, können Sie einen Bereichsfilter verwenden.

• Beginnen Sie klein. Testen Sie mit einer kleinen Anzahl von Benutzern und Gruppen, bevor Sie es auf alle anwenden. Wenn der Bereich für die Bereitstellung auf zugewiesene Benutzer und Gruppen festgelegt ist, können Sie dies steuern, indem Sie der App einen oder zwei Benutzer oder Gruppen zuweisen. Wenn der Bereich auf alle Benutzer und Gruppen festgelegt ist, können Sie einen attributbasierten Bereichsdefinitionsfilter angeben.

• Wenn Sie zusätzliche Rollen benötigen, können Sie das Anwendungsmanifest aktualisieren, um neue Rollen hinzuzufügen.

Schritt 5: Konfigurieren der automatischen Benutzerbereitstellung auf GitHub Enterprise Server

Dieser Abschnitt führt Sie durch die Schritte zum Konfigurieren des Microsoft Entra-Bereitstellungsdiensts zum Erstellen, Aktualisieren und Deaktivieren von Benutzern und/oder Gruppen in TestApp basierend auf Benutzer- und/oder Gruppenzuweisungen in Microsoft Entra ID.

So konfigurieren Sie die automatische Benutzerbereitstellung für GitHub Enterprise Server in der Microsoft Entra-ID:

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

2. Navigieren Sie zu Entra ID>Enterprise-Apps

   

3. Wählen Sie in der Anwendungsliste GitHub Enterprise Server aus.

   

4. Wählen Sie die Registerkarte "Bereitstellung" aus .

   

5. Legen Sie den Bereitstellungsmodus auf "Automatisch" fest.

   

6. Geben Sie im Abschnitt " Administratoranmeldeinformationen " Ihre GitHub Enterprise Server-Mandanten-URL und das geheime Token ein. Die Werte der Felder haben das folgende Format:

   • Mandanten-URL: https://<your-github-server-domain>/api/v3/scim
   • Geheimes Token: Das persönliche Zugriffstoken (PERSONAL Access Token, PAT), das Sie für das Bereitstellungskonto in Ihrer GitHub Enterprise Server-Instanz erstellt haben.

   Wählen Sie "Testverbindung" aus, um sicherzustellen, dass die Microsoft Entra-ID eine Verbindung mit GitHub Enterprise Server herstellen kann. Wenn die Verbindung fehlschlägt, stellen Sie sicher, dass Ihr GitHub Enterprise Server-Konto über Administratorberechtigungen verfügt, und versuchen Sie es erneut.

   

7. Geben Sie im Feld " Benachrichtigungs-E-Mail " die E-Mail-Adresse einer Person oder Gruppe ein, die die Bereitstellungsfehlerbenachrichtigungen erhalten soll, und aktivieren Sie das Kontrollkästchen " E-Mail-Benachrichtigung senden", wenn ein Fehler auftritt .

   

8. Wählen Sie Speichern aus.

9. Wählen Sie im Abschnitt "Zuordnungen " die Option "Microsoft Entra-ID-Benutzer bereitstellen" aus.

10. Überprüfen Sie die Benutzerattribute, die aus der Microsoft Entra-ID mit GitHub Enterprise Server synchronisiert werden, im Abschnitt "Attributzuordnung" . Die attribute, die als Übereinstimmende Eigenschaften ausgewählt wurden, werden verwendet, um mit den Benutzerkonten in GitHub Enterprise Server für Aktualisierungsvorgänge übereinzugleichen. Wenn Sie das übereinstimmende Zielattribute ändern möchten, müssen Sie sicherstellen, dass die GitHub Enterprise Server-API das Filtern von Benutzern basierend auf diesem Attribut unterstützt. Wählen Sie die Schaltfläche Speichern, um alle Änderungen zu übernehmen.

    Merkmal	Typ
    userName	String
    externalId	String
    emails[type eq "work"].value	String
    active	Boolean
    name.givenName	String
    name.familyName	String
    name.formatted	String
    displayName	String

11. Wählen Sie im Abschnitt "Zuordnungen " die Option "Microsoft Entra-ID-Gruppen bereitstellen" aus.

12. Überprüfen Sie die Gruppenattribute, die aus der Microsoft Entra-ID mit GitHub Enterprise Server synchronisiert werden, im Abschnitt "Attributzuordnung ". Die attribute, die als Übereinstimmende Eigenschaften ausgewählt wurden, werden verwendet, um mit den Gruppen in GitHub Enterprise Server für Aktualisierungsvorgänge übereinzugleichen. Wählen Sie die Schaltfläche Speichern, um alle Änderungen zu übernehmen.

    Merkmal	Typ
    displayName	String
    externalId	String
    members	Reference

13. Informationen zum Konfigurieren von Bereichsfiltern finden Sie in den folgenden Anweisungen im Bereichsfilterartikel.

14. Um den Microsoft Entra-Bereitstellungsdienst für GitHub Enterprise Server zu aktivieren, ändern Sie den Bereitstellungsstatus im Abschnitt "Einstellungen" in "Ein".

    

15. Definieren Sie die Benutzer und/oder Gruppen, die Sie auf GitHub Enterprise Server bereitstellen möchten, indem Sie die gewünschten Werte im Bereich im Abschnitt "Einstellungen" auswählen.

    

16. Wenn Sie zur Bereitstellung bereit sind, wählen Sie „Speichern“ aus.

    

Dieser Vorgang startet den anfänglichen Synchronisierungszyklus aller Benutzer und/oder Gruppen, die im Bereich im Abschnitt "Einstellungen" definiert sind. Der anfängliche Zyklus dauert länger als nachfolgende Zyklen, die ungefähr alle 40 Minuten auftreten, solange der Microsoft Entra-Bereitstellungsdienst ausgeführt wird.

Schritt 6: Überwachen der Bereitstellung

Nachdem Sie die Bereitstellung konfiguriert haben, verwenden Sie die folgenden Ressourcen, um Ihre Bereitstellung zu überwachen:

1. Verwenden Sie die Bereitstellungsprotokolle , um zu ermitteln, welche Benutzer erfolgreich oder erfolglos bereitgestellt werden.
2. Überprüfen Sie den Fortschrittsbalken, um den Status des Bereitstellungszyklus zu sehen und zu erfahren, wie nahe er an der Fertigstellung ist.
3. Wenn sich die Bereitstellungskonfiguration in einem fehlerhaften Zustand zu befinden scheint, wird die Anwendung unter Quarantäne gestellt. Weitere Informationen zum Quarantänestatus finden Sie im Artikel über den Anwendungsbereitstellungs-Quarantänestatus.

Änderungsprotokoll

• 02.18.2021 – Unterstützung für die Gruppenbereitstellung hinzugefügt.
• 08/19/2025 – Aktualisierte Links und Erwähnungen von "GitHub AE" zu "GitHub Enterprise Server", um den aktuellen Produktnamen widerzuspiegeln.

Weitere Ressourcen

• Verwalten der Bereitstellung von Benutzerkonten für Enterprise-Apps
• Was ist Der Anwendungszugriff und einmaliges Anmelden mit der Microsoft Entra-ID?

Verwandte Inhalte

• Erfahren Sie, wie Sie Protokolle überprüfen und Berichte zu Bereitstellungsaktivitäten abrufen