This document outlines security policy and procedures for the CrowdStrike falconpy project.
- Supported Python versions
- Supported Operating Systems
- Supported CrowdStrike regions
- Supported FalconPy versions
- Reporting a potential security vulnerability
- Disclosure and Mitigation Process
FalconPy functionality is unit tested to run under the following versions of Python. Unit testing is performed with every pull request or commit to main.
| Version | Supported |
|---|---|
| 3.12.x |  |
| 3.11.x | |
| 3.10.x | |
| 3.9.x | |
| 3.8.x | |
| 3.7.x | |
| 3.6.x |  |
| <= 3.5 |  |
| <= 2.x.x | |
Unit testing for FalconPy is performed using Apple macOS, Microsoft Windows and Ubuntu Linux.
| Operating System | Most Recent Result |
|---|---|
 |
 |
 |
    |
 |
 |
FalconPy has been used and should have no issues running on the following additional operating systems.
FalconPy is unit tested for functionality across all CrowdStrike regions.
| Region | Most Recent Result |
|---|---|
| US-1 | |
| US-2 | |
| EU-1 | |
| US-GOV-1 | |
When discovered, we release security vulnerability patches for the most recent release at an accelerated cadence.
We have multiple avenues to receive security-related vulnerability reports.
Please report suspected security vulnerabilities by:
- Submitting a bug.
- Starting a new discussion.
- Submitting a pull request to potentially resolve the issue. (New contributors: please review the content located here.)
- Sending an email to falconpy@crowdstrike.com.
Upon receiving a security bug report, the issue will be assigned to one of the project maintainers. This person will coordinate the related fix and release process, involving the following steps:
- Communicate with you to confirm we have received the report and provide you with a status update.
- You should receive this message within 48 - 72 business hours.
- Confirmation of the issue and a determination of affected versions.
- An audit of the codebase to find any potentially similar problems.
- Preparation of patches for all releases still under maintenance.
- These patches will be submitted as a separate pull request and contain a version update.
- This pull request will be flagged as a security fix.
- Once merged, and after post-merge unit testing has been completed, the patch will be immediately published to both PyPI repositories.
If you have suggestions on how this process could be improved, please let us know by starting a new discussion.
