Schlüssel und Berechtigungen
Ein Schlüssel ist eine Moodle-Identität
Jeder MCP-Schlüssel umschließt ein Moodle-Webservice-Token und die Rollen, mit denen dieses Token handelt. Ruft ein Assistent ein Werkzeug auf, führt Ihr Moodle es als diese Person aus — Moodles eigene Rechte sind also die äußere Grenze. Ein Schlüssel für eine Lehrkraft kann den Kurs einer anderen Lehrkraft nicht lesen, egal was der Assistent fragt.
Erkannte Rollen: admin, manager, editingteacher, teacher, student und user. Werkzeuge außerhalb der Rollen eines Schlüssels werden dem Assistenten weder angezeigt noch lassen sie sich ausführen.
Lebenszyklus eines Schlüssels
Schlüssel entstehen unter Organisation → Moodle → MCP-Schlüssel oder im Bereich Nutzer des Plugins (dort erscheinen sie als erstellt von: moodle). Der Wert wird nur einmal angezeigt: Behandeln Sie ihn wie ein Passwort. Danach kennt das Panel nur noch seinen Hash, die letzten vier Zeichen und den Status.
| Status | Wirkung |
|---|---|
| Aktiv | Funktioniert normal. |
| Gesperrt | Wird abgewiesen, bis er reaktiviert wird. Umkehrbar. |
| Widerrufen | Dauerhaft tot. Nicht umkehrbar — stellen Sie einen neuen aus. |
| Abgelaufen | Nach seinem Ablaufdatum, falls eines gesetzt war. |
Die Authentifizierung erfolgt bei jeder Anfrage, eine Statusänderung greift also beim nächsten Aufruf des Assistenten — es gibt keine Sitzung, die erst ablaufen müsste.
Schlüssel weiter einschränken
Rollen setzen die Obergrenze; diese Einschränkungen senken sie. Nützlich, wenn Sie einen Schlüssel an eine Person, eine Abteilung oder eine Automatisierung geben, die nicht alles dürfen soll, was das Moodle-Konto erlaubt.
- Nur Lesen: Der Schlüssel darf nur lesende Werkzeuge ausführen. Jedes verändernde Werkzeug wird abgelehnt, selbst wenn die Rolle es erlaubte. Das Sicherste, was Sie herausgeben können.
- Erlaubte Werkzeuge: eine ausdrückliche Namensliste. Was nicht gelistet ist, wird abgelehnt — so bauen Sie einen eng zugeschnittenen Schlüssel mit klarem Zweck.
- Erlaubte Kurse: eine Liste von Kurs-IDs. Jeder Aufruf, der einen Kurs außerhalb der Liste nennt, wird zurückgewiesen, sodass sich ein Schlüssel auf einen Studiengang begrenzen lässt.
- Ablauf: ein optionales Datum, ab dem der Schlüssel nicht mehr funktioniert. Gut für Dienstleister, Pilotprojekte und Demos.
Die Einschränkungen werden serverseitig bei jedem Aufruf durchgesetzt, auch bei Aufrufen über die Gateway-Werkzeuge — ein Assistent kann sie nicht umgehen, so sehr er es auch versucht.
Welcher Schlüssel was antreibt
- Ein externer Assistent nutzt den Schlüssel, den Sie in diesem Client hinterlegt haben.
- Der KI-Chat im Panel nutzt den Schlüssel, den ein Eigentümer oder Administrator unter Organisation → Moodle → Chat-Identität auswählt. Dessen Rollen werden zur Moodle-Identität des Chats, serverseitig bei jeder Nachricht aufgelöst; der Schlüsselwert erreicht nie den Browser.
- Mit Ihrem Moodle anmelden (OAuth) bindet den Assistenten an die Identität der angemeldeten Person, ganz ohne Schlüssel zum Kopieren oder Speichern.
Bewährte Praxis
- Ein Schlüssel je Person oder Integration: geteilte Schlüssel lassen sich nicht gezielt widerrufen.
- Bevorzugen Sie Nur-Lesen, solange der Assistent nicht wirklich etwas in Moodle ändern muss.
- Setzen Sie ein Ablaufdatum für alles Vorübergehende.
- Prüfen Sie zuletzt genutzt in der Schlüsselliste und widerrufen Sie, was lange ruht.
- Widerrufen Sie beim Ausscheiden eines Mitglieds dessen Schlüssel zusätzlich zum Entfernen aus der Organisation — das sind zwei getrennte Schritte, siehe Organisationen und Mitglieder.
- Erneuern Sie den Schlüssel, wenn jemand das Team verlässt, statt darauf zu vertrauen, dass sein Postfach sauber war.