1. Description
2. Setup - The basics of getting started with Appcanary
   • Setup requirements
   • Beginning with Appcanary
3. Usage
4. Reference
5. Limitations
6. Development

Appcanary is a security service that monitors your infrastructure for security vulnerabilities. This module will manage the agent on your hosts.

You'll need to provide the module with your API key and a list of paths to monitor.

The Appcanary agent package is hosted on packagecloud.io, so be sure to grab computology/packagecloud from the Forge. You can just add the following to your Puppetfile:

mod 'computology/packagecloud'

You'll need your API key from https://appcanary.com/settings. With that in hand this will get you started:

class { '::appcanary':
  api_key: yourapikeyhere
}

To have Appcanary monitor the gems in your Ruby application for vulnerabilities you need to provide a path to your Gemfile.lock:

class { '::appcanary':
  api_key: yourapikeyhere
  paths:
    - /path/to/your/Gemfile.lock
    - /a/different/Gemfile.lock
}

• appcanary: Main class, includes all other classes.

• appcanary::prereq: Installs the packagecloud.io repository where Appcanary resides
• appcanary::install: Installs Appcanary
• appcanary::config: Configures Appcanary
• appcanary::service: Ensures Appcanary runs

The following parameters are available in the ::appcanary class:

####api_key Specifies your API key. Get yours from https://appcanary.com/settings

####paths Specifies the paths to your Gemfile.locks

Only tested on Ubuntu Trusty so far. Should work on any platform supported by the packagecloud.io module and by Appcanary itself.

Contributions are welcome anytime. Open issues or send pull requests.