Plugin installieren
Jedes Plugin verwendet denselben dreistufigen Installationsassistenten: Berechtigungseinwilligung, Konfiguration und Bestaetigung. Diese Anleitung erklaert jeden Schritt im Detail.
Wer kann Plugins installieren
Nur Benutzer mit der Admin-Rolle auf einem Subkonto koennen Plugins installieren oder deinstallieren. Betreiber mit den Rollen Manager, Disponent oder Mechaniker koennen den Marktplatz sehen, aber nicht installieren.
Wenn sich Ihr Subkonto im kostenlosen Tarif befindet, koennen Sie bis zu zwei kostenlose Plugins installieren. Kostenpflichtige Tarife erhalten unbegrenzte Installationen.
Schritt 1 - Berechtigungseinwilligung
Wenn Sie auf einer Plugin-Detailseite auf Installieren klicken, oeffnet sich der Assistent mit einer klaren Berechtigungsliste:
Slack moechte:
- Fahrten lesen
- Fahrzeuge lesen
- Zonen lesen
Jeder Punkt entspricht einem oder mehreren Berechtigungs-Scopes im Manifest des Plugins. Der Assistent gruppiert verwandte Scopes in einzelne Punkte, damit die Liste lesbar bleibt.
Admin-Klasse-Scopes
Einige Berechtigungen sind hoeheres Risiko. Diese werden in Bernsteinfarbe angezeigt und erfordern eine explizite Checkbox-Bestaetigung:
| Scope | Was es bedeutet |
|---|---|
read:customers.pii | Lesen von Fahrernamen, E-Mails, Telefonnummern |
write:vehicles.status | Fahrzeuge sperren, entsperren oder Status aendern |
write:zones | Zonen erstellen, bearbeiten oder loeschen |
read:rides.financial | Zugriff auf Fahrtpreise, Gebuehren und Auszahlungen |
Wenn das Plugin nur normale Scopes benoetigt (wie read:rides), ist keine Bernsteinfarbe-Bestaetigung erforderlich.
Berechtigungen sind auf Ihr Subkonto beschraenkt
Ein von Subkonto A erteiltes Plugin-Token kann niemals Daten in Subkonto B lesen. Subkonten-uebergreifender Zugriff wird auf Datenbankebene ueber Row-Level Security erzwungen - es gibt keine Moeglichkeit fuer ein Plugin, den Scope zu eskalieren.
Schritt 2 - Konfigurieren
Das Konfigurationsformular wird automatisch aus dem config_schema (JSON Schema) des Plugins generiert. Verschiedene Plugins fragen nach verschiedenen Dingen:
- API-Schluessel - Veriff, Persona, Captur.ai
- OAuth-Verbindung - Slack (Workspace), Zapier (Zapier-Konto)
- Webhook-Ziel-URL - fuer selbstgebaute Plugins
- Schwellenwerte, Kanaele, Filter - plugin-spezifische Anpassung (z. B. "an #ops posten, wenn ein Fahrzeug weniger als 20 % Batterie hat")
OAuth-Fluss
Wenn das Plugin OAuth verwendet (Slack ist das haeufigste Beispiel), klicken Sie auf Verbinden und werden auf die Autorisierungsseite des Anbieters umgeleitet. Genehmigen Sie die angeforderten Scopes, und Sie werden mit hergestellter Verbindung zu Levy zurueckgeleitet.
Waehrend OAuth ausgestellte Tokens werden verschluesselt im Ruhezustand in Supabase Vault gespeichert. Levy zeigt das Roh-Token nach dem ersten Austausch nie an.
Verschluesselte Geheimnisse
API-Schluessel und andere sensible Felder werden ebenfalls in Supabase Vault gespeichert, pro Zeile verschluesselt. Sie werden nur entschluesselt, wenn der Handler des Plugins sie benoetigt, um die API des Anbieters aufzurufen.
Schritt 3 - Bestaetigen
Der letzte Bildschirm fasst zusammen:
- Den Plugin-Namen und die Version
- Die erteilten Berechtigungen
- Das Preismodell (kostenlos, einmalig, monatlich, Nutzung)
- Den Link zu den Nutzungsbedingungen des Anbieters
Klicken Sie auf Installieren. Wenn das Plugin kostenpflichtig ist:
- Einmalig - Stripe belastet Ihre Karte sofort.
- Monatlich - Stripe erstellt ein Abonnement. Erste Belastung wird auf Ihren Abrechnungszyklus anteilig berechnet.
- Nutzung - heute keine Gebuehr; Sie werden monatlich basierend auf der tatsaechlichen Nutzung abgerechnet.
Sie werden zu Einstellungen -> Plugins zurueckgeleitet, wo die neue Installation als Aktiv angezeigt wird.
Plugin neu installieren
Wenn Sie ein Plugin zuvor deinstalliert haben, wird bei der Neuinstallation dieselbe Installationszeile wiederverwendet. Ihre alte Konfiguration ist weg (das 30-Tage-Soft-Delete-Fenster ist abgelaufen, bevor die meisten Betreiber neu installieren), sodass Sie Ihre Konfiguration von Grund auf neu eingeben. Jedes Subkonto kann nur eine aktive Installation pro Plugin haben.
Haeufige Installationsfehler
| Fehler | Ursache | Loesung |
|---|---|---|
| "Sie benoetigen die Admin-Rolle, um Plugins zu installieren" | Als Manager / Disponent angemeldet | Bitten Sie einen Subkonto-Admin um die Installation |
| "Limit fuer kostenlose Plugins erreicht" | Bereits 2 kostenlose Plugins im kostenlosen Tier installiert | Deinstallieren Sie eines oder upgraden Sie den Tarif |
| "OAuth-Rueckruf abgelehnt" | Anbieter hat einen Fehler zurueckgegeben | Pruefen Sie die Statusseite des Anbieters; erneut versuchen |
| "Stripe-Belastung fehlgeschlagen" | Karte abgelehnt fuer kostenpflichtiges Plugin | Zahlungsmethode in Einstellungen -> Abrechnung aktualisieren |
| "Plugin-Manifest nicht mehr gueltig" | Anbieter hat waehrend der Installation eine breaking Version gepusht | Seite aktualisieren und erneut einwilligen |
Was kommt als naechstes
- Plugin konfigurieren - Einstellungen nach der Installation bearbeiten
- Plugin-Abrechnung - wie Belastungen, Erstattungen und die 20-%-Gebuehr funktionieren
- Fehlerbehebung - Webhook-Fehler, Token-Rotation und mehr