Eén organisatie, meerdere Moodles
Een organisatie kan meerdere Moodle-verbindingen hebben — zo veel als je abonnement toestaat, en de pagina vermeldt hoeveel plaatsen er over zijn. Elke verbinding hoort 1-op-1 bij een installatie (productie en test, of één per instelling) en heeft eigen inloggegevens, eigen sleutels, een eigen connector-URL en een eigen gebruiksoverzicht.
Registreer de site
-
Open Organisatie → Moodle en vul Een Moodle-site verbinden in: een verbindingsslug — kleine letters, cijfers en koppeltekens, bijvoorbeeld main-campus — en de Moodle-URL van de site. HTTPS is verplicht en de URL wordt gecontroleerd tegen privéadresbereiken, dus een site die niet publiek bereikbaar is, wordt hier geweigerd.
-
Het paneel genereert twee inloggegevens en toont ze één keer:
- de licentiesleutel, die je installatie identificeert;
- het paneelgeheim, waarmee elk verzoek tussen plug-in en paneel wordt ondertekend.
Ernaast zie je ook de connector-URL van deze verbinding — dat is geen geheim en je kunt hem op elk moment opnieuw raadplegen op de pagina van de verbinding.
-
Kopieer de waarden en plak ze in de plug-in: zie de Moodle-plug-in.
Alleen de licentiesleutel geeft geen enkele toegang: elk verzoek moet ook een geldige handtekening dragen die met het geheim is berekend, dus het paar werkt alleen samen.
Controleer de koppeling
De knop Licentie valideren in de plug-in bevestigt de inloggegevens en dat de URL die in het paneel staat overeenkomt met de site die daadwerkelijk belt. Na een geslaagde controle bewaart het paneel de naam, versie en taal van je site op basis van Moodles eigen site-informatie, en toont die op de Moodle-pagina.
Mislukt de controle, dan behandelt problemen oplossen de gebruikelijke oorzaken.
Vernieuw de inloggegevens
Organisatie → Moodle → Inloggegevens vernieuwen maakt de huidige licentiesleutel en het geheim onmiddellijk ongeldig en geeft een nieuw paar uit, dat één keer wordt getoond. Alle eigenaren en beheerders krijgen een beveiligingsmelding.
Vernieuw wanneer:
- het geheim mogelijk is blootgesteld (per e-mail verstuurd, in een repository beland, gezien door iemand die niet meer bij je organisatie hoort);
- je de site naar een andere server of hostingpartij verhuist;
- je de waarden kwijt bent en een werkend paar nodig hebt.
De verbinding werkt niet meer tot je het nieuwe paar in de plug-in plakt, dus reken op een paar minuten uitval voor de assistenten.
De site-URL wijzigen
Een gewijzigde URL doorloopt dezelfde validatie opnieuw. Verhuist je Moodle naar een ander domein, werk de URL dan eerst hier bij en valideer daarna opnieuw vanuit de plug-in. Sleutels blijven werken: die horen bij de verbinding, niet bij de hostnaam.
Verbinding verbreken
Bij het verbreken worden de opgeslagen inloggegevens en de versleutelde Moodle-tokens verwijderd, en het MCP-eindpunt wordt niet meer gevonden. Bestaande sleutels stoppen meteen met werken. De webservicetokens zelf blijven in je Moodle staan tot je ze daar verwijdert, dus trek ook de gebruikers in de plug-in in als je de site uit dienst neemt.