Cloud-Anwendung Black Duck von Synopsys

Für diese Aufgabe müssen Sie als Super Admin angemeldet sein.

Die Security Assertion Markup Language (SAML) ermöglicht es Nutzern, sich mit ihren Google Cloud-Anmeldedaten in geschäftlichen Cloud-Anwendungen anzumelden.

Hinweis: Black Duck muss mit Google Compute Engine (GCE), Amazon Web Services (AWS) oder Azure bereitgestellt werden. Anleitungen dazu finden Sie in der Dokumentation zur Cloud-Plattform von Black Duck.

Einmalanmeldung (SSO) über SAML für Black Duck einrichten

Schritt 1: Google als SAML-Identitätsanbieter einrichten

1. Melden Sie sich in der Google Admin-Konsole an.

   Verwenden Sie zur Anmeldung ein Konto mit Super Admin-Berechtigungen (endet nicht auf @gmail.com).

2. Gehen Sie in der Admin-Konsole zu „Menü“  AppsWeb- und mobile Apps.
3. Klicken Sie auf App hinzufügen  Nach Apps suchen.
4. Geben Sie Black Duck von Synopsys in das Suchfeld ein.
5. Bewegen Sie den Mauszeiger in den Suchergebnissen auf die SAML-App Black Duck und klicken Sie dann auf Auswählen.
6. Laden Sie auf der Seite Details zum Google-Identitätsanbieter die IdP-Metadaten herunter.
7. Klicken Sie auf Weiter.
8. Ersetzen Sie auf der Seite Details zum Dienstanbieter in den Feldern ACS-URL und Entitäts-ID den Text {your-domain} durch den Namen der Domain, in der Black Duck installiert ist.
9. Klicken Sie auf Weiter.
10. Legen Sie auf der Seite Attributzuordnung bei Kategorie auswählen und Nutzerfeld auswählen die hier angegebenen Werte für die folgenden Attribute fest:
     

    Anwendungsattribut	Kategorie auswählen	Nutzerfeld auswählen
    FirstName	Allgemeine Informationen	Vorname
    LastName	Allgemeine Informationen	Nachname
    Email	Allgemeine Informationen	Primäre E-Mail-Adresse
    Name	Allgemeine Informationen	Primäre E-Mail-Adresse

11. Optional: So geben Sie Gruppennamen ein, die für diese App relevant sind:

    1. 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.
    2. Fügen Sie nach Bedarf weitere Gruppen hinzu (maximal 75 Gruppen).
    3. 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.

12. Klicken Sie auf Beenden.

Schritt 2: Black Duck als SAML 2.0-Dienstanbieter einrichten

1. Öffnen Sie ein neues Inkognitofenster in Ihrem Browser.
2. Melden Sie sich mit Ihrem Admin-Konto in Black Duck an.
3. Klicken Sie auf Administration (Verwaltung) und wählen Sie SAML Integration (SAML-Integration) aus.
4. Klicken Sie auf Enable SAML (SAML aktivieren).
5. Geben Sie in das Feld Service Providers Entity URL (Entitäts-URL der Dienstanbieter) die URL zum Hub ein.
6. Fügen Sie in das Textfeld Identity Provider Metadata (Metadaten des Identitätsanbieters) den Inhalt der IdP-Metadatendatei ein, die Sie in Schritt 1 heruntergeladen haben.
7. Klicken Sie auf Save (Speichern).
8. Verbinden Sie sich über Secure Shell (SSH) mit dem Hubserver.
9. Bearbeiten Sie im docker-compose-Verzeichnis die Datei hub-proxy.env: Fügen Sie an ihrem Ende die folgende Zeile ein und ersetzen Sie {url-to-the-hub} durch die URL der Instanz, in der Black Duck bereitgestellt wird:
   • HUB_SAML_EXTERNAL_URL={url-to-the-hub}
10.  Starten Sie die Hubinstanz neu.

Schritt 3: Black Duck App aktivieren

1. Melden Sie sich in der Google Admin-Konsole an.

   Verwenden Sie zur Anmeldung ein Konto mit Super Admin-Berechtigungen (endet nicht auf @gmail.com).

2. Gehen Sie in der Admin-Konsole zu „Menü“  AppsWeb- und mobile Apps.
3. Wählen Sie Black Duck aus.
4. Klicken Sie auf Nutzerzugriff.

5. 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.

6. Optional: Wenn Sie einen Dienst für eine Organisationseinheit aktivieren oder deaktivieren möchten:

   1. Wählen Sie links die Organisationseinheit aus.
   2. Wenn Sie den Dienststatus ändern möchten, wählen Sie An oder Aus aus.
   3. Wählen Sie eine Option aus:
      • Wenn der Dienststatus auf Übernommen gesetzt ist 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.
        Hinweis: Weitere Informationen zur Organisationsstruktur
7. Soll ein Dienst für eine Gruppe von Nutzern aktiviert werden, die sich innerhalb einer Organisationseinheit oder über mehrere verteilt befinden, wählen Sie eine Zugriffsgruppe aus. Weitere Informationen
8. Achten Sie darauf, dass die E-Mail-IDs der Black Duck-Nutzerkonten mit denen in Ihrer Google-Domain übereinstimmen.

Schritt 4: SSO testen

Hinweis: Black Duck unterstützt die SSO nur, wenn die Anmeldung über Google erfolgt. Sie können die SSO nicht direkt bei Black Duck nutzen.

1. Melden Sie sich in der Google Admin-Konsole an.

   Verwenden Sie zur Anmeldung ein Konto mit Super Admin-Berechtigungen (endet nicht auf @gmail.com).

2. Gehen Sie in der Admin-Konsole zu „Menü“  AppsWeb- und mobile Apps.
3. Wählen Sie Black Duck aus.
4. Klicken Sie links oben auf Test SAML login (SAML-Testanmeldung). 

   Black Duck sollte in einem separaten Tab geöffnet werden. Ist das nicht der Fall, aktualisieren Sie die IdP- und SP-Einstellungen anhand der Informationen in den entsprechenden SAML-Fehlermeldungen und testen Sie die SAML-Anmeldung noch einmal.

_{Google, Google Workspace sowie zugehörige Marken und Logos sind Marken von Google LLC. Alle anderen Unternehmens- und Produktnamen sind Marken der Unternehmen, mit denen sie verbunden sind.}