Corthex · PrestaShop / Webservice
Den Shop lesen. Die Schreibgrenze bewahren.
Der Ressourcenname sagt, was der Schlüssel erreichen kann. Die HTTP-Methode sagt, was er tun darf. Die Kundenidentität wird gesondert geprüft.
Nur lesbar bedeutet nicht öffentlich.
Ein PrestaShop-Webservice-Schlüssel kann sensible Datensätze lesen, auch wenn er sie nicht ändern darf. Das Corthex-Modul erstellt für ausgewählte Ressourcen eine eingeschränkte Verbindung mit Lesezugriff. Das ist eine sinnvolle Schreibgrenze, aber kein Grund, den Schlüssel zu veröffentlichen, jede Ressource in Besucherantworten offenzulegen oder allen Käufern dieselben Datensätze zugänglich zu machen. Prüfen Sie Ressourcenzugriff und Kundenautorisierung als getrennte Ebenen.
Das aktuelle native Modul gewährt GET und HEAD für seine ausdrückliche Ressourcenliste. GET liest eine Ressource; HEAD ist eine leseorientierte Anfrage ohne Antwortinhalt. Das Modul gewährt weder POST noch PUT, PATCH oder DELETE. Eine Liste mit orders oder order_slip bedeutet deshalb nicht, dass der Assistent Bestellungen erstellen, erstatten oder ändern kann. Ressourcennamen beschreiben vorhandene Datensätze, keine zugesagten Kundenaktionen.
Die PrestaShop-Zugriffsdokumentation empfiehlt nur erforderliche Rechte und die Prüfung der Shopzuordnung im Multistoremodus. Die folgende Matrix erfasst, was das Corthex-Modul aktuell deklariert. Sie ist eine Implementierungsreferenz und behauptet weder, jedes Feld werde im Chat geliefert, noch, alle Shopversionen und Fremdmodule seien getestet. Vergleichen Sie sie nach der Installation mit dem Schlüssel in Ihrem eigenen Verwaltungsbereich.
Die vollständige deklarierte Ressourcenliste
Die Berechtigung prüfen, nicht die Werbebezeichnung.
Jede unten genannte Ressource erhält im nativen Modul dieselben Lesemethoden. Die Gruppierung erklärt die Datenklasse und gewährt Besuchern keinen Zugriff. Scrollen Sie die Tabelle auf schmalen Bildschirmen horizontal, um alle Methoden zu vergleichen.
| Ressource | GET | HEAD | POST / PUT / PATCH / DELETE | Zweck / Grenze |
|---|---|---|---|---|
| Kunden- und Gesprächskontext | ||||
addresses | ✓ | ✓ | Nicht gewährt | Private Kunden- und Supportdaten; kein öffentliches Chatwissen. |
customer_messages | ✓ | ✓ | Nicht gewährt | Private Kunden- und Supportdaten; kein öffentliches Chatwissen. |
customer_threads | ✓ | ✓ | Nicht gewährt | Private Kunden- und Supportdaten; kein öffentliches Chatwissen. |
customers | ✓ | ✓ | Nicht gewährt | Private Kunden- und Supportdaten; kein öffentliches Chatwissen. |
groups | ✓ | ✓ | Nicht gewährt | Private Kunden- und Supportdaten; kein öffentliches Chatwissen. |
guests | ✓ | ✓ | Nicht gewährt | Private Kunden- und Supportdaten; kein öffentliches Chatwissen. |
messages | ✓ | ✓ | Nicht gewährt | Private Kunden- und Supportdaten; kein öffentliches Chatwissen. |
| Bestell- und Abwicklungskontext | ||||
order_carriers | ✓ | ✓ | Nicht gewährt | Vorhandene bestellbezogene Datensätze lesen; keine Erstattung oder Bestelländerung. |
order_cart_rules | ✓ | ✓ | Nicht gewährt | Vorhandene bestellbezogene Datensätze lesen; keine Erstattung oder Bestelländerung. |
order_details | ✓ | ✓ | Nicht gewährt | Vorhandene bestellbezogene Datensätze lesen; keine Erstattung oder Bestelländerung. |
order_histories | ✓ | ✓ | Nicht gewährt | Vorhandene bestellbezogene Datensätze lesen; keine Erstattung oder Bestelländerung. |
order_invoices | ✓ | ✓ | Nicht gewährt | Vorhandene bestellbezogene Datensätze lesen; keine Erstattung oder Bestelländerung. |
order_payments | ✓ | ✓ | Nicht gewährt | Vorhandene bestellbezogene Datensätze lesen; keine Erstattung oder Bestelländerung. |
order_slip | ✓ | ✓ | Nicht gewährt | Vorhandene bestellbezogene Datensätze lesen; keine Erstattung oder Bestelländerung. |
order_states | ✓ | ✓ | Nicht gewährt | Vorhandene bestellbezogene Datensätze lesen; keine Erstattung oder Bestelländerung. |
orders | ✓ | ✓ | Nicht gewährt | Vorhandene bestellbezogene Datensätze lesen; keine Erstattung oder Bestelländerung. |
| Katalog- und Warenkorbkontext | ||||
carts | ✓ | ✓ | Nicht gewährt | Katalog, Kombinationen und verfügbaren Warenkorbkontext lesen; keine Warenkorbänderungen über diesen Schlüssel. |
cart_rules | ✓ | ✓ | Nicht gewährt | Katalog, Kombinationen und verfügbaren Warenkorbkontext lesen; keine Warenkorbänderungen über diesen Schlüssel. |
categories | ✓ | ✓ | Nicht gewährt | Katalog, Kombinationen und verfügbaren Warenkorbkontext lesen; keine Warenkorbänderungen über diesen Schlüssel. |
combinations | ✓ | ✓ | Nicht gewährt | Katalog, Kombinationen und verfügbaren Warenkorbkontext lesen; keine Warenkorbänderungen über diesen Schlüssel. |
manufacturers | ✓ | ✓ | Nicht gewährt | Katalog, Kombinationen und verfügbaren Warenkorbkontext lesen; keine Warenkorbänderungen über diesen Schlüssel. |
product_feature_values | ✓ | ✓ | Nicht gewährt | Katalog, Kombinationen und verfügbaren Warenkorbkontext lesen; keine Warenkorbänderungen über diesen Schlüssel. |
product_features | ✓ | ✓ | Nicht gewährt | Katalog, Kombinationen und verfügbaren Warenkorbkontext lesen; keine Warenkorbänderungen über diesen Schlüssel. |
product_option_values | ✓ | ✓ | Nicht gewährt | Katalog, Kombinationen und verfügbaren Warenkorbkontext lesen; keine Warenkorbänderungen über diesen Schlüssel. |
product_options | ✓ | ✓ | Nicht gewährt | Katalog, Kombinationen und verfügbaren Warenkorbkontext lesen; keine Warenkorbänderungen über diesen Schlüssel. |
products | ✓ | ✓ | Nicht gewährt | Katalog, Kombinationen und verfügbaren Warenkorbkontext lesen; keine Warenkorbänderungen über diesen Schlüssel. |
stock_availables | ✓ | ✓ | Nicht gewährt | Katalog, Kombinationen und verfügbaren Warenkorbkontext lesen; keine Warenkorbänderungen über diesen Schlüssel. |
suppliers | ✓ | ✓ | Nicht gewährt | Katalog, Kombinationen und verfügbaren Warenkorbkontext lesen; keine Warenkorbänderungen über diesen Schlüssel. |
| Shopreferenzdaten | ||||
countries | ✓ | ✓ | Nicht gewährt | Zugehörige Referenzdaten des Shops einordnen. |
currencies | ✓ | ✓ | Nicht gewährt | Zugehörige Referenzdaten des Shops einordnen. |
languages | ✓ | ✓ | Nicht gewährt | Zugehörige Referenzdaten des Shops einordnen. |
stores | ✓ | ✓ | Nicht gewährt | Zugehörige Referenzdaten des Shops einordnen. |
taxes | ✓ | ✓ | Nicht gewährt | Zugehörige Referenzdaten des Shops einordnen. |
Koppeln, verbinden, prüfen
Die drei Einrichtungszuständigkeiten trennen.
Koppeln Sie zunächst Assistent und Shop über das Corthex-Modul. Damit wird festgelegt, welcher Assistent in diesem Shop verwendet wird. Nutzen Sie danach „Webservice mit Corthex verbinden“ im Modul. Die Aktion aktiviert den Webservice und erstellt den eingeschränkten Schlüssel mit Lesezugriff. Prüfen Sie abschließend die Verbindung in Corthex und testen Sie den Shop als angemeldeter Käufer. Ein funktionierendes Widget, ein gekoppelter Assistent und ein funktionierender Webservice sind zusammenhängende, aber unterschiedliche Beobachtungen.
Dokumentieren Sie Shop, Assistent, Modulversion und Schlüsselkennung, ohne den vollständigen geheimen Schlüssel in den Bericht zu kopieren. Prüfen Sie in Multistoreumgebungen die Shopzuordnung ausdrücklich. Der Modulstatus ist eine Beobachtung und das echte Testergebnis eine weitere. Eine gespeicherte Konfiguration allein belegt nicht, dass Hosting, Weiterleitung oder aktuelle Kundensitzung den vorgesehenen Lesezugriff erlauben.
Assistentenkopplung
Wählen Sie den vorgesehenen Arbeitsbereich und Assistenten. Bestätigen Sie, dass das Widget zu dieser Shopeinrichtung gehört.
Webservice-Verbindung
Nutzen Sie die Modulaktion, prüfen Sie den erstellten Schlüssel und vergleichen Sie Ressourcen und Lesemethoden mit der Matrix.
Käuferkontexttest
Prüfen Sie den Kontext Ihres Testkunden, die Ablehnung für Gäste und die Trennung fremder Bestellungen.
Was selbst ein erfolgreicher Lesezugriff nicht belegt.
Ein gelesener Produktdatensatz belegt keine Warenkorbänderung. Eine gelesene Bestellung belegt keine Erstattung. Kundenkontext in einer angemeldeten Sitzung belegt keine Isolation für jedes Konto. Testen Sie jedes vorgesehene Verhalten und jede relevante Ablehnung getrennt. Halten Sie Besucheranfrage, Schlüsselmethoden und unterstützte Anwendungswerkzeuge aufeinander abgestimmt.
Benötigt eine Anfrage einen von dieser Verbindung nicht unterstützten Schreibvorgang, bieten Sie einen klaren Weg zu Mitarbeitenden. Empfehlen Sie zur allgemeinen Fehlersuche nicht sämtliche Webservice-Berechtigungen. Eine Änderung der Methodenrechte verändert das Zugriffsmodell, statt die ursprüngliche Leseintegration zu prüfen. Benötigt Ihr Unternehmen einen anderen Ablauf, entwickeln und prüfen Sie ihn als separate Integration.
- Kein geheimer Schlüssel im Browser oder in öffentlichen Wissensquellen.
- Aus einer lesbaren Bestellressource werden keine Bestelländerungen abgeleitet.
- Keine Gast-E-Mail-Adresse wird als Kundenauthentifizierung behandelt.
- Keine Kompatibilitätszusage ohne Test der tatsächlichen Installation.