Description

Installs and configures SpamAssassin, a mail filter software to identify spam.

Requirements

Platform

This cookbook has been tested on the following platforms:

• CentOS
• Debian
• Ubuntu

Let me know if you use it successfully on any other platform.

Attributes

<table>
<tr>
<th>Attribute</th>
<th>Description</th>
<th>Default</th>
</tr>
<tr>
<td><code>node['onddo-spamassassin']['spamc']['path']</code></td>
<td>SpamAssassin client binary path</td>
<td><em>calculated</em></td>
</tr>
<tr>
<td><code>node['onddo-spamassassin']['spamd']['path']</code></td>
<td>SpamAssassin daemon binary path</td>
<td><em>calculated</em></td>
</tr>
<tr>
<td><code>node['onddo-spamassassin']['spamd']['user']</code></td>
<td>SpamAssassin user</td>
<td><code>"spamd"</code></td>
</tr>
<tr>
<td><code>node['onddo-spamassassin']['spamd']['group']</code></td>
<td>SpamAssassin group</td>
<td><code>"spamd"</code></td>
</tr>
<tr>
<td><code>node['onddo-spamassassin']['spamd']['lib_path']</code></td>
<td>SpamAssassin group</td>
<td><em>calculated</em></td>
</tr>
<tr>
<td><code>node['onddo-spamassassin']['spamd']['enabled']</code></td>
<td>SpamAssassin daemon enabler flag</td>
<td><code>true</code></td>
</tr>
<tr>
<td><code>node['onddo-spamassassin']['spamd']['options']</code></td>
<td>SpamAssassin daemon option arguments</td>
<td><code>[<br/>
  "--create-prefs",<br/>
  "--max-children 5",<br/>
  "--helper-home-dir"<br/>
]</code></td>
</tr>
<tr>
<td><code>node['onddo-spamassassin']['spamd']['pidfile']</code></td>
<td>SpamAssassin daemon pid file</td>
<td><code>"/var/run/spamd.pid"</code></td>
</tr>
<tr>
<td><code>node['onddo-spamassassin']['spamd']['nice']</code></td>
<td>SpamAssassin daemon nice scheduling priority</td>
<td><code>nil</code></td>
</tr>
<tr>
<td><code>node['onddo-spamassassin']['conf']['rewrite_headers']</code></td>
<td>An array of rewrite headers</td>
<td><code>[<br/>
  {<br/>
    "Subject" => "[SPAM]"<br/>
  }<br/>
]</code></td>
</tr>
<tr>
<td><code>node['onddo-spamassassin']['conf']['report_safe']</code></td>
<td>SpamAssassin report_safe enabler flag</td>
<td><code>true</code></td>
</tr>
<tr>
<td><code>node['onddo-spamassassin']['conf']['trusted_networks']</code></td>
<td>Network or hosts that are considered trusted</td>
<td><code>true</code></td>
</tr>
<tr>
<td><code>node['onddo-spamassassin']['conf']['lock_method']</code></td>
<td>File-locking method used to protect database files on-disk</td>
<td><code>"flock"</code></td>
</tr>
<tr>
<td><code>node['onddo-spamassassin']['conf']['required_score']</code></td>
<td>Score required before a mail is considered spam</td>
<td><code>5</code></td>
</tr>
<tr>
<td><code>node['onddo-spamassassin']['conf']['use_bayes']</code></td>
<td>Whether to use the naive-Bayesian-style classifier</td>
<td><code>true</code></td>
</tr>
<tr>
<td><code>node['onddo-spamassassin']['conf']['bayes_auto_learn']</code></td>
<td>Whether SpamAssassin should automatically feed high-scoring mail</td>
<td><code>true</code></td>
</tr>
<tr>
<td><code>node['onddo-spamassassin']['conf']['bayes_ignore_headers']</code></td>
<td>Headers ignored by the naive-Bayesian-style classifier</td>
<td><code>[]</code></td>
</tr>
<tr>
<td><code>node['onddo-spamassassin']['conf']['plugins']</code></td>
<td>A hash to configure SpamAssassin plugins (<a href="#plugin-example">see the example below</a>)</td>
<td><code>[]</code></td>
</tr>
</table>

plugin example

node.default['onddo-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'
  }
]

Recipes

onddo-spamassassin::default

Installs SpamAssassin client and Daemon.

Usage Examples

Including in a Cookbook Recipe

Running it from a recipe:

node.default['onddo-spamassassin']['conf']['required_score'] = 4 # is set to 5 by default
include_recipe 'onddo-spamassassin::default' # or include it in your run-list

Don't forget to include the onddo-spamassassin cookbook as a dependency in the metadata.

# metadata.rb
[...]

depends 'onddo-spamassassin'

Including in the Run List

Another alternative is to include the default recipe in your Run List.

{
  "name": "mail.onddo.com",
  [...]
  "run_list": [
    [...]
    "recipe[onddo-spamassassin]"
  ]
}

Testing

Requirements

• vagrant
• berkshelf >= 1.4.0
• test-kitchen >= 1.0.0.alpha
• kitchen-vagrant >= 0.10.0

Running the tests

$ kitchen test
$ kitchen verify
[...]

Contributing

1. Fork the repository on Github
2. Create a named feature branch (like add_component_x)
3. Write you change
4. Write tests for your change (if applicable)
5. Run the tests, ensuring they all pass
6. Submit a Pull Request using Github

License and Author

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

http://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.