PrestaOne Help

Reverse proxy configuration

Use this guide if the module reports an invalid or conflicting HTTPS scheme. With module 1.7.18, normal HTTPS proxy detection is automatic and requires no confirmation checkbox.

Check your proxy settings

  1. Open PrestaShop Back Office → Modules → PrestaOne → Configure.
  2. Open Connections & Access.
  3. Check the connection warning and open Advanced → Reverse proxy configuration.

Trusted proxies is optional and controls client IP detection only. You do not need to add a proxy address to enable HTTPS. Authentication remains unchanged.

If the warning remains

Update older modules that show proxy_trust_required. Module 1.7.18 no longer uses the proxy confirmation checkbox or server attestation marker. If the warning remains, check the scheme passed to PHP.

forwarded_scheme_invalid means a malformed scheme header.forwarded_scheme_conflict means CF-Visitor and X-Forwarded-Proto disagree about the original scheme. A missing scheme on an HTTP backend cannot identify the original HTTPS connection automatically.

Server configuration checklist

  • The public store URL uses HTTPS with a valid certificate.
  • The proxy preserves the original scheme in X-Forwarded-Proto or CF-Visitor.
  • If both are present, their original schemes agree. In an X-Forwarded-Proto list, the first value describes the original request.
  • A Cloudflare-to-origin HTTP hop must not overwrite the original HTTPS scheme with its own HTTP scheme.
  • Restrict direct origin access to your proxy where possible; scheme detection does not prove that internal hops are encrypted.
  • Validate proxy sources before trusting client IP headers. On Apache, configure RemoteIPTrustedProxy for mod_remoteip.

Still cannot connect?

Send support the store URL, the diagnostic ID shown by PrestaOne and the exact error time. Never send passwords, pairing codes or tokens.

Open PrestaOne support