1
0
Fork 0
mirror of https://github.com/Kozea/Radicale.git synced 2025-07-05 17:08:29 +00:00

Merge pull request #9 from zcode/website

Website documentation for acl/IMAP
This commit is contained in:
Guillaume Ayoub 2012-07-16 09:10:52 -07:00
commit c052015d16

View file

@ -2,9 +2,9 @@
User Documentation User Documentation
==================== ====================
:Author: Guillaume Ayoub :Author: Guillaume Ayoub, Daniel Aleksandersen
:Date: 2010-02-11 :Date: 2012-07-05
:Abstract: This document is a short description for installing and using the :Abstract: This document is a short description for installing and using the
Radicale calendar and contact Server. Radicale calendar and contact Server.
@ -333,7 +333,7 @@ configuration file, with the main parameters:
[acl] [acl]
# Access method # Access method
# Value: None | htpasswd | LDAP | PAM | courier # Value: None | courier | IMAP | htpasswd | LDAP | PAM
type = None type = None
# Usernames used for public collections, separated by a comma # Usernames used for public collections, separated by a comma
@ -341,6 +341,10 @@ configuration file, with the main parameters:
# Usernames used for private collections, separated by a comma # Usernames used for private collections, separated by a comma
private_users = private private_users = private
# STARTTLS capable or local IMAP server domain name
imap_auth_host_name = localhost
imap_auth_host_port = 143
# Htpasswd filename # Htpasswd filename
htpasswd_filename = /etc/radicale/users htpasswd_filename = /etc/radicale/users
# Htpasswd encryption method # Htpasswd encryption method
@ -628,6 +632,8 @@ TLS Support
Python 2.6 suffered `a bug <http://bugs.python.org/issue5103>`_ causing huge Python 2.6 suffered `a bug <http://bugs.python.org/issue5103>`_ causing huge
timeout problems with TLS. The bug is fixed since Python 2.6.6. timeout problems with TLS. The bug is fixed since Python 2.6.6.
IAMP authentication over TLS requies Python 3.2.
Python 2.7 and Python 3.x do not suffer this bug. Python 2.7 and Python 3.x do not suffer this bug.
Crypt Support Crypt Support
@ -637,6 +643,15 @@ With the htpasswd access, many encryption methods are available, and crypt is th
default one in Radicale. Unfortunately, the ``crypt`` module is unavailable on default one in Radicale. Unfortunately, the ``crypt`` module is unavailable on
Windows, you have to pick another method on this OS. Windows, you have to pick another method on this OS.
IMAP Authentication
-------------------
The IMAP authentication module relies on the imaplib module, available with 2.x
versions of Python. However, TLS is only available in Python 3.2. Older versions
of Python or a non-modern server who does not support STARTTLS can only
authenticate against ``localhost`` as passwords are transmitted in PLAIN. Legacy
SSL mode on port 993 is not supported.
LDAP Authentication LDAP Authentication
------------------- -------------------