PrestaOne-Hilfe

Reverse-Proxy konfigurieren

Nutzen Sie diese Anleitung, wenn das Modul ein ungültiges oder widersprüchliches HTTPS-Schema meldet. Ab Modulversion 1.7.18 wird ein normaler HTTPS-Proxy automatisch erkannt, ein Bestätigungskästchen ist nicht nötig.

Proxy-Einstellungen prüfen

  1. Öffnen Sie im PrestaShop-Backoffice Module → PrestaOne → Einstellungen.
  2. Öffnen Sie „Verbindungen & Zugriff“.
  3. Prüfen Sie die Verbindungswarnung und öffnen Sie „Erweitert“ → „Reverse-Proxy-Konfiguration“.

„Vertrauenswürdige Proxys“ ist optional und steuert nur die Erkennung der Client-IP. Für HTTPS müssen Sie keine Proxy-Adresse eintragen. Die Authentifizierung bleibt unverändert.

Wenn die Warnung bleibt

Aktualisieren Sie ältere Module, die proxy_trust_required anzeigen. Modulversion 1.7.18 verwendet weder das Bestätigungskästchen für den Proxy noch die serverseitige Bestätigungsmarkierung. Bleibt die Warnung bestehen, prüfen Sie das an PHP übergebene Schema.

forwarded_scheme_invalid bedeutet einen fehlerhaften Schema-Header.forwarded_scheme_conflict bedeutet, dass CF-Visitor und X-Forwarded-Proto beim ursprünglichen Schema nicht übereinstimmen. Fehlt das Schema bei einem HTTP-Backend, lässt sich die ursprüngliche HTTPS-Verbindung nicht automatisch erkennen.

Checkliste für die Serverkonfiguration

  • Die öffentliche Shop-URL nutzt HTTPS mit gültigem Zertifikat.
  • Der Proxy übergibt das ursprüngliche Schema in X-Forwarded-Proto oder CF-Visitor.
  • Sind beide vorhanden, stimmen ihre ursprünglichen Schemata überein. In einer X-Forwarded-Proto-Liste beschreibt der erste Wert die ursprüngliche Anfrage.
  • Eine HTTP-Verbindung von Cloudflare zum Origin darf das ursprüngliche HTTPS-Schema nicht mit ihrem eigenen HTTP-Schema überschreiben.
  • Beschränken Sie den direkten Zugriff auf den Origin nach Möglichkeit auf Ihren Proxy; die Schema-Erkennung beweist nicht, dass interne Verbindungen verschlüsselt sind.
  • Prüfen Sie Proxy-Quellen, bevor Sie Client-IP-Headern vertrauen. Unter Apache konfigurieren Sie dafür RemoteIPTrustedProxy für mod_remoteip.

Immer noch keine Verbindung?

Senden Sie dem Support die Shop-URL, die von PrestaOne angezeigte Diagnose-ID und den genauen Zeitpunkt des Fehlers. Senden Sie niemals Passwörter, Kopplungscodes oder Tokens.

PrestaOne-Support öffnen