From 8288412d3daad50e4358e4ae06b3ae1896d0a856 Mon Sep 17 00:00:00 2001 From: Jean Prunneaux Date: Mon, 12 Feb 2018 23:58:52 +0100 Subject: [PATCH] Add authentication log information in documentation --- doc/configuration.rst | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/doc/configuration.rst b/doc/configuration.rst index 628261179..f6b481589 100644 --- a/doc/configuration.rst +++ b/doc/configuration.rst @@ -254,6 +254,25 @@ This parameter is optional but you must ensure it is set to ``False`` The default configuration file provided by the ``modoboa-admin.py`` command is properly configured. +********************** +Logging authentication +********************** + +To trace login attempts to the web interface, Modoboa uses python +`SysLogHandler `_ +and so you can see in you syslog authentication log file +(`/var/log/auth.log` in most cases). + +Depending to your configuration, you may have to edit the :file:`settings.py` file +and add `'address': '/dev/log'` to the logging section:: + + 'syslog-auth': { + 'class': 'logging.handlers.SysLogHandler', + 'facility': SysLogHandler.LOG_AUTH, + 'address': '/dev/log', + 'formatter': 'syslog' + }, + *********************** External authentication ***********************