Chef cookbook to install and configure SpamAssassin, a mail filter software to identify spam.
This cookbook has been tested on the following platforms:
- Amazon Linux
- CentOS
- Debian
- Fedora
- openSUSE
- Oracle Linux
- RedHat
- SUSE
- Ubuntu
Please, let us know if you use it successfully on any other platform.
- Chef
12or higher. - Ruby
2.2or higher.
| Attribute | Default | Description |
|---|---|---|
node['spamassassin']['spamc']['path'] |
calculated | SpamAssassin client binary path. |
node['spamassassin']['spamd']['path'] |
calculated | SpamAssassin daemon binary path. |
node['spamassassin']['spamd']['user'] |
'spamd' |
SpamAssassin user. |
node['spamassassin']['spamd']['group'] |
'spamd' |
SpamAssassin group. |
node['spamassassin']['spamd']['lib_path'] |
calculated | SpamAssassin library path. |
node['spamassassin']['spamd']['enabled'] |
true |
SpamAssassin daemon enabler flag. |
node['spamassassin']['spamd']['options'] |
calculated | SpamAssassin daemon option arguments. |
node['spamassassin']['spamd']['pidfile'] |
'/var/run/spamd.pid' |
SpamAssassin daemon pid file. |
node['spamassassin']['spamd']['nice'] |
nil |
SpamAssassin daemon nice scheduling priority. |
node['spamassassin']['conf']['rewrite_headers'] |
calculated | An array of rewrite headers. |
node['spamassassin']['conf']['report_safe'] |
true |
SpamAssassin report_safe enabler flag. |
node['spamassassin']['conf']['trusted_networks'] |
nil |
Network or hosts that are considered trusted. |
node['spamassassin']['conf']['lock_method'] |
'flock' |
File-locking method used to protect database files on-disk. |
node['spamassassin']['conf']['required_score'] |
5 |
Score required before a mail is considered spam. |
node['spamassassin']['conf']['use_bayes'] |
true |
Whether to use the naive-Bayesian-style classifier. |
node['spamassassin']['conf']['bayes_auto_learn'] |
true |
Whether SpamAssassin should automatically feed high-scoring mail. |
node['spamassassin']['conf']['bayes_ignore_headers'] |
[] |
Headers ignored by the naive-Bayesian-style classifier. |
node['spamassassin']['conf']['plugins'] |
[] |
A hash to configure SpamAssassin plugins (see the example below). |
node['spamassassin']['conf']['localrules'] |
[] |
An array to configure local rules at the end of local.conf. |
node.default['spamassassin']['conf']['plugins']['shortcircuit'] = [
{
'USER_IN_WHITELIST' => 'on',
'USER_IN_DEF_WHITELIST' => 'on',
'USER_IN_ALL_SPAM_TO' => 'on',
'SUBJECT_IN_WHITELIST' => 'on',
'USER_IN_BLACKLIST' => 'on',
'USER_IN_BLACKLIST_TO' => 'on',
'SUBJECT_IN_BLACKLIST' => 'on',
'ALL_TRUSTED' => 'on',
'BAYES_99' => 'spam',
'BAYES_00' => 'ham'
}
]Say you want to add the following rules to local.cf to blacklist some senders
blacklist_from [email protected]
blacklist_from [email protected]
node.default['spamassassin']['conf']['localrules'] = [
'blacklist_from [email protected]',
'blacklist_from [email protected]'
]Installs SpamAssassin client and Daemon.
Running it from a recipe:
# Required_score is set to 5 by default, change it:
node.default['spamassassin']['conf']['required_score'] = 4
include_recipe 'onddo-spamassassin::default' # or include it in your run-listDon't forget to include the onddo-spamassassin cookbook as a dependency in the metadata.
# metadata.rb
# [...]
depends 'onddo-spamassassin'Another alternative is to include the default recipe in your Run List.
{
"name": "mail.example.com",
"[...]": "[...]",
"run_list": [
"recipe[onddo-spamassassin]"
]
}See TESTING.md.
Please do not hesitate to open an issue with any questions or problems.
See CONTRIBUTING.md.
See TODO.md.
| Author: | Xabier de Zuazo ([email protected]) |
| Copyright: | Copyright (c) 2015, Xabier de Zuazo |
| Copyright: | Copyright (c) 2013-2015 Onddo Labs, SL. |
| License: | Apache License, Version 2.0 |
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
https://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.