SURFconext Cookbook. Het koppelen van BigBlueButton aan SURFconext. Versie: 1.0. Datum: 1 december admin@surfnet.nl

Transcriptie

1 SURFconext Cookbook Het koppelen van BigBlueButton aan SURFconext Auteur(s): Frank Niesten Versie: 1.0 Datum: 1 december 2013 Radboudkwartier CK Utrecht Postbus DA Utrecht admin@surfnet.nl ING Bank NL54INGB KvK Utrecht BTW NL B01

2 Inhoudsopgave 1 Inleiding Benodigdheden Stappenplan Voorbereiding BigBlueButton SURFconext gebruiken als Service Provider (SP) Aan de slag Voorbereiding simplesamlphp testen met het Do It Yourself (DIY) platform Dienst naar productie brengen BigBlueButton Updates... 8 Deze publicatie is gelicenseerd onder een Creative Commons Naamsvermelding 3.0 Unported licentie Meer informatie over deze licentie vindt u op

3 1 Inleiding Met behulp van SURFconext is het mogelijk om op eenvoudige wijze (cloud)diensten beschikbaar te maken voor werknemers, onderzoekers docenten en studenten. In deze handleiding wordt uitgelegd welke stappen een instelling moet maken om BigBlueButton te hosten en te koppelen aan SURFconext. BigBlueButton is op vele manieren te gebruiken binnen onderzoek en onderwijs. De meest gebruikte en bekendste use-case is vergaderen tussen twee of meer personen. Enkele andere voorbeelden zijn: een webinar geven (online seminar); het raadplegen van een deskundige/expert op afstand; het voeren van stage-gesprekken. Deze handleiding is geschreven voor IT architecten en ontwikkelaars. Basiskennis over het inrichten van een webserver en PHP is verreist voor het inrichten van een SURFconext Service Provider (SP). Voor de installatie van BigBlueButton is basiskennis van Ubuntu Linux nodig. 1.1 Benodigdheden server (Apache, PHP); SSL Certificaat. 1.2 Stappenplan 1. voorbereiding; 2. installeren simplesamlphp; 3. simplesamlphp testen; 4. BBBMW installeren; 5. BigBlueButton installeren; 6. applicaties configureren; 7. de dienst naar de productieomgeving brengen. 3/9

4 2 Voorbereiding 2.1 BigBlueButton BigBlueButton is een open source webconferencing-systeem dat is ontwikkeld door de universiteit van Carleton. De naam BigBlueButton is geïnspireerd op het oorspronkelijke concept dat het starten van een webconferencingsessie figuurlijk even simpel moet zijn als het indrukken van een big blue button. De software wordt actief doorontwikkeld en nieuwe functionaliteiten worden regelmatig toegevoegd. De ontwikkeling die binnenkort wordt verwacht is een HTML 5 interface voor het gebruik op mobiele devices. BigBlueButton bevat de volgende functionaliteiten: gelijktijdig communiceren in beeld en geluid; vergaderen met virtueel hand opsteken en een voorzitterrol; weergeven van presentaties en documenten (PDF, Word etc.); delen van een desktop; whiteboard; sessie opnemen (alleen documenten en audio) Authenticatie i.c.m. SURFconext Omdat de BigBlueButton software in de meeste gevallen wordt geïmplementeerd in andere systemen is er door de ontwikkelaars voor gekozen om geen eigen front-end user interface te maken, maar een API (Application Programming Interface) waar externe ontwikkelaars hun eigen plug-ins voor kunnen maken. Binnen dit Cookbook wordt alleen de front-end BBBMW besproken BBBMW BBBMW is een door SURFnet ontwikkelde connector. Deze connector maakt het mogelijk om te authentiseren via SURFconext. Het aanmaken van bijvoorbeeld een webinar gebeurt buiten de software van BigBlueButton. De groepsinformatie uit SURFteams wordt gebruikt voor het aanmaken van een webinar en het toekennen van rechten. Een webinar wordt gekoppeld aan een specifiek SURFconext-team. Op deze manier hebben alle groepsleden van het team automatisch toegang tot het webinar. 2.2 SURFconext gebruiken als Service Provider (SP) SURFconext is een middleware laag die ervoor zorgt dat een gebruiker veilig toegang krijgt tot meerdere diensten. Deze diensten integreren naadloos met de bestaande online omgeving van de eigen instelling. SURFconext is het beste te vergelijken met een groot schakelpaneel waar aan de ene kant de authenticatie-systemen (IdP s) van alle SURFnet aangesloten instellingen zijn gekoppeld en aan de andere kant de cloud- en instellingsdiensten. Dit schakelpaneel zorgt ervoor dat als een gebruiker probeert te authentiseren bij een dienst, de gebruiker wordt doorgestuurd naar de authenticatie pagina van zijn of haar eigen instelling. Indien er succesvol wordt geauthentiseerd krijgt de gebruiker toegang tot de betreffende dienst. SURFconext 4/9

5 werkt met het single sign on principe. Dit betekent eenmaal geauthentiseerd binnen SURFconext kan een gebruiker ook andere diensten gebruiken, zonder opnieuw te hoeven inloggen SAML Het koppelen van diensten aan SURFconext vindt plaats via de Security Assertion Markup Language (SAML) standaard. Een aan te sluiten dienst dient deze standaard dan ook te ondersteunen. Als dienstaanbieder is het daarom noodzakelijk om SAML te implementeren door naast een dienst ook een SAML service provider te installeren. Deze is beschikbaar voor de meest voorkomende programmeertalen zoals Java, PHP en.net. Daarnaast is het ook mogelijk om programmeertaal onafhankelijk een dienst aan te sluiten op SURFconext door een Shibboleth proxy voor een dienst te zetten. Afhankelijk van de dienst wordt er een passende SAML implementatie gekozen. BBBMW is bijvoorbeeld geschreven in de programmeertaal PHP. Als SAML implementatie wordt daarom gekozen voor simplesamlphp Identity Provider Een identity provider (IdP) verstrekt gegevens over de identiteit van de gebruiker waardoor authenticatie van de gebruiker mogelijk is. Om als gebruiker toegang te krijgen tot een dienst moet er worden geauthentiseerd bij een IdP. Op deze manier kan worden gecontroleerd wie de betreffende persoon is en welke identiteiten bij deze persoon horen. Authentiseren gebeurt in de meeste gevallen middels een gebruikersnaam en wachtwoord. Iedere instelling die aangesloten is bij SURFnet heeft een eigen IdP, gekoppeld aan SURFconext. Om instellingsoverstijgend samen te kunnen werken is het belangrijk om te weten of de betreffende instellingen zijn aangesloten bij SURFconext.! Meer informatie over IdP s is te vinden op de volgende url: Attributen Om een dienst te kunnen gebruiken moet bekend zijn van welke attributen de SURFconext aangesloten dienst gebruik maakt. Attributen zijn kenmerken van gebruikers, zoals adres, voornaam, achternaam en organisatie waarvoor iemand werkzaam is.! Meer informatie over attributen is te vinden op de volgende url: Nadat een gebruiker succesvol is geauthentiseerd, worden de vrijgegeven attributen beschikbaar gesteld aan de betreffende dienst. Een dienst kan deze informatie vervolgens gebruiken voor bijvoorbeeld het aanmaken van een gebruikersprofiel. BBBMW maakt gebruik van de volgende attributen: displayname (voor- en achternaam van een gebruiker); schachomeorganisation (bevat de naam van de organisatie waar een gebruiker werkzaam is). 5/9

6 3 Aan de slag 3.1 Voorbereiding Het is aan te bevelen om de BBBMW connector die ook de SURFconext koppeling afhandelt op een aparte server te installeren. Hierdoor wordt voorkomen dat beide applicaties elkaar in de weg zitten. Server 1 simplesamlphp BBBMW Server 2 BigBlueBu6on Voordat simplesamlphp en BBBMW kunnen worden geïnstalleerd, dient eerst een webserver te worden geïnstalleerd op het operating system (zoals bijvoorbeeld Apache). Daarnaast dient de verbinding beveiligd te worden met een officieel ondertekend SSL-certificaat. Gegevens worden hierdoor versleuteld zodat alle informatie tijdens het transport vertrouwelijk blijft en niet leesbaar is voor derden. Installeren simplesamlphp op server 1 Na de installatie van de webserver kan worden begonnen met de installatie van simplesamlphp. SimpleSAMLphp verzorgt de connectie met SURFconext. De software zorgt er onder andere voor dat een gebruiker tijdens het authentiseren wordt doorgestuurd naar SURFconext en geeft na een succesvolle authenticatie de vrijgegeven attributen door aan de BBBMW connector. Een installatie handleiding van simplesamlphp is te vinden via de url: simplesamlphp testen met het Do It Yourself (DIY) platform Als simplesamlphp is geïnstalleerd kan deze worden getest. Dit kan door de dienst te laten aansluiten op de Do It Yourself (DIY)omgeving van SURFconext. Met behulp van deze omgeving kan worden ingelogd op de dienst en is het mogelijk om de connectie tussen SURFconext en de dienst te controleren op een correcte werking. Een aansluiting op de DIY-omgeving kan worden aangevraagd bij SURFconext-beheer door een te sturen naar: surfconext-beheer@surfnet.nl De volgende gegevens van de betreffende dienst moeten worden aangeleverd bij SURFconextbeheer: Naam van dienst in het Nederlands en Engels. Administratief contactpersoon Technisch contactpersoon 6/9

7 Support contactpersoon Logo van de dienst (max. Afmetingen 500 x 300 px, png-formaat; transparant). Attributen die moeten worden vrijgegeven. URL met metadata van de betreffende dienst Installeren BBBMW op server 1 Nadat simplesaml is geïnstalleerd en getest, kan de BBBMW connector worden geïnstalleerd. De installatiebestanden en installatiehandleiding zijn te vinden op Github via de URL: Installeren BigBlueButton op server 2 Omdat BigBlueButton niet direct wordt gekoppeld als Service Providor aan SURFconext, maar via de BBBMW connector, kan de standaard installatieprocedure worden gevolgd. Er is een duidelijke handleiding beschikbaar waarin de installatie van BigBlueButton staat beschreven. Deze is te vinden op de website of rechtsreeks via de wiki in het betreffende Google code project: Een complete installatie is uit te voeren in ongeveer 30 minuten. 3.3 Dienst naar productie brengen Indien de dienst klaar is voor gebruik, kan deze worden aangesloten op de productieomgeving van SURFconext. Dit kan worden aangevraagd bij SURFconext-beheer door een te sturen naar: surfconext-beheer@surfnet.nl. De volgende gegevens moeten daarbij worden aangeleverd: Naam van de IDP die moet worden aangesloten op de dienst. Naam van dienst in het Nederlands en Engels. Omschrijving van de dienst in het Nederlands en Engels. Administratief contactpersoon Technisch contactpersoon Support contactpersoon Logo van de dienst (max. Afmetingen 500 x 300 px, png-formaat; transparant). OrganizationDisplayName: Displaynaam van de leverancier. OrganizationName: Formele naam van de leverancier. OrganizationURL: URL naar de website van de leverancier. URL naar de end user agreement. URL met support informatie over de dienst. Het formaat van het NameID. Attributen die moeten worden vrijgegeven. Lijst met IdP s die toegang moeten hebben. URL met metadata van de betreffende dienst. 7/9

8 ! Meer informatie over het aansluitproces is te vinden op de website: Configureren van BBBMW Nadat simplesamlphp, BBBMW en BigBlueButton zijn geïnstalleerd kunnen de applicaties verder worden geconfigureerd zodat deze naadloos met elkaar gaan samenwerken. De configuratie vindt plaats in het config.php bestand dat is te vinden binnen de BBBMW installatie. De volgende regels dienen aangepast te worden: Gebruik van simplesamlphp als authenticatie mechanisme: // NullAuth, SimpleAuth, SSPAuth $config['auth_type'] = 'SSPAuth'; Gebruik van SURFconext teams: // NullGroups, SimpleGroups, ConextGroups, ConextGroupsOAuth2 $config['group_type'] = 'ConextGroupsOAuth2'; URL en secret salt van de BigBlueButton API: // BigBlueButton API configuration $config['bbb_api_url'] = ' $config['bbb_salt'] = 'e3ed e0ecf9bbbf07abdc0dc12'; Locatie waar simplesamlphp is geïnstalleerd: // simplesamlphp configuration (SSPAuth) $config['ssp_path'] = '/var/simplesaml'; $config['ssp_sp'] = 'default-sp'; $config['ssp_dn_attr'] = 'displayname'; $config['ssp_org_attr'] = 'schachomeorganization'; URL s van de surfconext teams API en gebruikersnaam en wachtwoord: // Use SURFconext for accessing group membership with this OAuth information $config['conext_authorize_uri'] = ' $config['conext_token_uri'] = ' $config['conext_group_api_uri'] = ' $config['conext_key'] = 'Gebruikersnaam; $config['conext_secret'] = 'Wachtwoord'; $config['conext_redirect_uri'] = 'URL van BBBMW ( Meerdere IdP s koppelen Indien er meerdere IdP s dienen te worden gekoppeld aan de instellingsdienst kan dit door de aanvraag te mailen naar SURFconext-beheer. Het is aan te bevelen om vooraf de instellingscontactpersoon van de betreffende instelling(en) te informeren over het aanstaande koppelingsverzoek. 3.4 BigBlueButton Updates Regelmatig worden er nieuwe versies van BigBlueButton uitgebracht. Deze releases bevatten, naast nieuwe functionaliteiten, ook beveiligingsupdates die er voor zorgen dat de dienst veilig blijft en er geen beveilingslekken ontstaan. Het wordt dan ook aangeraden om BigBlueButton regelmatig te updaten. Doordat de SAML implementatie van BigBlueButton wordt geregeld door de aparte BBBMW connector, kan BigBlueButton zonder problemen worden geüpdate. 8/9

9 Het is aan te bevelen om een kopie van de BigBlueButton-installatie te maken voordat begonnen wordt aan het update proces. Mochten er onverhoopt toch problemen ontstaan, dan kan deze kopie worden gebruikt om de installatie te herstellen. Ook is het raadzaam om de SURFconext koppeling na een update te testen. Het updaten van BigBlueButton kan eenvoudig via de aanwezige repository in Ubuntu Linux. Meer informatie over dit onderwerp is te vinden via de volgende URL: 9/9