crowdstrike-falconpy-dev 1.4.1__tar.gz → 1.4.3__tar.gz

{crowdstrike-falconpy-dev-1.4.1 → crowdstrike-falconpy-dev-1.4.3}/AUTHORS.md

@@ -28,7 +28,6 @@ These coders deserve accolades and laurels as well as cool titles and cartoons.
 
 | Name | Role |
 | :--- | :--- |
-| Šimon L., `@isimluk` | [Sanity Checker](https://xkcd.com/1926/) |
 | Josh Lang, `@jlangdev` | [Lint Purveyor](https://xkcd.com/1833/) |
 | Christopher Hammond, `@ChristopherHammond13` | [Technical Debt Collector](https://xkcd.com/2138/) |
 | Gabe Alford, `@redhatrises` | [Git Whisperer](https://xkcd.com/1597/) |
@@ -37,6 +36,9 @@ These coders deserve accolades and laurels as well as cool titles and cartoons.
 | Shane Shellenbarger, `@soggysec` | [Calamity Validator](https://xkcd.com/1700/) |
 | Steve Klassen, `@mrxinu` | [Dilemma Responder](https://xkcd.com/85/) |
 
+#### Honorable mentions
++ Šimon L., `@isimluk` ([Sanity Checker](https://xkcd.com/1926/))
+
 ## Contributors
 The following members of the community have made requests, suggestions, code contributions or provided feedback and reported bugs.
 This has been a critical element in the development of the FalconPy project.
@@ -90,6 +92,8 @@ This has been a critical element in the development of the FalconPy project.
 + Phil Massyn, `@massyn`
 + Russell Snyder, `@rusnyder`
 + `@PeroSoy`
++ Shubham, `@i-shubham01`
++ Don "Swanson" I., `@Don-Swanson-Adobe`
 
 
 ## Sponsors
@@ -98,11 +102,11 @@ Without the support of these executives, the FalconPy project would not have hap
 | Name | Role |
 | :-- | :-- |
 | Chris Kachigian, `@ckachigian` | Herder of Cats |
-| Rekha Das | Gatekeeper |
 | Robbie Coleman, `@erraggy` | Keymaster |
 | Mike Cryer | Colonel-in-Chief |
 
 #### Honorable mentions
++ Rekha Das
 + Jaime Franklin, `@franklinjff`
 + Shawn Wells, `@shawndwells`
 

{crowdstrike-falconpy-dev-1.4.1/src/crowdstrike_falconpy_dev.egg-info → crowdstrike-falconpy-dev-1.4.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: crowdstrike-falconpy-dev
-Version: 1.4.1
+Version: 1.4.3
 Summary: The CrowdStrike Falcon SDK for Python 3
 Home-page: https://github.com/CrowdStrike/falconpy
 Author: CrowdStrike
@@ -36,9 +36,18 @@ Classifier: Topic :: System :: Systems Administration
 Classifier: Topic :: Utilities
 Requires-Python: >=3.6
 Description-Content-Type: text/markdown
-Provides-Extra: dev
 License-File: LICENSE
 License-File: AUTHORS.md
+Requires-Dist: requests
+Requires-Dist: urllib3
+Provides-Extra: dev
+Requires-Dist: flake8; extra == "dev"
+Requires-Dist: coverage; extra == "dev"
+Requires-Dist: pydocstyle; extra == "dev"
+Requires-Dist: pylint; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: bandit; extra == "dev"
 
 ![CrowdStrike FalconPy](https://raw.githubusercontent.com/CrowdStrike/falconpy/main/docs/asset/cs-logo.png)
 
@@ -56,7 +65,7 @@ License-File: AUTHORS.md
 [![Release date](https://img.shields.io/github/release-date/CrowdStrike/falconpy)](https://github.com/CrowdStrike/falconpy/releases)
 [![Repo status](https://img.shields.io/osslifecycle/crowdstrike/falconpy?label=repo%20status)](https://github.com/CrowdStrike/falconpy/graphs/code-frequency)
 [![Commit activity](https://img.shields.io/github/commits-since/CrowdStrike/falconpy/latest)](https://github.com/CrowdStrike/falconpy/commits/main)
-![GitHub forks](https://img.shields.io/github/forks/crowdstrike/falconpy)
+![GitHub forks](https://img.shields.io/github/forks/crowdstrike/falconpy?style=flat)
 
 The FalconPy SDK contains a collection of Python classes that abstract CrowdStrike Falcon OAuth2 API interaction, removing duplicative code and allowing developers to focus on just the logic of their solution requirements.
 
@@ -130,6 +139,7 @@ For each CrowdStrike Falcon API service collection, a matching Service Class is
 
 - Closely follows Python and OpenAPI best practice for code style and syntax. PEP-8 compliant.
 - Completely abstracts token management, automatically refreshing your token when it expires.
+- Interact with newly released API operations not yet available in the library via the `override` method.
 - Provides simple programmatic patterns for interacting with CrowdStrike Falcon APIs.
 - Supports [cloud region autodiscovery](https://www.falconpy.io/Usage/Environment-Configuration.html#cloud-region-autodiscovery) for the CrowdStrike `US-1`, `US-2` and `EU-1` regions.
 - Supports dynamic [configuration](https://www.falconpy.io/Usage/Environment-Configuration.html) based upon the needs of your environment.

{crowdstrike-falconpy-dev-1.4.1 → crowdstrike-falconpy-dev-1.4.3}/README.md

@@ -9,7 +9,7 @@
 [![Release date](https://img.shields.io/github/release-date/CrowdStrike/falconpy)](https://github.com/CrowdStrike/falconpy/releases)
 [![Repo status](https://img.shields.io/osslifecycle/crowdstrike/falconpy?label=repo%20status)](https://github.com/CrowdStrike/falconpy/graphs/code-frequency)
 [![Commit activity](https://img.shields.io/github/commits-since/CrowdStrike/falconpy/latest)](https://github.com/CrowdStrike/falconpy/commits/main)
-![GitHub forks](https://img.shields.io/github/forks/crowdstrike/falconpy)
+![GitHub forks](https://img.shields.io/github/forks/crowdstrike/falconpy?style=flat)
 
 The FalconPy SDK contains a collection of Python classes that abstract CrowdStrike Falcon OAuth2 API interaction, removing duplicative code and allowing developers to focus on just the logic of their solution requirements.
 
@@ -83,6 +83,7 @@ For each CrowdStrike Falcon API service collection, a matching Service Class is
 
 - Closely follows Python and OpenAPI best practice for code style and syntax. PEP-8 compliant.
 - Completely abstracts token management, automatically refreshing your token when it expires.
+- Interact with newly released API operations not yet available in the library via the `override` method.
 - Provides simple programmatic patterns for interacting with CrowdStrike Falcon APIs.
 - Supports [cloud region autodiscovery](https://www.falconpy.io/Usage/Environment-Configuration.html#cloud-region-autodiscovery) for the CrowdStrike `US-1`, `US-2` and `EU-1` regions.
 - Supports dynamic [configuration](https://www.falconpy.io/Usage/Environment-Configuration.html) based upon the needs of your environment.

{crowdstrike-falconpy-dev-1.4.1 → crowdstrike-falconpy-dev-1.4.3/src/crowdstrike_falconpy_dev.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: crowdstrike-falconpy-dev
-Version: 1.4.1
+Version: 1.4.3
 Summary: The CrowdStrike Falcon SDK for Python 3
 Home-page: https://github.com/CrowdStrike/falconpy
 Author: CrowdStrike
@@ -36,9 +36,18 @@ Classifier: Topic :: System :: Systems Administration
 Classifier: Topic :: Utilities
 Requires-Python: >=3.6
 Description-Content-Type: text/markdown
-Provides-Extra: dev
 License-File: LICENSE
 License-File: AUTHORS.md
+Requires-Dist: requests
+Requires-Dist: urllib3
+Provides-Extra: dev
+Requires-Dist: flake8; extra == "dev"
+Requires-Dist: coverage; extra == "dev"
+Requires-Dist: pydocstyle; extra == "dev"
+Requires-Dist: pylint; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: bandit; extra == "dev"
 
 ![CrowdStrike FalconPy](https://raw.githubusercontent.com/CrowdStrike/falconpy/main/docs/asset/cs-logo.png)
 
@@ -56,7 +65,7 @@ License-File: AUTHORS.md
 [![Release date](https://img.shields.io/github/release-date/CrowdStrike/falconpy)](https://github.com/CrowdStrike/falconpy/releases)
 [![Repo status](https://img.shields.io/osslifecycle/crowdstrike/falconpy?label=repo%20status)](https://github.com/CrowdStrike/falconpy/graphs/code-frequency)
 [![Commit activity](https://img.shields.io/github/commits-since/CrowdStrike/falconpy/latest)](https://github.com/CrowdStrike/falconpy/commits/main)
-![GitHub forks](https://img.shields.io/github/forks/crowdstrike/falconpy)
+![GitHub forks](https://img.shields.io/github/forks/crowdstrike/falconpy?style=flat)
 
 The FalconPy SDK contains a collection of Python classes that abstract CrowdStrike Falcon OAuth2 API interaction, removing duplicative code and allowing developers to focus on just the logic of their solution requirements.
 
@@ -130,6 +139,7 @@ For each CrowdStrike Falcon API service collection, a matching Service Class is
 
 - Closely follows Python and OpenAPI best practice for code style and syntax. PEP-8 compliant.
 - Completely abstracts token management, automatically refreshing your token when it expires.
+- Interact with newly released API operations not yet available in the library via the `override` method.
 - Provides simple programmatic patterns for interacting with CrowdStrike Falcon APIs.
 - Supports [cloud region autodiscovery](https://www.falconpy.io/Usage/Environment-Configuration.html#cloud-region-autodiscovery) for the CrowdStrike `US-1`, `US-2` and `EU-1` regions.
 - Supports dynamic [configuration](https://www.falconpy.io/Usage/Environment-Configuration.html) based upon the needs of your environment.

{crowdstrike-falconpy-dev-1.4.1 → crowdstrike-falconpy-dev-1.4.3}/src/falconpydev/_auth_object/_falcon_interface.py

@@ -41,11 +41,7 @@ For more information, please refer to <https://unlicense.org>
 import time
 import os
 import warnings
-from json import loads
-try:
-    from simplejson import JSONDecodeError
-except (ImportError, ModuleNotFoundError):  # Support import as a module
-    from json.decoder import JSONDecodeError
+from contextvars import copy_context
 from logging import Logger, getLogger
 from typing import Dict, Optional, Union
 from ._base_falcon_auth import BaseFalconAuth
@@ -56,21 +52,23 @@ from ._interface_config import InterfaceConfiguration
 from .._enum import TokenFailReason
 from .._util import (
     autodiscover_region,
+    confirm_base_url,
     perform_request,
     log_class_startup,
     login_payloads,
-    logout_payloads
+    logout_payloads,
+    review_provided_credentials
     )
-from .._error import InvalidCredentials, NoAuthenticationMechanism, InvalidCredentialFormat
+from .._error import InvalidCredentials, NoAuthenticationMechanism
 
 
-# pylint: disable=R0902
+# pylint: disable=R0902,R0904
 class FalconInterface(BaseFalconAuth):
     """Standard Falcon API interface used by Service Classes."""
 
-    # ____ ____ _  _ ____ ___ ____ _  _ ____ ___ ____ ____
-    # |    |  | |\ | [__   |  |__/ |  | |     |  |  | |__/
-    # |___ |__| | \| ___]  |  |  \ |__| |___  |  |__| |  \
+    # _______  _____  __   _ _______ _______  ______ _     _ _______ _______  _____   ______
+    # |       |     | | \  | |______    |    |_____/ |     | |          |    |     | |_____/
+    # |_____  |_____| |  \_| ______|    |    |    \_ |_____| |_____     |    |_____| |    \_
     #
     # The default constructor for all authentication objects. Ingests provided credentials
     # and sets the necessary class attributes based upon the authentication detail received.
@@ -90,7 +88,8 @@ class FalconInterface(BaseFalconAuth):
                  debug: Optional[bool] = False,
                  debug_record_count: Optional[int] = None,
                  sanitize_log: Optional[bool] = None,
-                 pythonic: Optional[bool] = False
+                 pythonic: Optional[bool] = False,
+                 environment: Optional[Dict[str, str]] = None
                  ) -> "FalconInterface":
         """Construct an instance of the FalconInterface class."""
         # Set the pythonic behavior mode.
@@ -98,12 +97,6 @@ class FalconInterface(BaseFalconAuth):
         if isinstance(pythonic, bool):
             self._pythonic = pythonic
 
-        # The default credential dictionary, where the client_id and client_secret are stored.
-        self._creds = {}
-
-        # Set up an empty Bearer Token container
-        self._token: BearerToken = BearerToken()
-
         # Setup our configuration object using the provided keywords.
         self._config: InterfaceConfiguration = InterfaceConfiguration(base_url=base_url,
                                                                       proxy=proxy,
@@ -114,50 +107,87 @@ class FalconInterface(BaseFalconAuth):
         # ____ _  _ ___ _  _ ____ _  _ ___ _ ____ ____ ___ _ ____ _  _                 |
         # |__| |  |  |  |__| |___ |\ |  |  | |    |__|  |  | |  | |\ |                / \
         # |  | |__|  |  |  | |___ | \|  |  | |___ |  |  |  | |__| | \|
-        # Direct Authentication
-        if client_id and client_secret and not creds:
-            creds = {
-                "client_id": client_id,
-                "client_secret": client_secret
-            }
-            # You must pass member_cid the same way you pass client_id / secret.
-            # If you use a creds dictionary, pass the member_cid there instead.
-            if member_cid:
-                creds["member_cid"] = member_cid
-        elif not creds:
-            creds = {}
-        # Credential Authentication (also powers Direct Authentication).
-        if isinstance(creds, str):
-            try:
-                # Try and clean up any attempts to provide the dictionary as a string
-                self._creds: Dict[str, str] = loads(creds.replace("'", "\""))
-            except (TypeError, JSONDecodeError) as bad_cred_format:
-                raise InvalidCredentialFormat from bad_cred_format
-        elif isinstance(creds, dict):
-            self._creds: Dict[str, str] = creds
-        else:
-            raise InvalidCredentialFormat
-
-        # Legacy (Token) Authentication (fallback)
-        if access_token:
-            # Store this non-refreshable token, assuming it was just generated.
-            self._token: BearerToken = BearerToken(access_token, 1799, 201)
-
-        # Set the token renewal window, ignored when using Legacy Authentication.
-        self.renew_window: int = max(min(renew_window, MAX_TOKEN_RENEW_WINDOW),
-                                     MIN_TOKEN_RENEW_WINDOW
-                                     )
+        #
+        # Assume no credentials or tokens are provided.
+        # A NoAuthenticationMechanism warning will be generated if a
+        # valid authentication mechanism is not specified or detected.
+        #
+        # Then try to authenticate in the following order:
+        #    1. Direct
+        #    2. Credential
+        #    3. Token (Legacy)
+        #    4. Context (Foundry)
+        #    5. Environment
+        #
+        # Remaining authentication checks are skipped once a successful mechanism has been determined.
+        #
+        # Object Authentication is handled within the ServiceClass object and leverages the existing
+        # authentication used for the underlying authentication object attribute.
+
+        # Set up an empty Bearer Token container.
+        self._token: BearerToken = BearerToken()
 
-        # Environment Authentication
-        # When credentials are not provided, attempt to retrieve them from the environment.
+        # ___  _ ____ ____ ____ ___    ____ _  _ ___     ____ ____ ____ ___  ____ _  _ ___ _ ____ _
+        # |  \ | |__/ |___ |     |     |__| |\ | |  \    |    |__/ |___ |  \ |___ |\ |  |  | |__| |
+        # |__/ | |  \ |___ |___  |     |  | | \| |__/    |___ |  \ |___ |__/ |___ | \|  |  | |  | |___
+        #
+        # Direct Authentication checks provided values and return a creds dictionary based upon the contents.
+        # Authorization is derived from the bearer token generated using the provided credentials.
+        self._creds, self._auth_style = review_provided_credentials(client_id, client_secret, creds, member_cid)
+
+        # ___ ____ _  _ ____ _  _
+        #  |  |  | |_/  |___ |\ |
+        #  |  |__| | \_ |___ | \|
+        #
+        # Token (Legacy) Authentication
+        # Authorization is derived from the provided bearer token.
+        # A login event is unnecessary when using this authentication mechanism.
+        if not self.cred_format_valid:
+            if access_token:
+                # Store this non-refreshable token, assuming it was just generated.
+                self._token: BearerToken = BearerToken(access_token, 1799, 201)
+                self._auth_style = "TOKEN"
+
+        # ____ ____ _  _ ___ ____ _  _ ___
+        # |    |  | |\ |  |  |___  \/   |
+        # |___ |__| | \|  |  |___ _/\_  |
+        #
+        # Context Authentication searches the current running context for
+        # an object containing a bearer token as an attribute or property.
+        # Authorization is derived from the discovered bearer token.
+        # A login event is unnecessary when using this authentication mechanism.
+        if not self.cred_format_valid and not self.token_value:
+            for cvar in copy_context().values():
+                try:
+                    # Any object is acceptable as long as it has an attribute or property named "access_token".
+                    self._token: BearerToken = BearerToken(cvar.access_token, 1799, 201)
+                    # Attempt to retrieve the cloud region from the same object.
+                    # Fall back to our previously set default on failure.
+                    try:
+                        if cvar.cs_cloud:
+                            self._config.base_url = confirm_base_url(cvar.cs_cloud)
+                    except AttributeError:
+                        pass
+                    self._auth_style = "CONTEXT"
+                    break
+                except AttributeError:
+                    pass
+
+        # ____ _  _ _  _ _ ____ ____ _  _ _  _ ____ _  _ ___
+        # |___ |\ | |  | | |__/ |  | |\ | |\/| |___ |\ |  |
+        # |___ | \|  \/  | |  \ |__| | \| |  | |___ | \|  |
+        #
+        # Environment Authentication searches the current environment for variables containing credentials.
+        # Authorization is derived from the bearer token generated using the discovered credentials.
+        # Developers may customize which variable names are searched by leveraging the environment keyword (dictionary).
+        self._environment = environment if environment else {}
         if not self.cred_format_valid and not self.token_value:
             # Both variables must be present within the running environment.
-            if os.getenv("FALCON_CLIENT_ID") and os.getenv("FALCON_CLIENT_SECRET"):
-                api_id = os.getenv("FALCON_CLIENT_ID") if "client_id" not in self.creds else self.creds["client_id"]
-                if "client_secret" not in self.creds:
-                    api_sec = os.getenv("FALCON_CLIENT_SECRET")
-                else:
-                    api_sec = self.creds["client_secret"]
+            if os.getenv(f"{self.env_prefix}{self.env_key}") and os.getenv(f"{self.env_prefix}{self.env_secret}"):
+                api_id = os.getenv(f"{self.env_prefix}{self.env_key}") \
+                    if "client_id" not in self.creds else self.creds["client_id"]
+                api_sec = os.getenv(f"{self.env_prefix}{self.env_secret}") \
+                    if "client_secret" not in self.creds else self.creds["client_secret"]
                 # Environment Authentication will not override values that preexist in the creds dictionary.
                 self._creds = {
                     "client_id": api_id,
@@ -166,7 +196,17 @@ class FalconInterface(BaseFalconAuth):
                 # Provide member_cid for MSSP environment authentication scenarios. Issue #1105.
                 if member_cid:
                     self._creds["member_cid"] = member_cid
+                self._auth_style = "ENVIRONMENT"
+
+        # Set the token renewal window, ignored when using Legacy or Context Authentication.
+        self.renew_window: int = max(min(renew_window, MAX_TOKEN_RENEW_WINDOW),
+                                     MIN_TOKEN_RENEW_WINDOW
+                                     )
 
+        # _    ____ ____ ____ _ _  _ ____
+        # |    |  | | __ | __ | |\ | | __
+        # |___ |__| |__] |__] | | \| |__]
+        #
         # Log the creation of this object if debugging is enabled.
         # Starting with v1.3.0 minimal Python native logging is available. In order to reduce
         # potential impacts to developer configurations, this facility is extremely limited
@@ -188,27 +228,34 @@ class FalconInterface(BaseFalconAuth):
             # Set up an empty log facility
             self._log: LogFacility = LogFacility()
 
+        # _  _ ____ _    _ ___  ____ ___ ____
+        # |  | |__| |    | |  \ |__|  |  |___
+        #  \/  |  | |___ | |__/ |  |  |  |___
+        #
+        # Validation occurs after the logging object is created.
         try:
+            # Check to see if we have a valid authentication mechanism configured.
             if not self.cred_format_valid and not self.token_value:
                 raise NoAuthenticationMechanism
         except NoAuthenticationMechanism as no_auth_mechanism:
+            # Warn appropriately if we do not.
             if pythonic:
                 warnings.warn(no_auth_mechanism.message, NoAuthenticationMechanism, stacklevel=2)
             if self.log:
                 self.log.warning(no_auth_mechanism.message)
 
-    # _  _ ____ ___ _  _ ____ ___  ____
-    # |\/| |___  |  |__| |  | |  \ [__
-    # |  | |___  |  |  | |__| |__/ ___]
+    #  _______ _______ _______ _     _  _____  ______  _______
+    #  |  |  | |______    |    |_____| |     | |     \ |______
+    #  |  |  | |______    |    |     | |_____| |_____/ ______|
     #
     # The generic login and logout handlers are provided here and leverage private methods
     # to perform the operation. These private methods can be overridden to provide individual
     # login and logout functionality to different inheriting class types.
-    def login(self) -> dict or bool:
+    def login(self) -> Union[dict, bool]:
         """Login to the Falcon API by requesting a new token."""
         return self._login_handler()
 
-    def logout(self) -> dict or bool:
+    def logout(self) -> Union[dict, bool]:
         """Log out of the Falcon API by revoking the current token."""
         return self._logout_handler()
 
@@ -299,9 +346,9 @@ class FalconInterface(BaseFalconAuth):
 
         return returned
 
-    # ___  ____ ____ ___  ____ ____ ___ _ ____ ____
-    # |__] |__/ |  | |__] |___ |__/  |  | |___ [__
-    # |    |  \ |__| |    |___ |  \  |  | |___ ___]
+    #  _____   ______  _____   _____  _______  ______ _______ _____ _______ _______
+    # |_____] |_____/ |     | |_____] |______ |_____/    |      |   |______ |______
+    # |       |    \_ |_____| |       |______ |    \_    |    __|__ |______ ______|
     #
     # These properties are present in all FalconInterface derivatives.
     @property
@@ -327,47 +374,47 @@ class FalconInterface(BaseFalconAuth):
     @property
     def base_url(self) -> str:
         """Return the base URL for this interface from the configuration object."""
-        return self._config.base_url
+        return self.config.base_url
 
     @base_url.setter
     def base_url(self, value):
-        self._config.base_url = value
+        self.config.base_url = value
 
     @property
     def ssl_verify(self) -> bool:
         """Return the SSL verification setting from the configuration object."""
-        return self._config.ssl_verify
+        return self.config.ssl_verify
 
     @ssl_verify.setter
     def ssl_verify(self, value: bool):
-        self._config.ssl_verify = value
+        self.config.ssl_verify = value
 
     @property
     def proxy(self) -> Dict[str, str]:
         """Return the current proxy setting."""
-        return self._config.proxy
+        return self.config.proxy
 
     @proxy.setter
     def proxy(self, value: Dict[str, str]):
-        self._config.proxy = value
+        self.config.proxy = value
 
     @property
     def user_agent(self) -> str:
         """Return the current user agent setting."""
-        return self._config.user_agent
+        return self.config.user_agent
 
     @user_agent.setter
     def user_agent(self, value: str):
-        self._config.user_agent = value
+        self.config.user_agent = value
 
     @property
     def timeout(self) -> Union[int, tuple]:
         """Return the current timeout setting."""
-        return self._config.timeout
+        return self.config.timeout
 
     @timeout.setter
     def timeout(self, value: Union[int, tuple]):
-        self._config.timeout = value
+        self.config.timeout = value
 
     @property
     def debug_record_count(self) -> int:
@@ -452,6 +499,16 @@ class FalconInterface(BaseFalconAuth):
     def token_value(self, value: str):
         self.bearer_token.value = value
 
+    @property
+    def pythonic(self) -> bool:
+        """Return a boolean if we are in a pythonic mode."""
+        return self._pythonic
+
+    @pythonic.setter
+    def pythonic(self, value: bool):
+        """Enable or disable pythonic mode."""
+        self._pythonic = value
+
     # All properties defined here are by design IMMUTABLE.
     @property
     def refreshable(self) -> bool:
@@ -503,11 +560,21 @@ class FalconInterface(BaseFalconAuth):
         return bool(self.log)
 
     @property
-    def pythonic(self) -> bool:
-        """Return a boolean if we are in a pythonic mode."""
-        return self._pythonic
+    def env_prefix(self) -> str:
+        """Return the environment prefix."""
+        return self._environment.get("prefix", "FALCON_")
 
-    @pythonic.setter
-    def pythonic(self, value: bool):
-        """Enable or disable pythonic mode."""
-        self._pythonic = value
+    @property
+    def env_key(self) -> str:
+        """Return the environment API key name."""
+        return self._environment.get("id_name", "CLIENT_ID")
+
+    @property
+    def env_secret(self) -> str:
+        """Return the environment API key secret."""
+        return self._environment.get("secret_name", "CLIENT_SECRET")
+
+    @property
+    def auth_style(self) -> str:
+        """Return the authentication mechanism used to instantiate this object."""
+        return self._auth_style

{crowdstrike-falconpy-dev-1.4.1 → crowdstrike-falconpy-dev-1.4.3}/src/falconpydev/_auth_object/_uber_interface.py

@@ -77,7 +77,8 @@ class UberInterface(FalconInterface):
                  debug: Optional[bool] = False,
                  debug_record_count: Optional[int] = MAX_DEBUG_RECORDS,
                  sanitize_log: Optional[bool] = None,
-                 pythonic: Optional[bool] = None
+                 pythonic: Optional[bool] = None,
+                 environment: Optional[Dict[str, str]] = None
                  ):
         """Construct an instance of the UberInterface class.
 
@@ -126,7 +127,8 @@ class UberInterface(FalconInterface):
                          debug=debug,
                          debug_record_count=debug_record_count,
                          sanitize_log=sanitize_log,
-                         pythonic=pythonic
+                         pythonic=pythonic,
+                         environment=environment
                          )
 
         # Complete list of available API operations.

{crowdstrike-falconpy-dev-1.4.1 → crowdstrike-falconpy-dev-1.4.3}/src/falconpydev/_endpoint/_alerts.py

@@ -169,7 +169,8 @@ _alerts_endpoints = [
         "in": "query"
       },
       {
-        "description": "request body takes a list of action parameter request that is applied against all \"ids\" provided",
+        "description": "request body takes a list of action parameter request that is applied against all "
+        "\"composite_ids\" provided",
         "name": "body",
         "in": "body",
         "required": True