20.23. paivana-httpd(1)

20.23.1. Name

paivana-httpd - reverse-proxy paywall

20.23.2. Synopsis

paivana-httpd [-f**_|_–respect-forwarded-headers**] [-h**_|_–help**] [-g**_|_–global-payment**] [-n**_|_–no-payment**] [-u BYTES*_|_*–max-upload=**BYTES] [-v**_|_–version**]

20.23.3. Description

paivana-httpd is a reverse proxy that requires the client to make a payment using GNU Taler before forwarding the request. The reverse proxy uses a GNU Taler merchant backend to process payments and also learns which websites require payment and how much the prices are. Thus, the main configuration is done within the Taler merchant backend.

paivana-httpd will simply open an HTTP socket, listen for incoming requests, and if they are paid (or do not require payment) forward them to the respective webserver configured.

Its options are as follows:

-f | –respect-forwarded-headers

If set, derive the client address from the leftmost entry of the “X-Forwarded-For” request header (falling back to the socket address only when the header is absent). Only enable this when paivana-httpd is itself behind a trusted reverse proxy that sanitizes that header - otherwise clients can spoof their address.

-h | –help

Print short help on options.

-g | -global-payment

Disable per-page payment, a single payment is always valid for the entire site.

-n | -no-payment

Disable payment, only act as a reverse proxy that does nothing. Useful to temporarily disable the paywall or to test the reverse proxy itself.

-u BYTES | –max-upload=BYTES

Set the maximum upload size allowed by the reverse proxy. Only applies to the body size (the HTTP header has a separate limit).

-v | –version

Print version number.

20.23.4. See Also

taler-merchant-httpd(1), paivana.conf(5)

20.23.5. Bugs

Report bugs by using https://bugs.taler.net or by sending electronic mail to <taler@gnu.org>.