Diese Dokumentation bezieht sich immer auf die aktuellste veröffentlichte Version.
| 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.
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.
| 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.
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.
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:
SYLIUS_IMAGE_UPLOAD_BASE_DIR ist der Datei-Upload komplett abgeschaltet..jpg, .jpeg, .png, .gif, .webp bis 10.000.000 Bytes..env-Datei versehentlich weitergegeben wurde.