Adoptable Cookbooks List

Looking for a cookbook to adopt? You can now see a list of cookbooks available for adoption!
List of Adoptable Cookbooks

Supermarket Belongs to the Community

Supermarket belongs to the community. While Chef has the responsibility to keep it running and be stewards of its functionality, what it does and how it works is driven by the community. The chef/supermarket repository will continue to be where development of the Supermarket application takes place. Come be part of shaping the direction of Supermarket by opening issues and pull requests or by joining us on the Chef Mailing List.

Select Badges

Select Supported Platforms

Select Status

RSS

falcon (4) Versions 0.1.1

Installs/Configures Falcon sensor

Policyfile
Berkshelf
Knife
cookbook 'falcon', '= 0.1.1', :supermarket
cookbook 'falcon', '= 0.1.1'
knife supermarket install falcon
knife supermarket download falcon
README
Dependencies
Changelog
Quality 33%

Falcon Cookbook

Cookbook Version

This cookbook provides resources for installing and configuring the CrowdStrike Falcon sensor.

Maintainers

This cookbook maintained by the CrowdStrike Cloud Integration Architects.

cloud-integrations@crowdstrike.com

Requirements

API clients are granted one or more API scopes. Scopes allow access to specific CrowdStrike APIs and describe the actions that an API client can perform.

Ensure the following API scopes are enabled (if applicable) for this role:

  • When install_method is set to api (default)
    • Sensor Download [read]
    • Sensor update policies [read]

Platform Support

*Supported on:

  • Alma/Rocky/CentOS Linux
  • Amazon Linux 1|2
  • Debian/Ubuntu
  • Oracle
  • Red Hat Enterprise Linux
  • Red Hat CoreOS
  • SUSE Linux Enterprise (SLES)

*Refer to the Falcon documentation for exact versions supported

Resources

Usage

  • Add depends 'falcon' to your cookbook's metadata.rb
  • Use the resources shipped in the cookbook in a recipe, the same way you'd use core Chef resources (file, template, directory, package, etc).
falcon_install 'falcon' do
  client_id 'LKJSDLFKJSLKDJFKLJ'
  client_secret 'SDLKFJLKSJDFLKJSDFLK'
  action :install
end

Test Cookbooks as Examples

The cookbooks ran under test-kitchen make excellent usage examples.

The test recipes are found at:

test/cookbooks/test/

Getting Started

Here's an example of installing/managing the latest Falcon sensor:

falcon_install 'falcon' do
  client_id 'LKJSDLFKJSLKDJFKLJ'
  client_secret 'SDLKFJLKSJDFLKJSDFLK'
  action :install
end

falcon_config 'falcon' do
  cid 'JKLJSDLKFJLKSJDFLKJSDLKFJ-28'
  notifies :restart, 'falcon_service[falcon]', :delayed
  action :set
end

falcon_service 'falcon' do
  action [:start, :enable]
end

You might not want to install the latest, and instead be interested in N-1 deployment. The falcon_install resource might look like:

falcon_install 'falcon' do
  client_id 'LKJSDLFKJSLKDJFKLJ'
  client_secret 'SDLKFJLKSJDFLKJSDFLK'
  version_decrement: 1 # This number corresponds to N-
  action :install
end

... # falcon_config

... # falcon_service

You can pass in certain options to configure the Falcon sensor. Here's an example of passing in some tags:

... # falcon_install

falcon_config 'falcon' do
  cid 'JKLJSDLKFJLKSJDFLKJSDLKFJ-28'
  tags %w(tag1 tag2)
  notifies :restart, 'falcon_service[falcon]', :delayed
  action :set
end

... # falcon_service

See full documentation for each resource and action for more information.

Authors

Adversary Lineup

Name Handle
Carlos Matos @carlosmmatos
Frank Falor @ffalor

Support

Chef Falcon is an open source project, not a formal CrowdStrike product, to assist developers implement CrowdStrike's Falcon sensor deployment within their organizations. As such it carries no formal support, express or implied.

Is something going wrong?
GitHub Issues are used to report bugs.

Submit a ticket here:
https://github.com/CrowdStrike/chef-falcon/issues/new/choose

Dependent cookbooks

This cookbook has no specified dependencies.

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

chef-falcon CHANGELOG

This file is used to list changes made in each version of the chef-falcon cookbook.

0.1.0

Initial release.

  • Linux support with API installation method

0.1.1

Full Changelog: https://github.com/CrowdStrike/chef-falcon/compare/0.1.0...0.1.1

Collaborator Number Metric
            

0.1.1 failed this metric

Failure: Cookbook has 1 collaborators. A cookbook must have at least 2 collaborators to pass this metric.

Contributing File Metric
            

0.1.1 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file

Cookstyle Metric
            

0.1.1 passed this metric

No Binaries Metric
            

0.1.1 passed this metric

Testing File Metric
            

0.1.1 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file

Version Tag Metric
            

0.1.1 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number