Mit dem Standard SAML 2.0 können Sie die Einmalanmeldung (SSO) für eine Reihe von Cloud-Apps konfigurieren. Nachdem Sie SSO eingerichtet haben, können sich Ihre Nutzer mit ihren Google Workspace-Anmeldedaten in einer App anmelden.
SAML zum Einrichten von SSO für GitHub Enterprise verwenden
Für diese Aufgabe müssen Sie als Super Admin angemeldet sein.Schritt 1: Google als SAML-Identitätsanbieter einrichten
-
Öffnen Sie in der Admin-Konsole das Dreistrich-Menü
Apps
Web- und mobile Apps.
Für diese Aufgabe müssen Sie als Super Admin angemeldet sein.
-
Klicken Sie auf App hinzufügen
Nach Apps suchen.
- Geben Sie unter App-Name eingeben GitHub Business ein.
- Bewegen Sie den Mauszeiger in den Suchergebnissen auf GitHub Business und klicken Sie auf Auswählen.
- Im Fenster Details zum Google-Identitätsanbieter für Option 2: SSO-URL, Entitäts-ID und Zertifikat kopieren:
- Klicken Sie neben SSO-URL auf „Kopieren“
und speichern Sie die URL.
- Klicken Sie neben Entitäts-ID auf „Kopieren“
und speichern Sie die URL.
- Klicken Sie neben Zertifikat auf „Herunterladen“
, um das Zertifikat herunterzuladen.
Sie benötigen diese Angaben, um die Einrichtung in GitHub Enterprise abzuschließen.
- Klicken Sie neben SSO-URL auf „Kopieren“
- Klicken Sie auf Weiter.
- Ersetzen Sie auf der Seite Details zum Dienstanbieter in den Feldern ACS-URL und Entitäts-ID den Platzhalter {your-organization} durch den Namen Ihrer GitHub Enterprise-Organisation.
- Klicken Sie auf Weiter.
- Klicken Sie im Fenster Attributzuordnung auf Feld auswählen und ordnen Sie die folgenden Google-Verzeichnisattribute den entsprechenden GitHub Enterprise-Attributen zu. Die Attribute für firstName und lastName sind erforderlich.
Google-Verzeichnisattribute App-Attribute Allgemeine Informationen > Vorname firstName* Allgemeine Informationen > Nachname lastName* - Optional: Wenn Sie weitere Zuordnungen hinzufügen möchten, klicken Sie auf Zuordnung hinzufügen und wählen Sie die Felder aus, die Sie zuordnen möchten.
-
Optional: So geben Sie Gruppennamen ein, die für diese App relevant sind:
- Klicken Sie unter Gruppenmitgliedschaft (optional) auf Nach einer Gruppe suchen, geben Sie einen oder mehrere Buchstaben des Gruppennamens ein und wählen Sie den Gruppennamen aus.
- Fügen Sie nach Bedarf weitere Gruppen hinzu. Die Gesamtzahl der Gruppen darf 75 nicht überschreiten.
- Geben Sie unter App-Attribut den entsprechenden Gruppenattributnamen des Dienstanbieters ein.
Unabhängig davon, wie viele Gruppennamen Sie eingeben, enthält die SAML-Antwort nur Gruppen, in denen ein Nutzer direkt oder indirekt Mitglied ist. Weitere Informationen finden Sie unter Zuordnung von Gruppenmitgliedschaften.
- Klicken Sie auf Beenden.
Schritt 2: GitHub Enterprise als SAML 2.0-Dienstanbieter einrichten
- Öffnen Sie ein Inkognitofenster im Browser, rufen Sie die GitHub Enterprise-Anmeldeseite auf und melden Sie sich mit Ihrem GitHub Enterprise-Administratorkonto an.
- Klicken Sie auf Ihren Nutzernamen
Einstellungen.
- Klicken Sie auf den Namen Ihrer Organisation
Sicherheit.
- Für die SAML-Einmalanmeldung:
- Fügen Sie in das Feld Sign on URL (Anmelde-URL) die SSO-URL ein, die Sie zuvor kopiert haben.
- Fügen Sie in das Feld Issuer (Aussteller) die Entitäts-ID ein, die Sie zuvor kopiert haben.
- Kopieren Sie in das Feld Öffentliches Zertifikat das Zertifikat, das Sie zuvor heruntergeladen haben.
- Klicken Sie auf SAML-Konfiguration testen, um Ihre Einstellungen zu überprüfen.
- Klicken Sie das Kästchen SAML-Authentifizierung aktivieren an.
- Klicken Sie auf Speichern.
Schritt 3: App für Nutzer aktivieren
-
Öffnen Sie in der Admin-Konsole das Dreistrich-Menü
Apps
Web- und mobile Apps.
Für diese Aufgabe müssen Sie als Super Admin angemeldet sein.
- Klicken Sie auf GitHub Business.
- Klicken Sie auf Nutzerzugriff.
-
Wenn Sie einen Dienst für alle Nutzer in Ihrer Organisation aktivieren oder deaktivieren möchten, klicken Sie auf Für alle aktiviert oder Für alle deaktiviert und anschließend auf Speichern.
-
Optional: So aktivieren oder deaktivieren Sie einen Dienst für eine Organisationseinheit:
- Wählen Sie links die Organisationseinheit aus.
- Wenn Sie den Dienststatus ändern möchten, wählen Sie An oder Aus aus.
- Wählen Sie eine Option aus:
- Wenn der Dienststatus Übernommen lautet und Sie die aktualisierte Einstellung beibehalten möchten, auch wenn sich die übergeordnete Einstellung ändert, klicken Sie auf Überschreiben.
- Wenn der Dienststatus auf Überschrieben festgelegt ist, klicken Sie auf Übernehmen, um die Einstellung des übergeordneten Elements wiederherzustellen, oder auf Speichern, um die neue Einstellung beizubehalten, auch wenn sich die übergeordnete Einstellung ändert.
Weitere Informationen finden Sie im Artikel Funktionsweise der Organisationsstruktur.
- Optional: Soll ein Dienst für eine Gruppe von Nutzern aktiviert werden, die zu einer oder zu mehreren Organisationseinheiten gehören, wählen Sie eine Zugriffsgruppe aus. Weitere Informationen finden Sie unter Dienstzugriff mithilfe von Zugriffsgruppen anpassen.
- Achten Sie darauf, dass die E-Mail-Adressen der GitHub Enterprise-Nutzerkonten mit der primären Domain des verwalteten Google-Kontos Ihrer Organisation übereinstimmen.
Schritt 4: SSO testen
GitHub Enterprise unterstützt sowohl das vom Identitätsanbieter als auch das vom Dienstanbieter initiierte SSO.
Vom Identitätsanbieter initiierte SSO testen
-
Öffnen Sie in der Admin-Konsole das Dreistrich-Menü
Apps
Web- und mobile Apps.
Für diese Aufgabe müssen Sie als Super Admin angemeldet sein.
- Klicken Sie auf GitHub Business.
- Klicken Sie im Abschnitt GitHub Business auf SAML-Anmeldung testen.
Die App sollte in einem separaten Tab geöffnet werden. Wenn das nicht der Fall ist, beheben Sie den Fehler und versuchen Sie es noch einmal. Weitere Informationen zur Fehlerbehebung finden Sie im Hilfeartikel Fehlermeldungen zu SAML-Apps.
Vom Dienstanbieter initiierte SSO testen
- Schließen Sie alle Browserfenster.
- Öffnen Sie https://github.com/orgs/{your-organization}/sso und versuchen Sie sich anzumelden. Sie sollten automatisch zur Google Log-in-Seite weitergeleitet werden.
- Geben Sie Ihre Anmeldedaten ein.
Nach der Authentifizierung der Anmeldedaten werden Sie automatisch zu GitHub Enterprise weitergeleitet.
- Melden Sie sich mit Ihren persönlichen GitHub-Kontoanmeldedaten an.
Google, Google Workspace und zugehörige Warenzeichen und Logos sind Marken von Google LLC. Alle anderen Unternehmens- und Produktnamen sind Marken der jeweiligen Unternehmen.