The following terms have specific definitions for usage within this documentation.
The following definitions are utilized for the terms listed above.
GitHub-powered workflow that performs specific repository operations.
Example: Package deployment, Unit testing
Not to be confused with the
action keyword used in the Uber Class, or keys potentially found in body and parameter payloads.
The base address used for API requests.
Examples: US1 or https://api.crowdstrike.com
FalconPy supports the following CrowdStrike Base URLs:
|Short name||Base URL|
You may specify the short name or the base URL (with or without
https://) when using the
Programmatic logic used to abstract body payload parameters into keywords for use within FalconPy library methods.
More detail about body payload abstraction can be found in the Payload Handling documentation.
A pre-release version of FalconPy available on the test package index.
In object-oriented programming, a class is an extensible program-code-template for creating objects, providing initial values for state (member variables) and implementations of behavior (member functions or methods).
(Definition provided by Wikipedia)
USGOV1users will still need to provide this value.
|Short name||Base URL||Auto discovery support?|
The percentage of code which is covered by automated unit testing. The FalconPy library maintains 100% code coverage for all released versions.
Falcon Query Language - The syntax used to provide filters and sort specifications to API requests.
More information about FQL can be found here.
Shorthand abbreviation for Identity Protection.
Shorthand abbreviation for Indicator of Attack.
Shorthand abbreviation for Indicator of Compromise.
Context: Instance of XYZ Service Class
A single object, constructed or instantiated using a specific class definition.
A question, bug or enhancement request for the FalconPy library.
User submitted issues that do not result in a bug finding or enhancement request are converted into discussions and posted to the q & a section of our discussion board.
We want to hear from you! Please let us know of any issues you encounter.
A function defined within a library class or module that executes a discrete sequence of steps. Typically this is in reference to a method that performs a specific API operation.
Examples: query_detects, query_devices_by_filter
Shorthand abbreviation for Machine Learning.
More detail regarding Operations can be found here.
Unique string used to identify an operation from among all available operations within all CrowdStrike API service collections.
More detail regarding Operation IDs can be found here.
Generic reference to the installation bundle for the FalconPy library.
Generic reference to PyPI, the Python Package Index.
Programmatic logic used to abstract query string payload parameters into keywords for use within FalconPy library methods.
More detail about parameter abstraction can be found in the Payload Handling documentation.
In computing and telecommunications, the payload is the part of transmitted data that is the actual intended message. Headers and metadata are sent only to enable payload delivery.
(Definition provided by Wikipedia)
More detail regarding payload types and how they are handled can be found here.
Python Enhancement Proposal #8 - A commonly referenced Python enhancement proposal that is used as the programmatic style guide for code implemented within this library.
More details about PEP 8 can be found here.
Python Enhancement Proposal #257 - A commonly referenced Python enhancement proposal that governs the semantics and conventions associated with Python docstrings used within this library.
More details about PEP 257 can be found here.
Shorthand abbreviation for Pull Request.
A formally distributed version of FalconPy, available on the production package index.
Shorthand abbreviation for Real Time Response.
More detail regarding basic Service Class usage can be found here.
Collection of API endpoints that comprise a specific CrowdStrike offering.
Examples: Detects, Hosts, Real Time Response
Swagger is a set of open-source tools built around the OpenAPI Specification that can help you design, build, document and consume REST APIs.
More detail regarding Swagger / OpenAPI Specification can be found here.
More detail regarding basic Uber Class usage can be found here.
A series of unit tests performed using the FalconPy library to confirm functionality. Typically performed after a push or merge to the repository, these can also be executed by developers locally. Unit testing is designed to test every available code path within the FalconPy library, not necessarily every element of CrowdStrike API functionality.
Shorthand abbreviation for Zero Trust Assessment.
Is there a term referenced within this repository that you feel needs a definition? Let us know by posting to our discussion board!