Markus Michalski FAQ

Sylius Admin: Sicherheit und Datenschutz

Sicherheit von Sylius Admin: Speicherort der Zugangsdaten, Token-Handhabung, Pfad-Allowlist, Löschschutz, Bild-Upload-Beschränkung, Stage/Prod-Trennung, was protokolliert wird und welche Daten den Rechner verlassen.

English Version

Zurück zur Übersicht

Sylius Admin: Sicherheit und Datenschutz

Diese Dokumentation bezieht sich immer auf die aktuellste veröffentlichte Version.

Zugangsdaten

Aspekt Verhalten
Speicherort Klartext in der .env-Datei der Umgebung: ~/.claude-plugin-syliusadmin/<stage oder prod>/.env. Das Plugin-Verzeichnis selbst enthält keine Zugangsdaten.
Weitergabe E-Mail und Passwort gehen ausschließlich an <SYLIUS_BASE_URL>/api/v2/admin/administrators/token. Nutze eine https://-URL; der Server erzwingt das nicht.
Token Das JWT liegt nur im Arbeitsspeicher des Server-Prozesses. Es wird 30 Sekunden vor Ablauf erneuert; fehlt ein Ablaufzeitpunkt im Token, gelten 300 Sekunden. Es wird nie auf die Platte geschrieben.
Stage-Key SYLIUS_API_KEY wird als Header X-Stage-Api-Key bei jedem Request gesendet, auch beim Login.
Setup-Skill Trägt nie Zugangsdaten für dich ein.

Schütze die .env-Dateien mit Dateirechten, nimm sie in kein Repository auf und gib sie nicht weiter.

Protokollierung

Der Server schreibt kein eigenes Log und gibt Zugangsdaten nicht aus. Die Konfigurationsklasse blendet Passwort und API-Key in ihrer Textdarstellung aus, damit sie auch in Fehlerausgaben nicht auftauchen. Ein Fehler der Sylius-API wird als Meldung an Claude zurückgegeben und enthält Methode, Pfad, Umgebung und höchstens die ersten 500 Zeichen der Antwort von Sylius.

Welche Daten den Rechner verlassen

Daten Ziel
Tool-Aufrufe und Ergebnisse (Produkttexte, Preise, Codes) Sind Teil der Konversation mit Claude und gehen damit an Anthropic.
Requests an die Admin API Nur an die konfigurierte SYLIUS_BASE_URL, nirgendwo sonst hin.
Hochgeladene Bilddateien Die Bytes gehen an den Shop, nicht in die Konversation.
Zugangsdaten Nur an den Shop (Login), nie an Claude.

Der Server enthält keine Telemetrie und keine weiteren externen Aufrufe.

Schutzmechanismen im Server

Alle Tool-Parameter gelten als nicht vertrauenswürdig, weil ein Sprachmodell sie liefert.

Schutz Wirkung
Pfad-Allowlist Jeder Request wird vor dem Senden gegen eine feste Liste erlaubter Ressourcen geprüft. Erlaubt sind Produkte, Varianten, Kategorien, Attribute, Optionen, Zonen, Länder, Versandarten, Versandkategorien, Steuerklassen und Marketplace-Links; Channels und Eingabefeld-Definitionen nur lesend; dazu der Login-Endpunkt. Alles andere (Bestellungen, Kunden, Promotions, Admin-User) scheitert mit SyliusScopeError.
Pfad-Prüfung Pfade mit .., //, ?, # oder % werden abgelehnt. Codes dürfen nur Buchstaben, Ziffern, Unterstrich und Bindestrich enthalten.
Löschschutz DELETE ist nur für Marketplace-Links erlaubt, für alle anderen Ressourcen lehnt der Client es ab.
Method-Override Formularfelder, die mit _method beginnen, werden abgelehnt, damit ein POST nicht zu einem DELETE werden kann.
Bild-Upload Siehe unten.
Umgebungs-Gegenprüfung Stimmt SYLIUS_ENV_NAME nicht mit SYLIUS_ENVIRONMENT in der Datei überein, startet der Server nicht.
Aktivierungsschutz Ein Produkt ohne Variante wird nicht aktiviert.

Der Sylius-Admin-User selbst hat in der Community Edition immer Voll-Zugriff. Die Allowlist ist die einzige Grenze des Servers, nicht eine Berechtigung in Sylius. Wer die .env-Datei lesen kann, kann sich mit denselben Rechten direkt an der Admin API anmelden.

Bild-Upload

Ein Datei-Pfad kommt als Tool-Parameter vom Sprachmodell und könnte durch manipulierten Inhalt (zum Beispiel in einer eingelesenen Produktbeschreibung) untergeschoben werden. Ohne Einschränkung würde das erlauben, eine beliebige lokale Datei zu lesen und öffentlich im Shop zu veröffentlichen. Deshalb:

Empfehlungen

© 2026 Markus Michalski | Back to Homepage | Impressum | Datenschutz