crowdstrike-falconpy-dev 1.4.3.dev1__tar.gz → 1.4.5__tar.gz

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

@@ -94,6 +94,13 @@ This has been a critical element in the development of the FalconPy project.
 + `@PeroSoy`
 + Shubham, `@i-shubham01`
 + Don "Swanson" I., `@Don-Swanson-Adobe`
++ Nick, `nickforsythbarr`
++ `nesies`
++ `David-M-Berry`
++ Oke Okumo, `@okewoma`
++ Alexander Moomaw, `@alhumaw`
++ Esha Kumar, `@exk200006`
++ Griffin Ansel, `@gansel51`
 
 
 ## Sponsors

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: crowdstrike-falconpy-dev
-Version: 1.4.3.dev1
+Version: 1.4.5
 Summary: The CrowdStrike Falcon SDK for Python 3
 Home-page: https://github.com/CrowdStrike/falconpy
 Author: CrowdStrike
@@ -27,6 +27,7 @@ Classifier: Programming Language :: Python :: 3.7
 Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
 Classifier: Framework :: Flake8
 Classifier: License :: OSI Approved :: The Unlicense (Unlicense)
 Classifier: Topic :: Security
@@ -35,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)
 

{crowdstrike-falconpy-dev-1.4.3.dev1 → crowdstrike-falconpy-dev-1.4.5}/dev_setup.py

@@ -153,6 +153,7 @@ setup(
         "Programming Language :: Python :: 3.8",
         "Programming Language :: Python :: 3.9",
         "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
         "Framework :: Flake8",
         "License :: OSI Approved :: The Unlicense (Unlicense)",
         "Topic :: Security",

{crowdstrike-falconpy-dev-1.4.3.dev1 → crowdstrike-falconpy-dev-1.4.5}/setup.py

@@ -91,6 +91,7 @@ setup(
             "pytest-cov",
             "pytest",
             "bandit",
+            "setuptools~=70.3.0"
         ],
     },
     classifiers=[

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: crowdstrike-falconpy-dev
-Version: 1.4.3.dev1
+Version: 1.4.5
 Summary: The CrowdStrike Falcon SDK for Python 3
 Home-page: https://github.com/CrowdStrike/falconpy
 Author: CrowdStrike
@@ -27,6 +27,7 @@ Classifier: Programming Language :: Python :: 3.7
 Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
 Classifier: Framework :: Flake8
 Classifier: License :: OSI Approved :: The Unlicense (Unlicense)
 Classifier: Topic :: Security
@@ -35,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)
 

{crowdstrike-falconpy-dev-1.4.3.dev1 → crowdstrike-falconpy-dev-1.4.5}/src/crowdstrike_falconpy_dev.egg-info/SOURCES.txt

@@ -11,8 +11,11 @@ src/crowdstrike_falconpy_dev.egg-info/top_level.txt
 src/falconpydev/__init__.py
 src/falconpydev/_version.py
 src/falconpydev/alerts.py
+src/falconpydev/api_integrations.py
+src/falconpydev/certificate_based_exclusions.py
 src/falconpydev/cloud_connect_aws.py
 src/falconpydev/cloud_snapshots.py
+src/falconpydev/compliance_assessments.py
 src/falconpydev/configuration_assessment.py
 src/falconpydev/configuration_assessment_evaluation_logic.py
 src/falconpydev/container_alerts.py
@@ -30,6 +33,7 @@ src/falconpydev/device_control_policies.py
 src/falconpydev/discover.py
 src/falconpydev/drift_indicators.py
 src/falconpydev/event_streams.py
+src/falconpydev/exposure_management.py
 src/falconpydev/falcon_complete_dashboard.py
 src/falconpydev/falcon_container.py
 src/falconpydev/falconx_sandbox.py
@@ -39,6 +43,7 @@ src/falconpydev/firewall_management.py
 src/falconpydev/firewall_policies.py
 src/falconpydev/foundry_logscale.py
 src/falconpydev/host_group.py
+src/falconpydev/host_migration.py
 src/falconpydev/hosts.py
 src/falconpydev/identity_protection.py
 src/falconpydev/image_assessment_policies.py
@@ -74,6 +79,7 @@ src/falconpydev/sensor_visibility_exclusions.py
 src/falconpydev/spotlight_evaluation_logic.py
 src/falconpydev/spotlight_vulnerabilities.py
 src/falconpydev/tailored_intelligence.py
+src/falconpydev/threatgraph.py
 src/falconpydev/unidentified_containers.py
 src/falconpydev/user_management.py
 src/falconpydev/workflows.py
@@ -94,8 +100,11 @@ src/falconpydev/_auth_object/_uber_interface.py
 src/falconpydev/_constant/__init__.py
 src/falconpydev/_endpoint/__init__.py
 src/falconpydev/_endpoint/_alerts.py
+src/falconpydev/_endpoint/_api_integrations.py
+src/falconpydev/_endpoint/_certificate_based_exclusions.py
 src/falconpydev/_endpoint/_cloud_connect_aws.py
 src/falconpydev/_endpoint/_cloud_snapshots.py
+src/falconpydev/_endpoint/_compliance_assessments.py
 src/falconpydev/_endpoint/_configuration_assessment.py
 src/falconpydev/_endpoint/_configuration_assessment_evaluation_logic.py
 src/falconpydev/_endpoint/_container_alerts.py
@@ -112,6 +121,7 @@ src/falconpydev/_endpoint/_device_control_policies.py
 src/falconpydev/_endpoint/_discover.py
 src/falconpydev/_endpoint/_drift_indicators.py
 src/falconpydev/_endpoint/_event_streams.py
+src/falconpydev/_endpoint/_exposure_management.py
 src/falconpydev/_endpoint/_falcon_complete_dashboard.py
 src/falconpydev/_endpoint/_falcon_container.py
 src/falconpydev/_endpoint/_falconx_sandbox.py
@@ -121,6 +131,7 @@ src/falconpydev/_endpoint/_firewall_management.py
 src/falconpydev/_endpoint/_firewall_policies.py
 src/falconpydev/_endpoint/_foundry_logscale.py
 src/falconpydev/_endpoint/_host_group.py
+src/falconpydev/_endpoint/_host_migration.py
 src/falconpydev/_endpoint/_hosts.py
 src/falconpydev/_endpoint/_identity_protection.py
 src/falconpydev/_endpoint/_image_assessment_policies.py
@@ -156,14 +167,17 @@ src/falconpydev/_endpoint/_sensor_visibility_exclusions.py
 src/falconpydev/_endpoint/_spotlight_evaluation_logic.py
 src/falconpydev/_endpoint/_spotlight_vulnerabilities.py
 src/falconpydev/_endpoint/_tailored_intelligence.py
+src/falconpydev/_endpoint/_threatgraph.py
 src/falconpydev/_endpoint/_unidentified_containers.py
 src/falconpydev/_endpoint/_user_management.py
 src/falconpydev/_endpoint/_workflows.py
 src/falconpydev/_endpoint/_zero_trust_assessment.py
 src/falconpydev/_endpoint/deprecated/__init__.py
+src/falconpydev/_endpoint/deprecated/_certificate_based_exclusions.py
 src/falconpydev/_endpoint/deprecated/_custom_ioa.py
 src/falconpydev/_endpoint/deprecated/_d4c_registration.py
 src/falconpydev/_endpoint/deprecated/_discover.py
+src/falconpydev/_endpoint/deprecated/_exposure_management.py
 src/falconpydev/_endpoint/deprecated/_fdr.py
 src/falconpydev/_endpoint/deprecated/_firewall_management.py
 src/falconpydev/_endpoint/deprecated/_hosts.py
@@ -189,6 +203,8 @@ src/falconpydev/_log/__init__.py
 src/falconpydev/_log/_facility.py
 src/falconpydev/_payload/__init__.py
 src/falconpydev/_payload/_alerts.py
+src/falconpydev/_payload/_api_integrations.py
+src/falconpydev/_payload/_certificate_based_exclusions.py
 src/falconpydev/_payload/_cloud_connect_aws.py
 src/falconpydev/_payload/_cloud_snapshots.py
 src/falconpydev/_payload/_container.py
@@ -196,6 +212,7 @@ src/falconpydev/_payload/_cspm_registration.py
 src/falconpydev/_payload/_d4c_registration.py
 src/falconpydev/_payload/_detects.py
 src/falconpydev/_payload/_device_control_policy.py
+src/falconpydev/_payload/_exposure_management.py
 src/falconpydev/_payload/_falconx.py
 src/falconpydev/_payload/_filevantage.py
 src/falconpydev/_payload/_firewall.py
@@ -207,6 +224,7 @@ src/falconpydev/_payload/_ioa.py
 src/falconpydev/_payload/_ioc.py
 src/falconpydev/_payload/_malquery.py
 src/falconpydev/_payload/_message_center.py
+src/falconpydev/_payload/_mobile_enrollment.py
 src/falconpydev/_payload/_mssp.py
 src/falconpydev/_payload/_ods.py
 src/falconpydev/_payload/_prevention_policy.py
@@ -239,11 +257,14 @@ src/falconpydev/api_complete/__init__.py
 src/falconpydev/api_complete/_advanced.py
 src/falconpydev/api_complete/_legacy.py
 tests/test_alerts.py
+tests/test_api_integrations.py
 tests/test_api_request.py
 tests/test_authentications.py
 tests/test_authorization.py
+tests/test_certificate_based_exclusions.py
 tests/test_cloud_connect_aws.py
 tests/test_cloud_snapshots.py
+tests/test_compliance_assessments.py
 tests/test_configuration_assessment.py
 tests/test_configuration_assessment_evaluation_logic.py
 tests/test_container_alerts.py
@@ -270,6 +291,7 @@ tests/test_firewall_management.py
 tests/test_firewall_policies.py
 tests/test_foundry_logscale.py
 tests/test_host_group.py
+tests/test_host_migration.py
 tests/test_hosts.py
 tests/test_identity_protection.py
 tests/test_image_assessment_policies.py
@@ -306,6 +328,7 @@ tests/test_service_class.py
 tests/test_spotlight_evaluation_logic.py
 tests/test_spotlight_vulnerabilities.py
 tests/test_tailored_intelligence.py
+tests/test_threatgraph.py
 tests/test_timeout.py
 tests/test_uber.py
 tests/test_uber_api_complete.py

{crowdstrike-falconpy-dev-1.4.3.dev1 → crowdstrike-falconpy-dev-1.4.5}/src/falconpydev/__init__.py

@@ -88,8 +88,11 @@ from ._api_request import (
     RequestValidator
     )
 from .alerts import Alerts
+from .api_integrations import APIIntegrations
 from .api_complete import APIHarness, APIHarnessV2
+from .certificate_based_exclusions import CertificateBasedExclusions
 from .cloud_snapshots import CloudSnapshots
+from .compliance_assessments import ComplianceAssessments
 from .configuration_assessment_evaluation_logic import ConfigurationAssessmentEvaluationLogic
 from .configuration_assessment import ConfigurationAssessment
 from .container_alerts import ContainerAlerts
@@ -107,6 +110,7 @@ from .device_control_policies import DeviceControlPolicies
 from .discover import Discover
 from .drift_indicators import DriftIndicators
 from .event_streams import EventStreams
+from .exposure_management import ExposureManagement
 from .falcon_complete_dashboard import CompleteDashboard
 from .falcon_container import FalconContainer
 from .falconx_sandbox import FalconXSandbox
@@ -117,6 +121,7 @@ from .firewall_policies import FirewallPolicies
 from .foundry_logscale import FoundryLogScale
 from .host_group import HostGroup
 from .hosts import Hosts
+from .host_migration import HostMigration
 from .identity_protection import IdentityProtection
 from .image_assessment_policies import ImageAssessmentPolicies
 from .incidents import Incidents
@@ -151,6 +156,7 @@ from .sensor_visibility_exclusions import SensorVisibilityExclusions
 from .spotlight_vulnerabilities import SpotlightVulnerabilities
 from .spotlight_evaluation_logic import SpotlightEvaluationLogic
 from .tailored_intelligence import TailoredIntelligence
+from .threatgraph import ThreatGraph
 from .unidentified_containers import UnidentifiedContainers
 from .user_management import UserManagement
 from .workflows import Workflows
@@ -195,7 +201,8 @@ __all__ = [
     "SDKDeprecationWarning", "ConfigurationAssessmentEvaluationLogic", "ConfigurationAssessment",
     "ContainerAlerts", "ContainerDetections", "ContainerImages", "ContainerPackages",
     "ContainerVulnerabilities", "DriftIndicators", "UnidentifiedContainers",
-    "ImageAssessmentPolicies"
+    "ImageAssessmentPolicies", "APIIntegrations", "ThreatGraph", "ExposureManagement",
+    "CertificateBasedExclusions", "ComplianceAssessments", "HostMigration"
     ]
 """
 This is free and unencumbered software released into the public domain.

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

@@ -42,11 +42,6 @@ import time
 import os
 import warnings
 from contextvars import copy_context
-from json import loads
-try:
-    from simplejson import JSONDecodeError
-except (ImportError, ModuleNotFoundError):  # Support import as a module
-    from json.decoder import JSONDecodeError
 from logging import Logger, getLogger
 from typing import Dict, Optional, Union
 from ._base_falcon_auth import BaseFalconAuth
@@ -57,26 +52,28 @@ 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.
     # pylint: disable=R0912,R0913,R0914
-    def __init__(self,
+    def __init__(self,  # noqa: C901
                  access_token: Optional[Union[str, bool]] = False,
                  base_url: Optional[str] = "https://api.crowdstrike.com",
                  creds: Optional[Dict[str, str]] = None,
@@ -100,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,
@@ -116,53 +107,81 @@ 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)
-
-        # Foundry authentication
-        ctx = copy_context()
-        for cvar in ctx.values():
-            try:
-                self._token: BearerToken = BearerToken(cvar.access_token, 1799, 201)
-                break
-            except AttributeError:
-                pass
-
-        # 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
-        # User configuration environment keys
+        # ___  _ ____ ____ ____ ___    ____ _  _ ___     ____ ____ ____ ___  ____ _  _ ___ _ ____ _
+        # |  \ | |__/ |___ |     |     |__| |\ | |  \    |    |__/ |___ |  \ |___ |\ |  |  | |__| |
+        # |__/ | |  \ |___ |___  |     |  | | \| |__/    |___ |  \ |___ |__/ |___ | \|  |  | |  | |___
+        #
+        # 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:
+                        if self.token_value:
+                            self._config.base_url = confirm_base_url(os.getenv("CS_CLOUD", "auto"))
+                    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 {}
-        # When credentials are not provided, attempt to retrieve them from the environment.
         if not self.cred_format_valid and not self.token_value:
             # Both variables must be present within the running environment.
             if os.getenv(f"{self.env_prefix}{self.env_key}") and os.getenv(f"{self.env_prefix}{self.env_secret}"):
@@ -178,7 +197,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
@@ -200,18 +229,25 @@ 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
@@ -311,9 +347,9 @@ class FalconInterface(BaseFalconAuth):
 
         return returned
 
-    # ___  ____ ____ ___  ____ ____ ___ _ ____ ____
-    # |__] |__/ |  | |__] |___ |__/  |  | |___ [__
-    # |    |  \ |__| |    |___ |  \  |  | |___ ___]
+    #  _____   ______  _____   _____  _______  ______ _______ _____ _______ _______
+    # |_____] |_____/ |     | |_____] |______ |_____/    |      |   |______ |______
+    # |       |    \_ |_____| |       |______ |    \_    |    __|__ |______ ______|
     #
     # These properties are present in all FalconInterface derivatives.
     @property
@@ -339,47 +375,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:
@@ -464,6 +500,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:
@@ -514,16 +560,6 @@ class FalconInterface(BaseFalconAuth):
         """Return a boolean if we are in a debug mode."""
         return bool(self.log)
 
-    @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
-
     @property
     def env_prefix(self) -> str:
         """Return the environment prefix."""
@@ -538,3 +574,8 @@ class FalconInterface(BaseFalconAuth):
     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.3.dev1 → crowdstrike-falconpy-dev-1.4.5}/src/falconpydev/_constant/__init__.py

@@ -46,7 +46,7 @@ PREFER_IDS_IN_BODY: List[str] = [
     "GetDeviceDetails", "PostDeviceDetailsV2", "GetVulnerabilities", "GetIntelIndicatorEntities",
     "getChildrenV2", "cancel-scans", "GetDetectSummaries", "UpdateQuarantinedDetectsByIds",
     "GetQuarantineFiles", "PostEntitiesAlertsV1", "CreateSavedSearchesDeployV1",
-    "WorkflowExecutionsAction"
+    "WorkflowExecutionsAction", "signalChangesExternal"
 ]
 MOCK_OPERATIONS: List[str] = [
     "GetImageAssessmentReport", "DeleteImageDetails", "ImageMatchesPolicy"