Met de standaard Security Assertion Markup Language 2.0 (SAML) 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 Jenkins
Alles uitvouwen | Alles samenvouwen
U moet zijn ingelogd als hoofdbeheerder om deze taak te kunnen uitvoeren.
Stap 1: Google instellen als SAML-identiteitsprovider (IdP)-
Log in met een hoofdbeheerdersaccount op de Google Beheerdersconsole.
Als u geen hoofdbeheerdersaccount gebruikt, kunt u deze stappen niet uitvoeren.
-
-
Klik op App toevoegen
Apps zoeken.
-
Voer Jenkins in bij App-naam invoeren.
-
Plaats in de zoekresultaten de muisaanwijzer op Jenkins Web (SAML) en klik op Selecteren.
-
Doe het volgende in het venster Gegevens Google-identiteitsprovider bij Optie 2: De SSO-URL, de entiteits-ID en het certificaat kopiëren:
- Klik naast SSO-URL op Kopiëren
en sla de URL op.
- Klik naast Entiteits-ID op Kopiëren
- Klik naast Certificaat op Kopiëren
U heeft deze gegevens nodig om de installatie af te ronden in Jenkins.
- Klik naast SSO-URL op Kopiëren
- Klik op Doorgaan.
Op de pagina Gegevens van de serviceprovider zijn de app-gegevens standaard ingesteld. - Voer de ACS-URL en Entiteits-ID in. Ga naar SAML Single sign-on (SSO) instellen voor Jenkins met Google Apps als IdP voor meer informatie.
-
Klik op Doorgaan.
-
(Optioneel) Ga als volgt te werk om Google-directorykenmerken toe te wijzen aan de overeenkomstige app-kenmerken in het venster Kenmerktoewijzing:
- Klik op Toewijzing toevoegen.
- Klik op Veld selecteren
- Voer bij App-kenmerken het bijbehorende app-kenmerk in.
-
(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).
- Voer bij App-kenmerk de naam in van het groepskenmerk van de bijbehorende 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.
- Open een nieuw incognitobrowservenster, ga naar de inlogpagina van Jenkins en log in met uw Jenkins-beheerdersaccount.
- Klik op uw accountnaam.
- Klik op Manage Jenkins (Jenkins beheren)
- Vink het vakje aan voor Enable Security (Beveiliging aanzetten).
- Selecteer miniOrange SAML 2.0 voor Security Realm (Beveiligingsgebied).
- Klik op Configureren.
- Plak bij IdP-configuratie de inhoud van de metadata die u in stap 1 heeft gedownload.
- Klik op Configuratie testen.
Als het goed is, wordt u doorgestuurd naar de inlogpagina van Google.
Voordat u begint: als u de service wilt in- of uitschakelen voor bepaalde gebruikers, plaatst u hun accounts in een organisatie-eenheid (om de toegang te beheren per afdeling) of in een toegangsgroep (om de toegang te beheren voor gebruikers in verschillende afdelingen).
-
Log in met een hoofdbeheerdersaccount op de Google Beheerdersconsole.
Als u geen hoofdbeheerdersaccount gebruikt, kunt u deze stappen niet uitvoeren.
-
- Klik op Jenkins.
- 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 geüpdatete instelling wilt behouden, zelfs als de instelling voor de bovenliggende organisatie-eenheid wordt gewijzigd, klikt u op Overschrijven.
- Als de servicestatus is ingesteld op Overschrijven, klikt u op Overnemen om de instelling hetzelfde te maken als de instelling voor de bovenliggende organisatie-eenheid, of op Opslaan om de nieuwe instelling te behouden, zelfs als de instelling voor 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 naar Toegang tot services aanpassen met toegangsgroepen voor meer informatie.
- Zorg dat de e-maildomeinen van uw Jenkins-gebruikersaccount overeenkomen met het hoofddomein van het beheerde Google-account van uw organisatie.
Jenkins ondersteunt zowel door de identiteitsprovider gestarte als door de serviceprovider gestarte SSO.
Door de identiteitsprovider gestarte SSO verifiëren
-
Log in met een hoofdbeheerdersaccount op de Google Beheerdersconsole.
Als u geen hoofdbeheerdersaccount gebruikt, kunt u deze stappen niet uitvoeren.
-
- Klik op Jenkins.
- Klik in het gedeelte Jenkins 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.
Door de serviceprovider gestarte SSO verifiëren
- Sluit alle browservensters.
- Ga naar de inlogpagina van Jenkins en log in met uw Jenkins-beheerdersaccount.
Als het goed is, wordt u doorgestuurd naar de inlogpagina van Google. - Selecteer uw account en voer uw wachtwoord in.
Nadat uw inloggegevens zijn geverifieerd, wordt de app geopend.
Google, Google Workspace en de 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.