Met de SAML 2.0-standaard kunt u single sign-on (SSO) configureren voor een aantal cloud-apps. Nadat u SSO hebt ingesteld, kunnen uw gebruikers hun Google Workspace-gegevens gebruiken om zich via SSO aan te melden bij een app.
Gebruik SAML om SSO in te stellen voor GitHub Enterprise.
Voor deze taak moet u zijn aangemeld als superbeheerder .Stap 1: Google instellen als SAML-identiteitsprovider
Ga in de Google Admin-console naar Menu.
Apps Web- en mobiele apps .Voor deze taak moet u zijn aangemeld als superbeheerder .
- Klik op 'App toevoegen'. Zoek naar apps .
- Voer bij 'Voer appnaam in ' GitHub Business in.
- Wijs in de zoekresultaten naar GitHub Business en klik op Selecteren .
- In het venster met details van de Google Identity Provider , selecteer je bij optie 2: Kopieer de SSO-URL, de entiteits-ID en het certificaat :
- Klik naast SSO-URL op Kopiëren
en sla de URL op. - Klik naast Entiteits-ID op Kopiëren. en sla de URL op.
- Klik naast Certificaat op Downloaden
om het certificaat te downloaden.
Je hebt deze gegevens nodig om de installatie in GitHub Enterprise te voltooien.
- Klik naast SSO-URL op Kopiëren
- Klik op Doorgaan .
- Vervang op de pagina met serviceprovidergegevens bij ACS-URL en entiteits-ID {uw-organisatie} door de naam van uw GitHub Enterprise-organisatie.
- Klik op Doorgaan .
- Klik in het venster Attribuuttoewijzing op 'Veld selecteren' en koppel de volgende Google-directoryattributen aan de overeenkomstige GitHub Enterprise-attributen. De attributen firstName en lastName zijn verplicht.
Google-directorykenmerken App-eigenschappen Basisgegevens > Voornaam voornaam* Basisgegevens > Achternaam achternaam* - (Optioneel) Om extra koppelingen toe te voegen, klikt u op Koppeling toevoegen en selecteert u de velden die u wilt koppelen.
- (Optioneel) Voer hier groepsnamen in die relevant zijn voor deze app:
- Voor groepslidmaatschap (optioneel) klikt u op 'Zoek naar een groep' , voert u een of meer letters van de groepsnaam in en selecteert u de groepsnaam.
- Voeg naar behoefte extra groepen toe (maximaal 75 groepen).
- Voer voor het attribuut 'App' de overeenkomstige naam van het groepsattribuut van de serviceprovider in.
Ongeacht hoeveel groepsnamen u invoert, het SAML-antwoord bevat alleen groepen waarvan een gebruiker (direct of indirect) lid is. Ga voor meer informatie naar 'Over het toewijzen van groepslidmaatschap' .
- Klik op Voltooien .
Stap 2: GitHub Enterprise instellen als SAML 2.0-serviceprovider
- Open een incognitovenster van uw browser, ga naar de aanmeldingspagina van GitHub Enterprise en meld u aan met uw GitHub Enterprise-beheerdersaccount.
- Klik op je gebruikersnaam Instellingen .
- Klik op de naam van uw organisatie Beveiliging .
- Voor SAML single sign-on :
- Plak in het veld 'Aanmeld-URL' de SSO-URL die u eerder hebt gekopieerd.
- Plak in het veld 'Uitgever' de entiteits-ID die u eerder hebt gekopieerd.
- Kopieer in het veld 'Openbaar certificaat' het certificaat dat u eerder hebt gedownload.
- Klik op SAML-configuratie testen om uw instellingen te controleren.
- Vink het vakje 'SAML-authenticatie inschakelen' aan.
- Klik op Opslaan .
Stap 3: Schakel de app in voor gebruikers.
Ga in de Google Admin-console naar Menu.
Apps Web- en mobiele apps .Voor deze taak moet u zijn aangemeld als superbeheerder .
- Klik op GitHub Business .
- Klik op Gebruikerstoegang .
Om een service voor iedereen in uw organisatie in of uit te schakelen, klikt u op 'Aan voor iedereen' of 'Uit voor iedereen' en vervolgens op ' Opslaan' .
- (Optioneel) Om een service voor een organisatie-eenheid in of uit te schakelen:
- Selecteer aan de linkerkant de organisatie-eenheid.
- Om de servicestatus te wijzigen, selecteert u Aan of Uit .
- Kies er één:
- Als de servicestatus is ingesteld op 'Overgenomen' en u de bijgewerkte instelling wilt behouden, zelfs als de instelling van de bovenliggende service verandert, klikt u op 'Overschrijven' .
- Als de servicestatus is ingesteld op 'Overschreven' , kunt u op 'Overnemen' klikken om terug te keren naar dezelfde instelling als het bovenliggende element, of op ' Opslaan' klikken om de nieuwe instelling te behouden, zelfs als de instelling van het bovenliggende element verandert.
Leer meer over organisatiestructuur .
- (Optioneel) Om een service in te schakelen voor een groep gebruikers binnen of tussen organisatie-eenheden, selecteert u een toegangsgroep. Zie Toegang tot services aanpassen met toegangsgroepen voor meer informatie.
- Zorg ervoor dat de e-maildomeinen van uw GitHub Enterprise-gebruikersaccount overeenkomen met het primaire domein van het beheerde Google-account van uw organisatie.
Stap 4: Controleer of SSO werkt
GitHub Enterprise ondersteunt zowel door de identiteitsprovider als door de serviceprovider geïnitieerde SSO.
Verifieer de door de identiteitsprovider geïnitieerde SSO.
Ga in de Google Admin-console naar Menu.
Apps Web- en mobiele apps .Voor deze taak moet u zijn aangemeld als superbeheerder .
- Klik op GitHub Business .
- Klik in het gedeelte GitHub Business op Test SAML-aanmelding .
De app zou in een apart tabblad moeten openen. Als dit niet gebeurt, los dan de foutmelding op en probeer het opnieuw. Ga naar SAML-appfoutmeldingen voor meer informatie over het oplossen van problemen.
Controleer of de serviceprovider SSO heeft geïnitieerd.
- Sluit alle browservensters.
- Open https://github.com/orgs/{jouw-organisatie}/sso en probeer in te loggen. Je zou automatisch moeten worden doorgestuurd naar de Google-inlogpagina.
- Voer uw inloggegevens in.
Nadat uw aanmeldgegevens zijn geverifieerd, wordt u automatisch doorgestuurd naar GitHub Enterprise.
- Meld u aan met uw persoonlijke GitHub-accountgegevens.
Google, Google Workspace en aanverwante merken en logo's zijn handelsmerken van Google LLC. Alle andere bedrijfs- en productnamen zijn handelsmerken van de bedrijven waaraan ze zijn verbonden.