mirrors/maddy
1
0
Fork 0
mirror of https://github.com/foxcpp/maddy.git synced 2025-04-04 13:37:41 +03:00
Code Issues Projects Releases Packages Wiki Activity
maddy/docs/reference/auth/plain_separate.md
Pēteris Caune 5d6d1a3a53
Improve Markdown formatting 
* use <h3> and <hr> elements to separate configuration directives
* use <code> elements to mark constants, fs paths,
  module names etc.
* fix unneeded "\_" escaping
* fix list formatting
2023-06-29 16:12:11 +03:00

1.1 KiB
Raw Blame History

Separate username and password lookup

auth.plain_separate module implements authentication using username:password pairs but can use zero or more "table modules" (maddy-tables(5)) and one or more authentication providers to verify credentials.

auth.plain_separate {
	user ...
	user ...
	...
	pass ...
	pass ...
	...
}

How it works:

  • Initial username input is normalized using PRECIS UsernameCaseMapped profile.
  • Each table specified with the 'user' directive looked up using normalized username. If match is not found in any table, authentication fails.
  • Each authentication provider specified with the 'pass' directive is tried. If authentication with all providers fails - an error is returned.

Configuration directives

user table-module

Configuration block for any module from maddy-tables(5) can be used here.

Example:

user file /etc/maddy/allowed_users

pass auth-provider

Configuration block for any auth. provider module can be used here, even 'plain_split' itself.

The used auth. provider must provide username:password pair-based authentication.