CHANGELOG.rst

Ansible CrowdStrike Falcon Collection Release Notes

Topics

v4.5.0

Release Summary

Release Date: 2024-05-16
Release Notes:

Minor Changes

• fctl_child_cid_info - Added new module to get information about Flight Control child CIDs (#517)
• fctl_child_cids - new lookup filter plugin to fetch child cids (#516)

New Plugins

Lookup

• crowdstrike.falcon.fctl_child_cids - fetch Flight Control child CIDs

New Modules

• crowdstrike.falcon.fctl_child_cid_info - Retrieve details about Flight Control child CIDs

v4.4.0

Release Summary

Release Date: 2024-05-06
Release Notes:

Minor Changes

• host_ids - adds a new lookup plugin for getting host IDs (#503)
• host_info - adds new module for retrieving host details (#504)
• kernel_support_info - adds new module for kernel support information (#499)
• sensor_update_builds_info - adds new module for retrieving sensor build versions (#500)

New Plugins

Lookup

• crowdstrike.falcon.host_ids - fetch host IDs (AIDs)
• crowdstrike.falcon.maintenance_token - fetch maintenance token

New Modules

• crowdstrike.falcon.host_info - Get information about Falcon hosts
• crowdstrike.falcon.sensor_update_builds_info - Get a list of available sensor build versions

v4.3.2

Release Summary

Release Date: 2024-04-09
Release Notes:

Bugfixes

• falcon_install - allow permissions for sensor download task (#497)

v4.3.1

Release Summary

Release Date: 2024-04-08
Release Notes:

Bugfixes

• falcon_configure - updated logic to remove aid during configuration stage (#486)
• sensor_download - added the ability to set file permissions on downloaded files (#485)

v4.3.0

Release Summary

Release Date: 2024-03-27
Release Notes:

Minor Changes

• falcon_hosts - adds a new dynamic inventory for the Hosts service collection (#470)

Bugfixes

• falcon_hosts - added support for hostname preferences and fixed documentation (#474)
• falcon_hosts - added support for parameter templating (#475)
• host_hide - api action was limited to 100 hosts. Fix now allows for processing of more than 100 hosts. (#473)

New Plugins

Inventory

• crowdstrike.falcon.falcon_hosts - CrowdStrike Falcon Hosts inventory source

v4.2.2

Release Summary

Release Date: 2024-02-14
Release Notes:

Bugfixes

• Remove superfluous parameter required from process.get_bin_path API usage.
• falcon_install - fix falcon_target_os value for SLES (#449)

v4.2.1

Release Summary

Release Date: 2023-12-08
Release Notes:

v4.2.0

Release Summary

Release Date: 2023-10-19
Release Notes:

Minor Changes

• eventstream plugin - add user-agent string (#426)

v4.1.3

Release Summary

Release Date: 2023-09-22
Release Notes:

Bugfixes

• falcon_configure - fix main task call to auth task (#418)

v4.1.2

Release Summary

Release Date: 2023-09-19
Release Notes:

Bugfixes

• falconpy_utils - fix incorrect url for eu1 (#415)

v4.1.1

Release Summary

Release Date: 2023-09-17
Release Notes:

Bugfixes

• falcon_discover - fixed missing parameter for compose to work properly (#413)

v4.1.0

Release Summary

Release Date: 2023-09-16
Release Notes:

Minor Changes

• host_contain - adds new module to manage host network containment state (#411)

New Modules

• crowdstrike.falcon.host_contain - Network contain hosts in Falcon

v4.0.0

Release Summary

Release Date: 2023-09-15
Release Notes:

Minor Changes

• auth - adds auth module to manage authentication with the Falcon API (#384)
• cid_info - adds cid_info module to help retrieve CID with checksum (#395)
• falcon_discover - adds a new dynamic inventory for the Discover service collection (#400)
• falcon_install - replaces existing API functionality with new modules (#396)
• host_hide - adds host_hide module to hide/unhide hosts from the Falcon console (#399)
• sensor_download - adds sensor_download module to download sensor from the Falcon API (#396)
• sensor_download_info - adds sensor_download_info module to retrieve sensor installers to download (#396)
• sensor_policy_info - adds sensor_policy_info module to retrieve sensor policy information from the CrowdStrike Falcon API (#251)

Breaking Changes / Porting Guide

• falconpy - new collection requirements for authenticating with the CrowdStrike Falcon API now require the falconpy sdk. All existing roles within the collection have been ported over and should use the ./requirements.txt file to get started. (#384)

Bugfixes

• cid_info - return the first element of the array (#396)
• falcon_configure - add missing when clause for mac task (#399)

New Plugins

Inventory

• crowdstrike.falcon.falcon_discover - CrowdStrike Falcon Discover inventory source

New Modules

• crowdstrike.falcon.auth - Manage authentication
• crowdstrike.falcon.cid_info - Get CID with checksum
• crowdstrike.falcon.host_hide - Hide/Unhide hosts from the Falcon console
• crowdstrike.falcon.sensor_download - Download Falcon Sensor Installer
• crowdstrike.falcon.sensor_download_info - Get information about Falcon Sensor Installers
• crowdstrike.falcon.sensor_update_policy_info - Get information about Falcon Update Sensor Policies

v3.3.3

Release Summary

Release Date: 2023-09-14
Release Notes:

Bugfixes

• update ansible meta information for certifiable requirements (#405)

v3.3.2

Release Summary

Release Date: 2023-09-11
Release Notes:

Minor Changes

• falcon_uninstall - Adds hide/remove host functionality (#393)

Bugfixes

• falcon_configure - add become clause to remove_aid tasks (#392)

v3.3.1

Release Summary

Release Date: 2023-08-17
Release Notes:

Bugfixes

• eda - fix EDA partner requirements using tox (#381)

v3.3.0

Release Summary

Release Date: 2023-08-04
Release Notes:

Minor Changes

• evenstream-eda - Introducing new EvenStream EDA plugin (#322)

Bugfixes

• falcon_install - Fix Windows destination URL (#375)

v3.2.36

Release Summary

Release Date: 2023-07-28
Release Notes:

Minor Changes

• falcon_install - add the ability to install from an URL for windows (#363)
• falcon_install - removing kernel compat check due to prevelance of ebpf (#367)

Bugfixes

• falcon_install - use tmp path instead of hardcoding sensor name (#368)

v3.2.35

Release Summary

Release Date: 2023-06-30
Release Notes:

Bugfixes

• falcon_install - fix issue with expired gpg key (#361)

v3.2.34

Release Summary

Release Date: 2023-05-10
Release Notes:

Bugfixes

• falcon_install - fix bug with zypper downgrade (#344)

v3.2.33

Release Summary

Release Date: 2023-04-24
Release Notes:

Minor Changes

• falcon_install - gives the user the option to downgrade the falcon sensor to a previous version (#334)

v3.2.32

Release Summary

Release Date: 2023-03-30
Release Notes:

Bugfixes

• falcon_install - fix issue with sorting of returned versions when using falcon_sensor_version_decrement (#325)
• falcon_install - fix kernel compatibility query (#332)

v3.2.31

Release Summary

Release Date: 2023-03-15
Release Notes:

Minor Changes

• falcon_configure - adds the ability to manage grouping tags for Mac OS (#318)
• falcon_install - made the ability to toggle run_once options available to the user (#320)
• falcon_install, falcon_configure, falcon_uninstall - Enhances the roles to better support Mac OS, to include changed_when and failed_when conditions (https://github.com/CrowdStrike/ansible_collection_falcon/pull/318/files)

Bugfixes

• falcon_install - fixes a bug where falcon_os_arch was affecting the falcon_install module on Mac OS X (#318)

v3.2.30

Release Summary

Release Date: 2023-03-06
Release Notes:

Bugfixes

• falcon_install - fix win auth (#316)

v3.2.29

Release Summary

Release Date: 2023-03-01
Release Notes:

Minor Changes

• falcon_configure, falcon_install - Extract authentication logic to be more OS specific (#309)

v3.2.28

Release Summary

Release Date: 2023-02-16
Release Notes:

Minor Changes

• falcon_configure, falcon_install, falcon_uninstall - Updated to use ansible facts dictionary instead of the ansible* naming convention (#299)
• falcon_install - Fix delegate_to issue due to omit bug in Ansible 2.12 (#306)

v3.2.27

Release Summary

Release Date: 2023-01-12
Release Notes:

Minor Changes

• falcon_configure - Add backend support for bpf (#287)
• falcon_install - Fixed issue with delegation in Auth call (#286)
• falconctl, falconctl_info - Add backend option support for bpf (#287)

v3.2.26

Release Summary

Release Date: 2022-12-27
Release Notes:

Bugfixes

• falcon_install - Fix issue with non-linux systems being affected by falcon_os_arch variable (#284)

v3.2.25

Release Summary

Release Date: 2022-12-22
Release Notes:

Bugfixes

• falcon_install - Fixed support for s390x that was causing issues for the other archs (#281)

v3.2.24

Release Summary

Release Date: 2022-12-22
Release Notes:

Minor Changes

• falcon_install falcon_configure - Refactored API authentication for better useability (#273)

Bugfixes

• falcon_install - fix issue with sensor update policies and arch support (#276)

v3.2.23

Release Summary

Release Date: 2022-10-10
Release Notes:

Minor Changes

• Updates made to conform with the latest ansible-lint rules (#263)
• implement run_once playbook option to reduce API calls (#261)

v3.2.22

Release Summary

Release Date: 2022-09-16
Release Notes:

Bugfixes

• falcon_configure - fix issue with falcon_cloud variable not being set correctly (#257)

v3.2.21

Release Summary

Release Date: 2022-09-06
Release Notes

Minor Changes

• falcon_install - add the ability to install from a local file (#242).

Bugfixes

• falcon_configure - fix issue with aid removal for image prep failed (#254)

v3.2.20

Release Summary

Release Date: 2022-08-23
Release Notes

Bugfixes

• falcon_install - fix-incorrect-arm64-assumptions (#244)

v3.2.19

Release Summary

Release Date: 2022-08-09
Release Notes:

Minor Changes

• ansible_install - added optional credentials for package download
• falcon_install - Update target_os for RHEL family to support RHEL 9.
• falconctl - Fixed issue with APD and billing options being able to use empty string as proper argument.
• falconctl - extrapolated common param checks to function.

Bugfixes

• falconctl - updated usage of string options and added validation for options.