File: README.rst

package info (click to toggle)
radicale-dovecot-auth 0.4.1-2
  • links: PTS, VCS
  • area: main
  • in suites: bookworm, forky, sid, trixie
  • size: 116 kB
  • sloc: python: 141; makefile: 3
file content (79 lines) | stat: -rw-r--r-- 1,581 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
Radicale Dovecot Auth
#####################

Dovecot authentication plugin for Radicale.

Installation
============

From Source
-----------

.. code::

        pip3 install radicale-dovecot-auth

Debian
------

Packages are available here_

.. _here: https://debs.slavino.sk/pool/main/r/radicale-dovecot-auth/

Archlinux
---------

Packages are available in AUR for the `latest release`_ and current `master`_.

.. _latest release: https://aur.archlinux.org/packages/radicale-dovecot-auth/
.. _master: https://aur.archlinux.org/packages/radicale-dovecot-auth-git/



Configuration
=============

Ensure that user running radicale has read and write permissions to the socket created by auth-userdb.

.. code::

        [auth]
        type = radicale_dovecot_auth

        auth_socket = path_to_socket

        # or tcp based
        auth_host = localhost
        auth_port = 10000

You may need to add a new auth_ socket to dovecot:

.. _auth: https://wiki.dovecot.org/Services#auth

.. code::

        unix_listener auth-client {
                path = path_to_socket
                mode = 0660
                user = radicale
                group = postfix
        }

Or tcp based:

.. code::

        inet_listener auth-client {
                address = localhost
                port = 10000
        }


Authentication Backend
######################
DovecotAuth provides authentication against a Dovecot authentication
service using the PLAIN mechanism.

Only version 1.1 as described in the `Dovecot Wiki`_

.. _Dovecot Wiki: https://wiki2.dovecot.org/Design/AuthProtocol