Postfix-policy utilizes ServerKit to ensure high performance and scalability for Postfix servers as a policy server.
If you are looking for a policy server that provides optimal performance and scalability for Postfix servers, then Postfix-policy is the perfect solution for you. Specifically designed for large email systems that use Postfix for MX, and MySQL for account management, this project is best-suited for basic policy needs.
Before starting, make sure to read the ServerKit documentation first, as most of the basic usage is just using ServerKit, which is nothing specific to this module. To begin, use the included ServerKit personality as a starting point, which is found in the source archive as a directory named "personality". Within this personality directory, you will find a "c11n" file, a "modules" subdirectory, and a "svsdir" subdirectory.
To use the Postfix-policy module, you need to modify the "c11n" file, which is a ServerKit configuration file. Ensure that you modify the database settings so that ServerKit can successfully communicate with your database system. Also, make sure to set the "action_query_format_string" configuration value, which is the SQL query that postfix-policy will use to retrieve an action to send back to Postfix in response to policy delegation requests.
Note that you will be responsible for creating a query that is compatible with your mail system database schema, and the query should return an empty set for invalid recipients and a valid action string when not returning an empty set. If you need more information on valid policy action responses, refer to the access(5) manual reference from Postfix, as you will be dealing with the *ACTIONS sections.
Apart from ServerKit, Postfix (recommended) is the only requirement for this module to work. The recent release of Postfix-policy adds a cleanup handler to support the graceful shutdown facilities introduced in the latest ServerKit release.
Before starting, make sure to read the ServerKit documentation first, as most of the basic usage is just using ServerKit, which is nothing specific to this module. To begin, use the included ServerKit personality as a starting point, which is found in the source archive as a directory named "personality". Within this personality directory, you will find a "c11n" file, a "modules" subdirectory, and a "svsdir" subdirectory.
To use the Postfix-policy module, you need to modify the "c11n" file, which is a ServerKit configuration file. Ensure that you modify the database settings so that ServerKit can successfully communicate with your database system. Also, make sure to set the "action_query_format_string" configuration value, which is the SQL query that postfix-policy will use to retrieve an action to send back to Postfix in response to policy delegation requests.
Note that you will be responsible for creating a query that is compatible with your mail system database schema, and the query should return an empty set for invalid recipients and a valid action string when not returning an empty set. If you need more information on valid policy action responses, refer to the access(5) manual reference from Postfix, as you will be dealing with the *ACTIONS sections.
Apart from ServerKit, Postfix (recommended) is the only requirement for this module to work. The recent release of Postfix-policy adds a cleanup handler to support the graceful shutdown facilities introduced in the latest ServerKit release.
What's New
Version 0.0.2: N/A