Plugins
Ein Plugin ist eine einzige WebAssembly-Datei. Dieselbe Datei läuft in der Mac-App, in der Web-App und in rt. Es kann Requests vor dem Senden ändern, Antworten kommentieren, Reiter beisteuern und Importer mitbringen – in einer Sandbox, mit Rechten, die du vor der Installation siehst, und ohne je einen Secret-Wert zu sehen.
- Edition
- Free
- Format
- eine
.wasm-Datei mit eingebettetem Manifest - Rechte
- network (Hosts), storage, variables
- Verwalten
- Manage plugins… in der Befehlspalette
- Schreiben
- Rust mit dem Plugin-SDK
Was ein Plugin kann
| Erweiterungspunkt | Wann er läuft |
|---|---|
| Prepare | Vor jedem Senden, nach der Authentifizierung und vor dem Signieren; darf den Request ändern |
| Response | Nach jeder Antwort; darf Hinweise anfügen |
| Tabs | Reiter im Request-Editor, in der Antwort oder für die Collection, aus deklarativen Bausteinen (Text, Tabellen, Bäume, Formulare, Knöpfe) |
| Importer | Wandeln Dateien im Dialog Import und in rt import in eine Collection, mit Verlustbericht |
Prepare und Response laufen auch in rt send und rt run, genau wie in den Apps; Reiter gibt es nur in den Apps. Ein Beispiel ist das mitgelieferte OData-Plugin für SAP (OData und SAP): Das SAP-Wissen steckt im Plugin, nicht im Kern1.
Die Sandbox
- Kein nativer Code2: Plugins sind ausschließlich WebAssembly und laufen in einem Interpreter, der überall gleich arbeitet.
- Kein Dateisystem, keine Threads und kein Netz außer über den HTTP-Aufruf des Hosts.
- Jeder Aufruf läuft in einer frischen Instanz mit Rechengrenze und höchstens 64 MiB Speicher.
- Plugins sehen nie Secret-Werte: Requests und Antworten erreichen sie maskiert.
- Stürzt ein Plugin ab, meldet der Host es als fehlgeschlagen und läuft weiter.
Rechte
Ein Plugin erklärt in seinem Manifest, was es braucht, und du siehst das vor der Installation:
| Recht | Erlaubt |
|---|---|
network | HTTP-Requests nur an die genannten Hosts ({request} heißt: der Host des gerade gesendeten Requests) |
storage | Einen eigenen Schlüssel-Wert-Speicher je Plugin und Gerät |
variables | Lesen der nicht geheimen Variablen im Geltungsbereich |
Verlangt ein Update mehr Rechte, fragt RequestTailor erneut, bevor es sie gewährt.
Installieren und verwalten
- In der Befehlspalette Manage plugins… wählen.
- Install from file… klicken und die
.wasm-Datei wählen. - Die angefragten Rechte prüfen und mit Install bestätigen.
- Im selben Dialog schaltest du Plugins ein und aus oder entfernst sie mit Remove.
Installierte Plugins liegen im Datenordner der App; Mac-App und rt teilen sie sich. Die Web-App speichert sie im Browser. Ein ausgeschaltetes Plugin hat keine Reiter, keine Hooks und keine Beschreibung. Das mitgelieferte OData-Plugin ist installiert, aber aus, bis du es beim ersten Start oder später hier einschaltest.
Auf der Kommandozeile läuft ein Plugin auch ohne Installation:
rt send request.yml --plugin target/plugins/hello.wasm --pretty
Ein Plugin schreiben
Plugins schreibst du in Rust mit dem Plugin-SDK und baust sie mit einem Befehl aus dem Repo des Kerns:
node scripts/build-plugins.mjs hello # baut plugins/hello nach target/plugins/hello.wasm
Die vollständige Anleitung mit Beispiel, Testwerkzeugen und Versionsregeln steht in plugins/README.md, die binäre Schnittstelle in crates/rt-plugin/API.md. Die Plugin-API ist öffentlich und versioniert. Ein TypeScript-SDK hat die Typen und einen Test-Host; Plugins aus TypeScript zu bauen geht noch nicht.
Siehe auch
- Funktionen im Überblick Funktionen · sap
- Doku OData und SAP
- Doku Import
- Doku Kommandozeile rt
- Belege Plugins2 · OData-Plugin1