kokolores - an alternative saslauthd
version 1.01
kokolores is an alternative saslauthd written in perl.
It is based on prefork server based on Net::Server and configurable thru a configuration file.
It features a plugin architecture and could be easily extended with custom plugins.
Usage:
bin/kokolores [-h|--help] [-c|--config=<file>] [-f|--foreground] [-l|--loglevel=<level>]
Show usage text.
Specify an alternative configuration file path.
Default: /etc/kokolores/kokolores.conf
Dont fork to background. Stay in foreground.
A value from 0-4:
Configuration options could be given in the format:
key = "value"
One per line.
Global configuration options can just be listed in the global scope of the configuration file.
All plugins are required to succeed.
Change to "any" to return a successfull authentication when the first plugin returns success.
Plugins can be defined with a <Plugin> section:
<Plugin plugin-name> module = "ModuleName" option1 = "param" option2 = "param" # ... </Plugin>
kokolores comes with the following plugins:
Search an retrieve an user from a SQL database.
All databases supported by perl-DBI should be supported.
Check an password. Supports different hash methods to validate a password.
If you know some perl it should be easy for your to write a custom plugin for kokolores.
Plugins have to be under the kokolores plugin namespace:
Auth::Kokolores::Plugin::<name>
For an example plugin read the source of:
Auth::Kokolores::Plugin::Example
Markus Benning <ich@markusbenning.de>
This software is Copyright (c) 2016 by Markus Benning <ich@markusbenning.de>.
This is free software, licensed under:
The GNU General Public License, Version 2, June 1991
To install Auth::Kokolores, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Auth::Kokolores
CPAN shell
perl -MCPAN -e shell install Auth::Kokolores
For more information on module installation, please visit the detailed CPAN module installation guide.