From 7bd9829c3133e8b0f88f47932d4aa70016076c29 Mon Sep 17 00:00:00 2001 From: Guillaume Ayoub Date: Sun, 11 Sep 2011 11:52:38 +0200 Subject: [PATCH] Update the user documentation to add the Apache authentication configuration --- pages/user_documentation.rst | 17 +++++++++++++---- 1 file changed, 13 insertions(+), 4 deletions(-) diff --git a/pages/user_documentation.rst b/pages/user_documentation.rst index ef94baa2..1b157f2b 100644 --- a/pages/user_documentation.rst +++ b/pages/user_documentation.rst @@ -376,8 +376,9 @@ even Tomcat. Apache and mod_wsgi ~~~~~~~~~~~~~~~~~~~ -To use Radicale with Apache's ``mod_wsgi``, you first have to write your -``.wsgi`` file (in ``/var/www`` for example): +To use Radicale with Apache's ``mod_wsgi``, you first have to install the +Radicale module in your Python path and write your ``.wsgi`` file (in +``/var/www`` for example): .. code-block:: python @@ -386,7 +387,7 @@ To use Radicale with Apache's ``mod_wsgi``, you first have to write your application = radicale.Application() .. note:: - We assume that the Radicale module is installed in your Python path. + The ``[server]`` part of the configuration is ignored. Next you have to create the Apache virtual host (adapt the configuration to your environment): @@ -410,7 +411,15 @@ to your environment): .. note:: You should use the root of the (sub)domain (``WSGIScriptAlias /``), else - some CalDAV features will not work. + some CalDAV features may not work. + +.. important:: + If you want to use authentication with Apache, you *really* should use one + of the Apache authentication modules, instead of the ones from Radicale: + they're just better. If you're still convinced that access control is better + with Radicale, you have to add ``WSGIPassAuthorization On`` in your Apache + configuration files, as explained in `the mod_wsgi documentation + `_. Authentication and URLs