Site verbinden

Eine Organisation, ein Moodle

Jede Organisation besitzt genau eine Moodle-Verbindung. Da die Verbindung 1:1 zu einer Installation gehört, brauchen Sie bei mehreren Installationen (Produktion und Test, oder mehrere Einrichtungen) je eine eigene Organisation — jede mit eigenem Endpunkt, eigenen Schlüsseln und eigener Nutzung.

Site registrieren

1. Öffnen Sie Organisation → Moodle und geben Sie die URL Ihres Moodle ein. HTTPS ist Pflicht, und die URL wird gegen private Adressbereiche geprüft — eine nicht öffentlich erreichbare Site wird hier abgelehnt.

2. Das Panel erzeugt zwei Zugangsdaten und zeigt sie nur einmal an:

   • den Lizenzschlüssel, der Ihre Installation identifiziert;
   • das Panel-Geheimnis, mit dem jede Anfrage zwischen Plugin und Panel signiert wird.

   Daneben sehen Sie auch Ihre Subdomain und die URL Ihres MCP-Endpunkts — diese beiden sind keine Geheimnisse, Sie können sie sich auf derselben Seite jederzeit wieder ansehen.

3. Kopieren Sie die Werte und fügen Sie sie im Plugin ein: siehe Moodle-Plugin.

Der Lizenzschlüssel allein gewährt nichts: Jede Anfrage muss zusätzlich eine gültige, mit dem Geheimnis berechnete Signatur tragen — das Paar funktioniert nur gemeinsam.

Verbindung prüfen

Die Schaltfläche Lizenz prüfen im Plugin bestätigt die Zugangsdaten und dass die im Panel hinterlegte URL mit der tatsächlich aufrufenden Site übereinstimmt. Nach erfolgreicher Prüfung speichert das Panel Name, Version und Sprache Ihrer Site aus Moodles eigener Site-Information zwischen und zeigt sie auf der Moodle-Seite an.

Schlägt die Prüfung fehl, deckt die Fehlerbehebung die üblichen Ursachen ab.

Zugangsdaten wechseln

Organisation → Moodle → Zugangsdaten erneuern macht Lizenzschlüssel und Geheimnis sofort ungültig und stellt ein neues Paar aus, das einmal angezeigt wird. Alle Eigentümer und Administratoren erhalten eine Sicherheitsmeldung.

Erneuern Sie, wenn:

• das Geheimnis offengelegt worden sein könnte (per E-Mail verschickt, in ein Repository geraten, von jemandem gesehen, der nicht mehr dabei ist);
• Sie die Site auf einen neuen Server oder Hosting-Anbieter umziehen;
• Sie die Werte verloren haben und ein funktionierendes Paar brauchen.

Die Verbindung ruht, bis Sie das neue Paar im Plugin eingefügt haben — planen Sie also ein paar Minuten Ausfall für die Assistenten ein.

Site-URL ändern

Eine geänderte URL löst dieselbe Prüfung erneut aus. Wechselt Ihr Moodle die Domain, aktualisieren Sie sie zuerst hier und prüfen Sie dann erneut im Plugin. Die Schlüssel funktionieren weiter: Sie hängen an der Verbindung, nicht am Hostnamen.

Verbindung trennen

Beim Trennen werden die gespeicherten Zugangsdaten und die verschlüsselten Moodle-Token entfernt, und der MCP-Endpunkt wird nicht mehr aufgelöst. Bestehende Schlüssel funktionieren sofort nicht mehr. Die Webservice-Token verbleiben in Ihrem Moodle, bis Sie sie dort entfernen — widerrufen Sie die Nutzer also auch im Plugin, wenn Sie die Site stilllegen.