CipUX CAT-web for Debian
========================

Access to XML-RPC interface
---------------------------

Debian (unlike upstream) by default connect to XML-RPC service through
plain http to localhost on port 8001.

If XML-RPC service is located on a remote host, the configuration option
catweb_rpc_server in `/etc/cipux-cat-web/cipux-cat-web.conf` should be
changed accordingly. Always use secure connection for remote access, and
then most likely use port 8000.

Read the documentation of cipux-rpcd for how to enable secure connection
for remote access to the XML-RPC service.


Allow only secure web access!
-----------------------------

The provided Apache 2 and Lighttpd configurations both limits access to
only secure connections. Disabling this is a major security risk!

If secure connections does not work out-of-the-box with the chosen
webserver, then read its documentation for how to enable SSL and/or
acquire a certificate (or create a so-called "self-signed" certificate).


Use with older Lighttpd
-----------------------

Default Lighttpd setup needs lighttpd 1.4.19 or newer. Older versions
does not support "scheme" condition used in the config snippet
`/etc/cipux-cat-web/lighttpd.conf`.

To use with older versions of Lighttpd, that config snippet need to
be adjusted to ensure secure connection through some other means.

 -- Jonas Smedegaard <dr@jones.dk>  Mon, 15 Sep 2008 03:25:10 +0200
