Google OAuth 2.0 is een gratis opensourceproduct dat een federatieve identiteitsoplossing biedt om gebruikers te verbinden met uiteenlopende toepassingen, zowel binnen als buiten instellingen. Het flexibele framework SSO Module Provider van het videoplatform is ontworpen om een groot aantal identiteitsoplossingen te ondersteunen, waardoor Google OAuth 2.0 volledig in uw infrastructuur kan worden geïntegreerd.
Dit document begeleidt gebruikers bij het integreren van het videoplatform als toepassing in hun Google API OAuth 2.0-systeem. Na de configuratie kunnen gebruikers toestemming geven en het videoplatform machtigen om toegang te krijgen tot hun basisgegevens van het Google-account, om hen als nieuwe of bestaande gebruiker bij het videoplatform aan te melden.
Instellen
De configuratie bestaat uit het toevoegen van een omleidings-URI van het videoplatform aan uw project in de Google API Console en het vervolgens ophalen van het JSON-metadatabestand, dat alle benodigde gegevens bevat om de kant van het videoplatform te configureren. Met het JSON-bestand hoeft u voor de configuratie van het videoplatform alleen een paar parameters op te geven en een testlogin uit te voeren. Zodra is geverifieerd dat de SSO werkt, activeert u als laatste stap de authenticatie voor alle gebruikers van uw instelling.
Bij sommige stappen moet <organization> worden vervangen door de wildcard-DNS van de organisatie die aan het videoplatform is gekoppeld. Voor “https://hudson.yuja.com” wordt <organization> bijvoorbeeld vervangen door “hudson”.
Een omleidings-URI van het videoplatform toevoegen aan de Google API Console
Raadpleeg het volgende voor instructies over het maken van projecten in de Google API Console: https://developers.google.com/identity/sign-in/web/devconsole-project
- Kies of maak in uw Google API Console een project dat aan het videoplatform is gekoppeld. Voeg de volgende waarde toe aan Geautoriseerde omleidings-URI: https://<organization>.yuja.com/D/OauthAuthentication
- Download het JSON-metadatabestand uit de Google API Console. Dit bevat de benodigde parameters voor het configureren van YuJa.
De Google OAuth-integratie configureren in het videoplatform
- Meld u aan bij uw YuJa-zone als IT-manager en ga naar Admin Paneel → Integraties.
- Selecteer onder Selecteer een API om te configureren de optie SSO - Google OAuth 2.0.
- Voer de volgende configuratieparameters in:
Parameter
Waarde
Client-ID
De client-ID die u hebt verkregen via de Google API Console.
https://console.developers.google.com
Ook te vinden in de JSON-gegevens van uw project als waarde van het kenmerk “client_id”.
Clientgeheim
Het clientgeheim dat u hebt verkregen via de Google API Console. https://console.developers.google.com
Ook te vinden in de JSON-gegevens van uw project als waarde van het kenmerk “client_secret”.
Auth-URI
Te vinden in de JSON-gegevens van uw project als waarde van het kenmerk “auth_uri”.
Token-URI
Te vinden in de JSON-gegevens van uw project als waarde van het kenmerk “token_uri”.
- Klik op Configuratie aanmaken.
- Klik op OK in het pop-upvenster voor bevestiging.
- Klik op OAuth-login testen om te testen of de configuratie correct is. Hierdoor wordt een nieuw tabblad geopend en wordt u doorgestuurd naar Google, dat de authenticatie en de toestemming van de gebruiker afhandelt.
- Als er momenteel geen Google-gebruiker is aangemeld, voer dan geldige inloggegevens in en klik op Inloggen. Kies anders een Google-account.
- Klik op Toestaan om het videoplatform toestemming te geven voor toegang tot de basisgegevens van de gebruiker.
- U zou terug moeten worden geleid naar het videoplatform, aangemeld als nieuwe gebruiker.
Aanmelden als nieuwe gebruiker kan ertoe leiden dat het oorspronkelijke account wordt afgemeld. Meld u in dat geval af bij het nieuw aangemaakte account, meld u opnieuw aan als IT-manager en ga terug naar Admin Paneel → Integraties → SSO – Google OAuth 2.0.
- Zodra u hebt gecontroleerd dat de OAuth-SSO werkt, kunt u ervoor kiezen het nieuwe authenticatieschema voor uw organisatie te activeren door op Activeer te klikken.
Activeer het nieuwe authenticatieschema pas nadat u een testlogin met succes hebt uitgevoerd en u het beschikbaar wilt maken voor alle gebruikers in uw organisatie.
(Optioneel) Dubbele integratie met LTI
Als uw organisatie zowel LTI- als Google OAuth-SSO-toegang heeft ingeschakeld, kunt u ervoor kiezen de twee integraties aan elkaar te koppelen. Standaard krijgt een gebruiker die zich zowel via LTI als via OAuth aanmeldt voor elke aanmelding een afzonderlijk account voor het videoplatform. Als uw LTI-provider is geconfigureerd om gebruikers te authenticeren met hun Google-accountgegevens, kunt u de twee accounts koppelen, omdat de LTI-provider het videoplatform een unieke identificatie van de gebruiker in het OAuth-systeem geeft.
- Configureer uw LMS zo dat het een aangepaste LTI-parameter met de naam lis_person_sourcedid doorgeeft die de overeenkomende SSO-waarde bevat. Dit kan een e-mailadres, medewerkers-ID of ander veld zijn. Het videoplatform gebruikt deze functie om de twee aanmeldmethoden aan hetzelfde account te koppelen.
- Bepaal de kenmerknaam waarvan de waarde overeenkomt met de unieke identificatie die de LTI-provider gebruikt. De mogelijke waarden die u kunt gebruiken, worden bepaald door de Google API. Omdat het videoplatform alleen basisprofielgegevens van een specifieke gebruiker opvraagt, is het enige geldige kenmerk 'email'.
- Voer deze waarde in bij Admin Paneel → Integraties → Selecteer een API om te configureren → SSO - Google OAuth 2.0 → Koppelingsattribuut en selecteer Cross-integratie opslaan.
- Wanneer een gebruiker zich voor het eerst via Google OAuth aanmeldt, zoekt het systeem van het videoplatform nu naar een koppeling met een LTI-account aan de hand van de waarde van het koppelingsattribuut. Als die wordt gevonden, wordt het Google-account aan het bestaande account gekoppeld. Anders wordt zoals gebruikelijk een nieuw account aangemaakt. Alle aanmeldingen na de eerste blijven gekoppeld aan het account voor het videoplatform dat bij de eerste aanmelding is aangemaakt of gevonden.
Gebruik
Zodra de Google API Console en het videoplatform correct zijn geconfigureerd en de OAuth-SSO is geactiveerd, worden gebruikers die naar het domein van het videoplatform van uw organisatie gaan, geauthenticeerd via Google OAuth 2.0 in plaats van via de standaardaanmelding van het videoplatform. Met de onderstaande stappen kunt u eenvoudig controleren of alles correct is ingesteld:
- Ga naar de zone van het videoplatform van de organisatie.
- Klik op Inloggen. De gebruiker zou hierdoor moeten worden doorgestuurd naar Google, waar hij of zij een account selecteert en toestemming geeft voor toegang van het videoplatform tot de basisgegevens.
- Na autorisatie zou de gebruiker terug moeten worden geleid naar het videoplatform en succesvol zijn aangemeld.