Overzicht
Dit document begeleidt gebruikers bij het integreren van de CAS-server (Central Authentication Service) van hun organisatie als SSO-systeem om gebruikers aan te melden bij het YuJa Enterprise Video Platform. Na een correcte configuratie wordt een gebruiker die toegang probeert te krijgen tot het videoplatform eerst doorgestuurd naar de CAS-server en om inloggegevens gevraagd. Na authenticatie wordt de gebruiker teruggeleid naar het videoplatform, waar hij of zij wordt geverifieerd en aangemeld.
Instellen
De configuratie bestaat uit het autoriseren van het videoplatform om de CAS-server te gebruiken. Zodra het videoplatform als service is geautoriseerd, bestaat de integratie uit het opgeven van de benodigde configuratieparameters en het testen. De volgende stap is het activeren van de nieuwe SSO, zodat gebruikers van uw instelling zich via CAS-authenticatie kunnen aanmelden.
Bij sommige stappen moet <organization> worden vervangen door de wildcard-DNS van de instelling die aan het videoplatform is gekoppeld. Voor “https://hudson.yuja.com” wordt <organization> bijvoorbeeld vervangen door “hudson”.
Het videoplatform autoriseren als service op de CAS-server
- Ga naar de Services Management Console (https://<CAS domain>/cas/services/) van de CAS-server, meld u aan en klik op Add New Service.
- Voer in het veld Name YuJa in.
- Voer in het veld Service URL 'https://<organization>.yuja.com/D/CasHandleTicket' in, zonder de aanhalingstekens.
- Voer in het veld Description een beschrijving in.
- Vink bij Status de opties Enabled, Allowed to Proxy en SSO participant aan. Vink Anonymous Access niet aan.
-
Bij Attributes moeten de volgende attributen aan het videoplatform worden doorgegeven. Noteer voor elk attribuut het gebruikte label. Dit hebt u nodig bij het configureren van de kant van het videoplatform.
- Principal Name (d.w.z. gebruikersnaam)
- FirstName
- Last Name
- Role
- Klik op Save Changes.
Een gebruiker van het videoplatform kan drie rollen hebben: “Student”, “Instructeur” en “IT-manager”. Als de mogelijke waarden voor het kenmerk Role afwijken van deze 3 opties, geef dan alle mogelijke Role-waarden door aan het videoplatform; deze worden dan gekoppeld aan een van de drie opties.
De CAS-configuratie aan de kant van het videoplatform
- Ga naar de zone van het videoplatform van uw instelling en meld u aan als IT-manager.
- Ga in het Hoofdmenu rechtsboven naar het tabblad Admin Paneel.
- Ga in de linkerzijbalk naar Integraties.
- Kies onder Selecteer een API om te configureren de optie SSO – CAS.
-
Voer de configuratieparameters in:
- CAS-server-URL: https://<CAS domain>/cas
- Voer voor elk attribuutlabel de bijbehorende waarden in die u hebt genoteerd bij het toevoegen van het videoplatform als service in de sectie Het videoplatform autoriseren als service op de CAS-server.
- Klik op Creëren.
- Klik op OK in het bevestigingsvenster.
- Indien nodig kunt u de configuratie-instellingen aanpassen als u een fout hebt gemaakt. Klik gewoon op Opslaan om de wijzigingen te behouden.
- Klik op CAS-login testen om te testen of de configuratie correct is. Hierdoor wordt een nieuw tabblad geopend en gaat u naar uw CAS-server, waar om aanmelding wordt gevraagd.
- Meld u aan bij uw SSO met geldige inloggegevens.
- 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 – CAS.
- Zodra u hebt gecontroleerd dat de CAS-SSO werkt, kunt u ervoor kiezen het nieuwe authenticatieschema voor uw instelling te activeren. Klik hiervoor op Activeer en vervolgens op OK in het bevestigingsvenster.
Activeer het nieuwe authenticatieschema pas nadat u een testlogin met succes hebt uitgevoerd en u het beschikbaar wilt maken voor alle gebruikers in uw instelling.
Dubbele integratie met LTI
Als uw instelling zowel LMS-integratie via LTI als SSO-toegang heeft ingeschakeld, kunt u ervoor kiezen de twee integraties aan elkaar te koppelen. Dit raden wij over het algemeen aan, omdat uw gebruikers hierdoor dezelfde accountgegevens voor het videoplatform te zien krijgen, ongeacht of zij zich via hun LMS of via hun SSO aanmelden.
Als Dubbele integratie met LTI daarentegen niet is ingesteld, krijgt een gebruiker die zowel zijn LMS als SSO met het videoplatform gebruikt twee afzonderlijke accounts, wat in veel gevallen niet ideaal is. Als uw LTI-provider binnen uw LMS kan worden geconfigureerd om het videoplatform een unieke identificatie van de gebruiker in het CAS-systeem te geven, kunt u de twee accounts koppelen.
- Configureer uw LMS zo dat het een aangepaste LTI-parameter met de naam lis_person_sourcedid doorgeeft aan de tool van het videoplatform, die de overeenkomende SSO-waarde bevat. Dit kan een e-mailadres, medewerkers-ID of ander veld zijn. Mogelijk moet u de productdocumentatie van uw LMS-platform raadplegen om te zien hoe u aangepaste LTI-parameters instelt. 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.
- Voer deze waarde in het veld Koppelingsattribuut in, bijvoorbeeld external. Dit is hetzelfde kenmerk als in het bestand attribute-repository.json in C:\etc\cas op de CAS-server. Dit tekstvak verschijnt alleen als uw instelling LTI-toegang heeft ingeschakeld.
- Klik op Cross-integratie opslaan.
- Wanneer u zich voor het eerst via CAS aanmeldt, zoekt 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 CAS-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 configuratie is voltooid aan zowel de kant van de CAS-server als de kant van het videoplatform en de CAS-SSO is geactiveerd, worden gebruikers van uw instelling niet langer door het videoplatform geauthenticeerd. Wanneer zij naar de zone van het videoplatform van uw instelling gaan en zich willen aanmelden, worden zij in plaats daarvan doorgestuurd naar de CAS-server voor authenticatie en na succesvolle authenticatie teruggeleid naar het videoplatform.
Beheerders kunnen een secundaire CAS-provider implementeren. Neem contact op met uw accountmanager om deze functie in te schakelen.