Black Duck-Cloud-App

Sie können Black Duck in Google Compute Engine (GCE), Amazon Web Services (AWS) oder Azure verwenden. Installationsanweisungen finden Sie in der Dokumentation zur Cloud-Plattform von Black Duck.

1. Öffnen Sie in der Admin-Konsole das Dreistrich-Menü Apps Web- und mobile Apps.

   Web- und mobile Apps aufrufen

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

2. Klicken Sie auf App hinzufügen Nach Apps suchen.

3. Geben Sie unter App-Name eingeben Blackduck ein.

4. Bewegen Sie den Mauszeiger in den Suchergebnissen auf Blackduck und klicken Sie auf Auswählen.

5. Laden Sie im Fenster Details zum Google-Identitätsanbieter die Metadaten des Identitätsanbieters herunter.

6. Klicken Sie auf Weiter.

7. Ersetzen Sie auf der Seite Details zum Dienstanbieter in den Feldern ACS-URL und Entitäts-ID den Platzhalter {your-domain} durch den Namen der Domain, in der Black Duck installiert ist.

8. Klicken Sie auf Weiter.

9. Klicken Sie im Fenster Attributzuordnung auf Feld auswählen und ordnen Sie die folgenden Google-Verzeichnisattribute den entsprechenden Black Duck-Attributen zu. Die Attribute für Vorname, Nachname, primäre E‑Mail-Adresse und Name sind erforderlich.

   Google-Verzeichnisattribut	Black Duck-Attribut
   Allgemeine Informationen > Vorname	FirstName
   Allgemeine Informationen > Nachname	LastName
   Allgemeine Informationen > Primäre E-Mail-Adresse	E-Mail
   Allgemeine Informationen > Primäre E-Mail-Adresse	Name

10. 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.
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 bei 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.

1. Öffnen Sie ein Inkognitofenster im Browser, rufen Sie die Black Duck-Anmeldeseite auf und melden Sie sich mit Ihrem Black Duck-Administratorkonto an.

2. Klicken Sie auf Administration (Verwaltung) und wählen Sie SAML Integration (SAML-Integration) aus.

3. Klicken Sie auf das Kästchen neben Enable SAML (SAML aktivieren).

4. Geben Sie in das Feld Service Providers Entity URL (Entitäts-URL der Dienstanbieter) die URL zum Hub ein.

5. Fügen Sie unter Identity Provider Metadata (Metadaten des Identitätsanbieters) die Metadaten des Identitätsanbieters ein, die Sie in Schritt 1 heruntergeladen haben.

6. Klicken Sie auf Speichern.

7. Stellen Sie über Secure Shell (SSH) eine Verbindung zum Hubserver her.

8. Fügen Sie im docker-compose-Verzeichnis am Ende der Datei hub-proxy.env die folgende Zeile hinzu: HUB_SAML_EXTERNAL_URL={url-to-the-hub}.

9. Ersetzen Sie {url-to-the-hub} durch die URL der Instanz, in der Black Duck installiert ist.

10. Starten Sie die Hubinstanz neu.

1. Öffnen Sie in der Admin-Konsole das Dreistrich-Menü Apps Web- und mobile Apps.

   Web- und mobile Apps aufrufen

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

2. Klicken Sie auf Blackduck.

3. Klicken Sie auf Nutzerzugriff.

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

5. Optional: So aktivieren Sie einen Dienst für eine Organisationseinheit:
   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 festgelegt 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.

        Weitere Informationen finden Sie im Artikel Funktionsweise der Organisationsstruktur.

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

7. Achten Sie darauf, dass die E‑Mail-Domains Ihres Black Duck-Nutzerkontos mit der primären Domain des verwalteten Google-Kontos Ihrer Organisation übereinstimmen.

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

Vom Identitätsanbieter initiierte SSO testen

1. Öffnen Sie in der Admin-Konsole das Dreistrich-Menü Apps Web- und mobile Apps.

   Web- und mobile Apps aufrufen

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

2. Klicken Sie auf Blackduck.

3. Klicken Sie im Abschnitt Blackduck 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.