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 Jenkins 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 Jenkins ein.
- Bewegen Sie den Mauszeiger in den Suchergebnissen auf Jenkins Web (SAML) 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 Entitäts-ID.
- Klicken Sie neben Zertifikat auf „Kopieren“
und speichern Sie das Zertifikat.
Sie benötigen diese Angaben, um die Einrichtung in Jenkins abzuschließen.
- Klicken Sie neben SSO-URL auf „Kopieren“
- Klicken Sie auf Weiter.
Auf der Seite Details zum Dienstanbieter sind die App-Details standardmäßig konfiguriert. - Geben Sie die ACS-URL und die Entitäts-ID ein. Weitere Informationen finden Sie unter SAML-Einmalanmeldung (SSO) in Jenkins mit Google Apps als Identitätsanbieter.
- Klicken Sie auf Weiter.
-
Optional: Wenn Sie Google-Verzeichnisattribute den entsprechenden App-Attributen zuordnen möchten, gehen Sie im Fenster Attributzuordnung so vor:
- Klicken Sie auf Zuordnung hinzufügen.
- Klicken Sie auf Feld auswählen
wählen Sie ein Google-Verzeichnisattribut aus.
- Geben Sie unter App-Attribute das entsprechende App-Attribut ein.
-
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 Fertig.
Schritt 2: Jenkins als SAML 2.0-Dienstanbieter einrichten
- Öffnen Sie ein neues Inkognitofenster im Browser, rufen Sie die Jenkins-Anmeldeseite auf und melden Sie sich mit Ihrem Jenkins-Administratorkonto an.
- Klicken Sie auf Ihren Kontonamen.
- Klicken Sie auf Manage Jenkins
Configure Global Security (Jenkins verwalten > Globale Sicherheit konfigurieren).
- Klicken Sie auf das Kästchen neben Enable Security (Sicherheit aktivieren).
- Wählen Sie für Security Realm (Sicherheitsbereich) die Option miniOrange SAML 2.0 aus.
- Klicken Sie auf Konfigurieren.
- Fügen Sie für IdP configuration (IdP-Konfiguration) den Inhalt der Metadaten ein, die Sie in Schritt 1 heruntergeladen haben.
- Klicken Sie auf Konfiguration testen.
Sie werden daraufhin automatisch zur Google Log-in-Seite weitergeleitet.
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 Jenkins.
- 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 zur 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-Domains des Jenkins-Nutzerkontos mit der primären Domain des verwalteten Google-Kontos Ihrer Organisation übereinstimmen.
Schritt 4: SSO testen
Jenkins 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 Jenkins.
- Klicken Sie im Abschnitt Jenkins 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.
- Rufen Sie die Jenkins-Anmeldeseite auf und melden Sie sich mit Ihrem Jenkins-Administratorkonto an.
Sie werden daraufhin automatisch zur Google Log-in-Seite weitergeleitet. - Wählen Sie das Konto aus und geben Sie das Passwort ein.
Nach der Authentifizierung der Anmeldedaten sollte die App geöffnet werden.
Google, Google Workspace sowie zugehörige Marken und Logos sind Marken von Google LLC. Alle anderen Unternehmens- und Produktnamen sind Marken der jeweiligen Unternehmen.