Je site verbinden

Eén organisatie, één Moodle

Elke organisatie is eigenaar van precies één Moodle-verbinding. Omdat de verbinding 1-op-1 bij een installatie hoort, betekenen meerdere Moodles (productie en test, of meerdere instellingen) één organisatie per installatie: elk met een eigen eindpunt, eigen sleutels en eigen gebruik.

Registreer de site

1. Open Organisatie → Moodle en vul de URL van je Moodle in. HTTPS is verplicht en de URL wordt gecontroleerd tegen privéadresbereiken, dus een site die niet publiek bereikbaar is, wordt hier geweigerd.

2. 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 je subdomein en de URL van je MCP-eindpunt — deze twee zijn geen geheimen en je kunt ze op elk moment opnieuw raadplegen op deze pagina.

3. 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.