Ein Team mit einer Identitätsanbieter-Gruppe synchronisieren

Informationen zur Teamsynchronisierung

Wenn die Teamsynchronisierung für dein Organisations- oder Unternehmenskonto aktiviert ist, kannst du ein GitHub-Team mit einer Identitätsanbietergruppe synchronisieren. Bei diesem Vorgang werden Änderungen an der Mitgliedschaft bei der Identitätsanbietergruppe automatisch auf GitHub widergespiegelt, wodurch die Notwendigkeit manueller Updates und benutzerdefinierter Skripts reduziert wird. Weitere Informationen finden Sie unter Verwalten der Teamsynchronisierung für deine Organisation und Verwalten der Teamsynchronisierung für Organisationen in deinem Unternehmen.

Sie können bis zu fünf IdP-Gruppen mit einem GitHub Team verbinden. Sie können mehreren GitHub Teams eine IdP-Gruppe zuweisen.

Die Teamsynchronisierung unterstützt keine IDP-Gruppen mit mehr als 5000 Mitgliedern.

Sobald ein GitHub Team mit einer IdP-Gruppe verbunden ist, muss Ihr IdP-Administrator Änderungen an der Teammitgliedschaft über den Identitätsanbieter vornehmen. Sie können die Teammitgliedschaft weder auf GitHub noch über die API verwalten.

Wenn Ihre Organisation einem Unternehmenskonto gehört, setzt das Aktivieren der Teamsynchronisierung für das Unternehmenskonto die Einstellungen für die Teamsynchronisierung auf Organisationsebene außer Kraft. Weitere Informationen finden Sie unter Verwalten der Teamsynchronisierung für Organisationen in deinem Unternehmen.

Die Teamsynchronisierung ist kein Benutzerbereitstellungsdienst und lädt in der Regel keine Nichtmitglieder zum Organisationsbeitritt ein. Das bedeutet, dass Benutzerinnen nur dann erfolgreich einem Team hinzugefügt werden, wenn sie bereits Organisationsmitglieder sind. Du kannst der Teamsynchronisierung jedoch optional gestatten, Benutzerinnen erneut einzuladen, die zuvor Mitglieder der Organisation waren und in der Zwischenzeit entfernt wurden. Weitere Informationen finden Sie unter Verwalten der Teamsynchronisierung für deine Organisation und Verwalten der Teamsynchronisierung für Organisationen in deinem Unternehmen.

Alle Änderungen der Teammitgliedschaft, die über Ihren IdP vorgenommen wurden, werden im Überwachungsprotokoll GitHub als Änderungen angezeigt, die vom Teamsynchronisierungs-Bot vorgenommen wurden. Die Teamsynchronisierung ruft mindestens einmal pro Stunde Gruppeninformationen von Ihrem IdP ab und übernimmt alle Änderungen an der Mitgliedschaft in IdP-Gruppen in GitHub. Beim Verbinden eines Teams mit einer IdP-Gruppe werden unter Umständen einige Teammitglieder entfernt. Weitere Informationen findest du unter Anforderungen für Mitglieder synchronisierter Teams.

Übergeordnete Teams können nicht mit IdP-Gruppen synchronisiert werden. Wenn das Team, das du mit einer IdP-Gruppe verbinden möchtest, ein übergeordnetes Team ist, empfehlen wir, ein neues Team zu erstellen oder die verschachtelten Beziehungen zu entfernen, die aus deinem Team ein übergeordnetes Team machen. Weitere Informationen findest du unter Informationen zu den Organisationsteams, Erstellen eines Organisationsteams und Verschieben eines Teams in der Hierarchie Ihrer Organisation.

Um den Repository-Zugriff für jedes GitHubTeam zu verwalten, einschließlich Teams, die mit einer IdP-Gruppe verbunden sind, müssen Sie Änderungen mit GitHub vornehmen. Weitere Informationen findest du unter Informationen zu den Organisationsteams und Den Teamzugriff auf ein Repository einer Organisation verwalten.

Sie können auch die Teamsynchronisierung mit der API verwalten. Weitere Informationen finden Sie unter REST-API-Endpunkte für die Teamsynchronisierung.

Anforderungen an Mitglieder synchronisierter Teams

Nachdem Sie ein Team mit einer IdP-Gruppe verknüpft haben, fügt die Teamsynchronisierung jedes Mitglied der IdP-Gruppe dem entsprechenden Team auf GitHub nur dann hinzu, wenn:

• Wenn die Teamsynchronisierung keine Nichtmitglieder in Ihre Organisation einladen darf, ist die Person auf GitHub bereits Mitglied der Organisation.
• Die Person hat sich bereits mit ihrem persönlichen Konto GitHub bei der Organisation oder dem Unternehmenskonto über saml single sign-on angemeldet und mindestens einmal authentifiziert.
• Die SSO-Identität der Person ist ein Mitglied der Identitätsanbietergruppe.

Vorhandene Teams oder Gruppenmitglieder, die diese Kriterien nicht erfüllen, werden automatisch aus dem Team GitHub entfernt und verlieren den Zugriff auf Repositorys. Beim Widerrufen der verknüpften Identität eines Benutzers bzw. einer Benutzerin wird dieser Benutzerin auch aus allen Teams entfernt, die Identitätsanbietergruppen zugeordnet sind. Weitere Informationen findest du unter Anzeigen und Verwalten des SAML-Zugriffs eines Mitglieds auf Ihre Organisation und Anzeigen und Verwalten des SAML-Zugriffs von Benutzer*innen auf dein Unternehmen.

Sobald sich ein entferntes Teammitglied jedoch mit SSO sowohl bei dem Organisations- als auch beim Enterprise-Konto authentifiziert hat und der verbundenen IdP-Gruppe hinzugefügt wurde, kann es automatisch wieder in das Team aufgenommen werden.

Um zu verhindern, dass Teammitglieder versehentlich aus einem Team entfernt werden, empfehlen wir innerhalb der Organisations oder dem Enterprise-Konto die Erzwingung des SAML SSO, die Erstellung neuer Teams zur Synchronisierung der Mitgliederdaten und die Überprüfung der IdP-Gruppenmitgliedschaften vor der Synchronisierung bestehender Teams. Weitere Informationen findest du unter Erzwingung von SAML-Single-Sign-On für Ihre Organisation und Konfigurieren von SAML Single Sign-On für dein Unternehmen.

Voraussetzungen

Um ein Team in GitHub mit einer Identitätsanbietergruppe zu verbinden, muss das Team bereits in deiner Organisation existieren. Selbst wenn du die SCIM-Bereitstellung konfiguriert hast, wird durch die Erstellung einer Gruppe bei deinem Identitätsanbieter nicht automatisch ein Team in GitHub erstellt.

Bevor Sie ein GitHub Team mit einer IdP-Gruppe verbinden können, muss eine Organisation oder ein Unternehmensbesitzer die Teamsynchronisierung für Ihre Organisation oder Ihr Unternehmenskonto aktivieren. Weitere Informationen findest du unter Verwalten der Teamsynchronisierung für deine Organisation und Verwalten der Teamsynchronisierung für Organisationen in deinem Unternehmen.

Um zu vermeiden, dass Team-Mitglieder unbeabsichtigt entfernt werden, besuche das administrative Portal deines IdP und bestätige, dass jedes aktuelle Teammitglied auch in der IdP-Gruppe vorhanden ist, die du mit diesem Team verbinden willst. Wenn du keinen Zugriff auf deinen Identitätsanbieter hast, kannst du dich an deinen IdP-Administrator wenden.

Du musst Dich mit SAML SSO authentifizieren. Weitere Informationen finden Sie unter Authentifizierung mit Single Sign-On.

Eine IdP-Gruppe mit einem Team verbinden

Wenn Sie eine IdP-Gruppe mit einem GitHub Team verbinden, werden alle Benutzer in der Gruppe dem Team automatisch hinzugefügt.

1. Klicke in der rechten oberen Ecke von GitHub auf dein Profilbild und dann auf Your organizations.

2. Klicke auf den Namen Deiner Organisation.

3. Klicke unter dem Namen deiner Organisation auf Teams.

   

4. Klicke auf den Namen des Teams.

5. Klicke oben auf der Teamseite auf Settings.

   

6. Wähle unter „Identitätsanbietergruppen“ im Dropdownmenü Gruppen auswählen bis zu 5 Identitätsanbietergruppen aus.

7. Klicke auf Änderungen speichern.

Eine IdP-Gruppe von einem Team trennen

1. Klicke in der rechten oberen Ecke von GitHub auf dein Profilbild und dann auf Your organizations.

2. Klicke auf den Namen Deiner Organisation.

3. Klicke unter dem Namen deiner Organisation auf Teams.

   

4. Klicke auf den Namen des Teams.

5. Klicke oben auf der Teamseite auf Settings.

   

6. Unter „Identity-Provider-Gruppen“ klicken Sie rechts neben der IdP-Gruppe, deren Verbindung Sie trennen möchten, auf .

7. Klicke auf Änderungen speichern.