Met de SAML 2.0-standaard kunt u Single sign-on (SSO) instellen voor een aantal cloud-apps. Nadat u SSO heeft ingesteld, kunnen uw gebruikers hun Google Workspace-inloggegevens gebruiken om met SSO in te loggen bij een app.
SAML gebruiken om SSO in te stellen voor Black Duck
Voordat u begint
U kunt Black Duck gebruiken op Google Compute Engine (GCE), Amazon Web Services (AWS) of Azure. Ga naar de documentatie over het cloudplatform van Black Duck voor installatie-instructies.
Stap 1: Google instellen als SAML-identiteitsprovider
-
Ga in de Google Beheerdersconsole naar Menu
Apps
Web- en mobiele apps.
U moet zijn ingelogd als hoofdbeheerder om deze taak te kunnen uitvoeren.
-
Klik op App toevoegen
Apps zoeken.
-
Voer Blackduck in bij App-naam invoeren.
-
Plaats in de zoekresultaten de muisaanwijzer op Black Duck en klik op Selecteren.
-
Download de metadata van de identiteitsprovider in het venster Gegevens Google-identiteitsprovider.
-
Klik op Doorgaan.
-
Vervang op de pagina Gegevens van de serviceprovider voor ACS-URL en Entiteits-ID de waarde van {your-domain} door het domein waarop Black Duck is geïnstalleerd.
-
Klik op Doorgaan.
-
Klik in het venster Kenmerktoewijzing op Veld selecteren en wijs de volgende Google-directorykenmerken toe aan de bijbehorende Black Duck-kenmerken. De kenmerken FirstName, LastName, Email en Name zijn vereist.
Google-directorykenmerk Black Duck-kenmerk Basic Information > First Name (Algemene informatie > Voornaam) FirstName Basic Information > Last name (Algemene informatie > Achternaam) LastName Basic Information > Primary Email (Algemene informatie > Primaire e-mailadres) Email Basic Information > Primary Email (Algemene informatie > Primaire e-mailadres) Naam - (Optioneel) Als u meer toewijzingen wilt toevoegen, klikt u op Toewijzing toevoegen en selecteert u de velden die u wilt toewijzen.
-
(Optioneel) Groepsnamen invoeren die relevant zijn voor deze app:
- Klik bij Groepslidmaatschap (optioneel) op Zoeken naar een groep. Voer een of meer letters van de groepsnaam in en selecteer de groepsnaam.
- Voeg naar wens extra groepen toe (maximaal 75 groepen).
- Vul bij App-kenmerk de naam in van het overeenkomstige groepskenmerk van de serviceprovider.
Ongeacht de hoeveelheid groepsnamen die u invult, bevat de SAML-reactie alleen groepen waarvan een gebruiker lid is (direct of indirect). Ga voor meer informatie naar Over het toewijzen van groepslidmaatschappen.
-
Klik op Voltooien.
Stap 2: Black Duck instellen als SAML 2.0-serviceprovider
-
Open een incognitovenster. Ga naar de inlogpagina van Black Duck en log in met uw Black Duck-beheerdersaccount.
-
Klik op Administration (Beheer) en selecteer SAML Integration (SAML-integratie).
-
Vink het vakje aan voor Enable SAML (SAML aanzetten).
-
Voer bij Entiteits-URL serviceprovider de URL van de Hub in.
-
Plak bij Metadata van identiteitsprovider de metadata van de identiteitsprovider die u in stap 1 heeft gedownload.
-
Klik op Opslaan.
-
Maak verbinding met de Hub-server via Secure Shell (SSH).
-
Voeg in de docker-compose-directory de volgende regel toe aan het einde van het bestand hub-proxy.env: HUB_SAML_EXTERNAL_URL={url-to-the-hub}.
-
Vervang {url-to-the-hub} door de URL van de instantie waar Black Duck is geïnstalleerd.
-
Start de Hub-instantie opnieuw.
Stap 3: De app aanzetten voor gebruikers
-
Ga in de Google Beheerdersconsole naar Menu
Apps
Web- en mobiele apps.
U moet zijn ingelogd als hoofdbeheerder om deze taak te kunnen uitvoeren.
-
Klik op Blackduck.
- Klik op Gebruikerstoegang.
-
Als u een service wilt aan- of uitzetten voor iedereen in uw organisatie, klikt u op Aan voor iedereen of Uit voor iedereen. Klik dan op Opslaan.
-
(Optioneel) Zo zet u service aan of uit voor een organisatie-eenheid:
- Selecteer links de organisatie-eenheid.
- Selecteer Aan of Uit om de servicestatus te wijzigen.
- Kies een van deze opties:
- Als de servicestatus is ingesteld op Overgenomen en u de bijgewerkte instelling wilt behouden, zelfs als de instelling voor de bovenliggende organisatie-eenheid wordt gewijzigd, klik dan op Overschrijven.
- Als de servicestatus is ingesteld op Overschreven, klikt u op Overnemen om de instelling hetzelfde te maken als die van de bovenliggende organisatie-eenheid. Of klik op Opslaan om de nieuwe instelling te behouden, zelfs als de instelling van de bovenliggende organisatie-eenheid wordt gewijzigd.
Meer informatie over de organisatiestructuur.
- (Optioneel) Als u een service wilt aanzetten voor een groep gebruikers binnen een organisatie-eenheid of in verschillende organisatie-eenheden, selecteert u een toegangsgroep. Ga voor meer informatie naar Toegang tot services aanpassen met toegangsgroepen.
-
Zorg dat de e-maildomeinen van uw Black Duck-gebruikersaccount overeenkomen met het hoofddomein van het beheerde Google-account van uw organisatie.
Stap 4: Controleren of SSO werkt
Black Duck ondersteunt SSO alleen als u inlogt via Google. U kunt SSO niet gebruiken als u rechtstreeks inlogt bij Black Duck.
Door de identiteitsprovider gestarte SSO verifiëren
-
Ga in de Google Beheerdersconsole naar Menu
Apps
Web- en mobiele apps.
U moet zijn ingelogd als hoofdbeheerder om deze taak te kunnen uitvoeren.
-
Klik op Blackduck.
-
Klik in het gedeelte Blackduck op SAML-login testen. De app wordt geopend op een nieuw tabblad. Als dit niet het geval is, lost u de foutmelding op en probeert u het opnieuw. Ga naar Foutmeldingen voor SAML-apps voor meer informatie over hoe u problemen oplost.
Google, Google Workspace en gerelateerde merken en logo's zijn handelsmerken van Google LLC. Alle andere bedrijfs- en productnamen zijn handelsmerken van de bedrijven waarmee ze in verband worden gebracht.