You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
[main] INFO running on Python 3.9.17
Run started:2023-08-09 05:00:42.323720
Test results:
No issues identified.
Code scanned:
Total lines of code: 50777
Total lines skipped (#nosec): 0
Run metrics:
Total issues (by severity):
Undefined: 0
Low: 0
Medium: 0
High: 0
Total issues (by confidence):
Undefined: 0
Low: 0
Medium: 0
High: 0
Files skipped (0):
Added features and functionality
Added: Developer Extensibility features - Enhanced existing programmatic architecture with new objects and submodules to address technical debt and provide developers with the necessary structures to easily extend core library functionality.
APIHarness - Derivative and an interface class commonly referred to as the Uber Class, APIHarness has been refactored to inherit common functionality provided by the FalconInterface class, remove technical debt, add typing, and expand available operations and extensibility features.
api_complete.py
APIRequest - Simple interface class comprised of multiple data classes that is leveraged for managing the components of a request sent to the CrowdStrike API. This is a new object.
_api_request/__init__.py
_api_request/_request.py
_api_request/_request_behavior.py
_api_request/_request_connection.py
_api_request/_request_meta.py
_api_request/_request_payloads.py
_api_request/_request_validator.py
Constant submodule - Stores global constants used throughout the library. This is a new module implemented to store new and pre-existing constants.
_constant/__init__.py
Enum submodule - Stores enumerators available within the library. This is a new module implemented to store pre-existing enumerators.
_enum/__init__.py
_enum/_base_url.py
_enum/_container_base_url.py
_enum/_token_fail_reason.py
Error submodule - Provides python native errors and warnings. This is a new module.
_error/__init__.py
_error/_exceptions.py
_error/_warnings.py
FalconInterface - Interface class that handles authentication and state management, also referred to as the authentication object or the auth_object. Refactored to address technical debt and add new functionality.
_auth_object/__init__.py
_auth_object/_base_falcon_auth.py
_auth_object/_bearer_token.py
_auth_object/_falcon_interface.py
_auth_object/_interface_config.py
_auth_object/_uber_interface.py
Log submodule - Provides debug logging functionality. This is a new module.
_log/__init__.py
_log/_facility.py
Result - Complex interface class that is leveraged to parse and return results received from the CrowdStrike API. This class has been refactored to address technical debt and provide new developer functionality and extensibility. Default behavior for requests received from the CrowdStrike API remains unchanged (results are returned as a Python dictionary). Expanded functionality provides developers the ability to handle received responses as python structures, allowing for easy iteration and processing without having to handle a dictionary.
_result/__init__.py
_result/_base_resource.py
_result/_base_dictionary.py
_result/_errors.py
_result/_expanded_result.py
_result/_headers.py
_result/_meta.py
_result/_resources.py
_result/_response_component.py
_result/_result.py
ServiceClass - Interface class leveraged by Service Classes to provide common functionality. This class has also been refactored to expand on functionality provided by the FalconInterface class, remove technical debt, add typing and expand extensibility features.
_service_class/_init__.py
_service_class/_base_service_class.py
_service_class/_service_class.py
Util submodule - Functions and utilities library containing both private and public methods. This is a new module implemented to store new and pre-existing functions.
_util/__init__.py
_util/_auth.py
_util/_functions.py
_util/_uber.py
Added: Debug logging - Native debug logging can now be activated per class upon construction. Logs are sanitized by default.
Local unit testing has been expanded to take advantage of this functionality. To activate, set the environment variable FALCONPY_UNIT_TEST_DEBUG to DEBUG.
_log/__init__.py
_log/_facility.py
Added: Environment Authentication - New authentication mechanism that retrieves CrowdStrike API credentials that are pre-defined as variables within the runtime environment. These environment variables must be named FALCON_CLIENT_ID and FALCON_CLIENT_SECRET and both must be present in order for this mechanism to be used. Environment Authentication is the last mechanism attempted, meaning all other authentication mechanisms will take precedence.
Added: Pythonic response handling - Allows for the handling of responses received from the CrowdStrike API as pythonic structures as opposed to dictionaries.
This update is immediately available within the crowdstrike-falconpy-dev package.
You can check out this new version by installing the package via the Python Package Index.
python3 -m pip install crowdstrike-falconpy-dev
or
pip3 install crowdstrike-falconpy-dev
Developers wanting to make use of the development package will need to update their imports to reference falconpydev.
Upgrading
Existing development package users can upgrade to this new release by installing the update via the Python Package Index.
reacted with thumbs up emoji reacted with thumbs down emoji reacted with laugh emoji reacted with hooray emoji reacted with confused emoji reacted with heart emoji reacted with rocket emoji reacted with eyes emoji
-
FalconPy v1.3.0
Planned release date
This update will release to the stable package in the production index on 08.14.2023.
Unit test coverage
Bandit analysis
[main] INFO running on Python 3.9.17 Run started:2023-08-09 05:00:42.323720 Test results: No issues identified. Code scanned: Total lines of code: 50777 Total lines skipped (#nosec): 0 Run metrics: Total issues (by severity): Undefined: 0 Low: 0 Medium: 0 High: 0 Total issues (by confidence): Undefined: 0 Low: 0 Medium: 0 High: 0 Files skipped (0):
Added features and functionality
api_complete.py
_api_request/__init__.py
_api_request/_request.py
_api_request/_request_behavior.py
_api_request/_request_connection.py
_api_request/_request_meta.py
_api_request/_request_payloads.py
_api_request/_request_validator.py
_constant/__init__.py
_enum/__init__.py
_enum/_base_url.py
_enum/_container_base_url.py
_enum/_token_fail_reason.py
_error/__init__.py
_error/_exceptions.py
_error/_warnings.py
auth_object
. Refactored to address technical debt and add new functionality._auth_object/__init__.py
_auth_object/_base_falcon_auth.py
_auth_object/_bearer_token.py
_auth_object/_falcon_interface.py
_auth_object/_interface_config.py
_auth_object/_uber_interface.py
_log/__init__.py
_log/_facility.py
_result/__init__.py
_result/_base_resource.py
_result/_base_dictionary.py
_result/_errors.py
_result/_expanded_result.py
_result/_headers.py
_result/_meta.py
_result/_resources.py
_result/_response_component.py
_result/_result.py
_service_class/_init__.py
_service_class/_base_service_class.py
_service_class/_service_class.py
_util/__init__.py
_util/_auth.py
_util/_functions.py
_util/_uber.py
FALCONPY_UNIT_TEST_DEBUG
toDEBUG
._log/__init__.py
_log/_facility.py
FALCON_CLIENT_ID
andFALCON_CLIENT_SECRET
and both must be present in order for this mechanism to be used. Environment Authentication is the last mechanism attempted, meaning all other authentication mechanisms will take precedence._auth_object/_falcon_interface.py
_result/__init__.py
_result/_base_resource.py
_result/_base_dictionary.py
_result/_errors.py
_result/_expanded_result.py
_result/_headers.py
_result/_meta.py
_result/_resources.py
_result/_response_component.py
_result/_result.py
_error/__init__.py
_error/_exceptions.py
_error/_warnings.py
Issues resolved
_result/_result.py
_util/_functions.py
api_complete.py
_auth_object/_falcon_interface.py
_auth_object/_uber_interface.py
creds
andproxy
keywords are not automatically converted to dictionaries. Closes [ ENH ] Detect inbound strings for the creds and proxy keywords and convert them to dictionaries #909._auth_object/_falcon_interface.py
samples/spotlight/spotlight_grab_cves_for_cid.py
PostEntitiesAlertsV1
operation. Closes [ BUG ] PostEntitiesAlertsV1 is not moving IDs to the correct payload #1016._constant/__init__.py
Other
samples/spotlight/spotlight_grab_cves_for_cid.py
Bleeding Edge Installation
You can check out this new release by installing the package via the Python Package Index.
or
Upgrading
You can upgrade to this new release by installing the update via the Python Package Index.
or
Development Package Installation
This update is immediately available within the
crowdstrike-falconpy-dev
package.You can check out this new version by installing the package via the Python Package Index.
or
Upgrading
Existing development package users can upgrade to this new release by installing the update via the Python Package Index.
or
Beta Was this translation helpful? Give feedback.
All reactions