New version of the administration area

Nothing to redo on your side

  • Your API tokens remain valid: neither their format nor their storage has changed.
  • API addresses answer exactly as before, under the same /api/v1 prefixes.
  • The date formats returned by the API are unchanged and checked by our tests.
  • Your login credentials are the same.

What's new

  • The administration now lives at https://doliproxy.fr/admin. The old address redirects there, your bookmarks keep working.
  • Signing in asks for a one-time code sent by email, on top of the password.
  • The documentation is up to date: read the documentation.

Reverse proxies

Create and manage a reverse proxy from the DoliProxy panel: public address, backend, modes and options.

Reverse proxies

A reverse proxy routes the traffic received on a public address to your application server (backend). You describe each proxy with a few fields in the panel; the platform automatically takes care of the rest (server configuration, SSL certificate, reload).

Creating a proxy

From the Proxies section, create a record by filling in:

Field Description
Name Human-readable identifier of the proxy.
Public address Domain name on which your service is exposed (for example app.example.com).
Target address (backend) URL of the server to which the traffic is forwarded (for example https://192.0.2.10:8443).
Mode proxy for a standard reverse proxy, hosted_pwa for a hosted PWA instance (see PWA hosting).
Status A proxy must be active to be exposed. When inactive, it responds with a "Proxy deactivated" page.

Once saved and active, your proxy is put into service automatically: the configuration is applied, the SSL certificate is obtained and the service is reloaded, with no action on your part.

SSL certificate

The HTTPS certificate of your proxy is managed for you. For a standard proxy, a dedicated certificate is obtained automatically. For PWA hosting, a certificate shared per module covers your subdomains. There is nothing for you to do.

Proxy options

Beyond the basic fields, each proxy offers several options:

  • Protections -- geo-restriction, rate and connection limiting, bot filtering, security headers, automatic IP blocking: see Security
  • Custom headers and URL rewriting -- add your own headers and rewrite rules
  • Maintenance mode -- displays an unavailability page, with the option to allow certain IPs
  • Health check -- monitors your backend and alerts you in case of an outage

Health check

Enter a check URL and DoliProxy queries your backend at the interval you choose, every five minutes at the shortest. After repeated failures, the proxy switches to the unhealthy state and you receive an email alert; a return to normal triggers a recovery notification. You choose whether or not to receive these alerts from your notification preferences.

The URL must answer with a success code (2xx) when you save it, otherwise it is refused. If your backend later starts refusing the check (4xx code: wrong URL, missing or protected route), the checks are spaced out up to one per hour and the alert asks you to fix the URL. Otherwise, a firewall counting the refusals would end up banning DoliProxy and cut your proxy off.

For a SmartMaker application, the check URL is https://<your Dolibarr>/custom/<module>/pwa/api.php/health. If it answers 403, update the smartauth module of your Dolibarr.

Suspended proxy

The platform suspends your proxies at the end of the trial or of the paid period, and when the monthly volume of your plan is reached. A suspended proxy responds with an unavailability page; its configuration is kept and it resumes on its own as soon as the situation is resolved. As long as it is suspended by the platform, you cannot reactivate it yourself. See Subscriptions and quotas.

Deleting a proxy

Deleting a proxy removes it from the service and stops exposing its public address. The history remains available: the deletion can be reversed on the platform side as long as the record has not been purged.