Sluit je een OOAPI endpoint aan op SURFeduhub om gebruik te maken van de RIO functionaliteit? Kijk dan ook vast eens bij het Draaiboek aansluiten RIO via SURFeduhub.
Organisatorische stappen
Voordat een instelling technisch kan aansluiten, moeten er een aantal organisatorische stappen gezet zijn:
| # | Actor | Stap |
|---|---|---|
| 1 | SURF Instellingscontactpersoon van de instelling (ICP) | De ICP vraagt de dienst SURFeduhub via het SURF Dashboard: https://dashboard.surfnet.nl//index.php |
| 2 | Klantsupport SURF | De afdeling Klantsupport van SURF neemt de aanvraag in behandeling en stuurt de instelling een Dienstbijlage op. |
| 3 | Instelling | De instelling tekent de bijlage en stuurt die terug naar SURF. |
| 4 | SURF | Na het ontvangen van de getekende bijlage start SURF het verdere aansluitingsproces op. |
Betrokken omgevingen
| Test | Productie | |
|---|---|---|
| Instelling | Test endpoint | Productie OOAPI endpoint |
| SURF | SURFeduhub Sandbox | SURFeduhub Live |
Draaiboek
| # | Test | Prod | Actor | Stap |
|---|---|---|---|---|
| 1 | SURF | Nadat de organisatorische stappen afgerond zijn, verstuurt SURF een verzoek naar de SURFeduhub contactpersoon om de benodigde gegevens op te sturen om het OOAPI endpoint van de instelling aan te kunnen sluiten. In het verzoek is duidelijk uitgelegd welke gegevens nodig zijn. Het gaat om:
| ||
| 2 | SURFeduhub contactpersoon van de instelling | Stuurt de gevraagde aansluitgegevens en credentials op een veilige manier op naar SURF. Als de instelling gebruik maakt van een OOAPI endpoint dat door een SIS leverancier geleverd wordt, dan kan de SIS leverancier de instelling van de juiste gegevens voorzien. Het veilig versturen van de credentials kan door ze in een tekstbestand te zetten en dit via filesender.surf.nl versleuteld te versturen naar surfeduhub-beheer@surf.nl. Het wachtwoord voor de versleutelde bestanden kan vervolgens via Signal/Whatsapp/SMS verstuurd worden naar team SURFeduhub. Vraag daarvoor via surfeduhub-beheer@surf.nl een mobiel nummer op. | ||
| 3 | SURF | Voegt het OOAPI endpoint van de instelling toe aan de configuratie van SURFeduhub en voert de volgende tests uit:
Verder maakt SURF een testaccount aan voor de instelling en stuurt deze credentials op naar de instelling. Daarbij wordt de instelling ook gewezen op de mogelijkheid om het proces te starten om bijvoorbeeld gebruik te gaan maken van de RIO functionaliteit en om ook op productie een endpoint te koppelen aan SURFeduhub. |
Dit draaiboek zal in de meeste gevallen twee keer per instelling doorlopen worden: 1x voor de SURFeduhub sandbox en 1x voor de SURFeduhub live omgeving.