crowdstrike-falconpy-dev 1.6.1__tar.gz → 1.6.2__tar.gz

{crowdstrike_falconpy_dev-1.6.1 → crowdstrike_falconpy_dev-1.6.2}/.gitignore

@@ -2,6 +2,7 @@
 *.pyc
 *.swp
 *.egg
+.idea/*
 env/
 .venv/
 .eggs/

{crowdstrike_falconpy_dev-1.6.1 → crowdstrike_falconpy_dev-1.6.2}/CHANGELOG.md

@@ -1,3 +1,200 @@
+# Version 1.6.2
+## Added features and functionality
++ Added: New __Network Scan Global Configs__ service collection with two operations.
+    - _get_global_configs_
+    - _update_global_configs_
+    - `_endpoint/__init__.py`
+    - `_endpoint/_network_scan_global_configs.py`
+    - `_payload/__init__.py`
+    - `_payload/_network_scan_global_configs.py`
+    - `__init__.py`
+    - `network_scan_global_configs.py`
+    > Unit testing expanded to complete code coverage.
+    - `tests/test_network_scan_global_configs.py`
+
++ Added: New __Network Scan Scan Run Reports__ service collection with one operation.
+    - _get_scan_run_reports_
+    - `_endpoint/__init__.py`
+    - `_endpoint/_network_scan_scan_run_reports.py`
+    - `__init__.py`
+    - `network_scan_scan_run_reports.py`
+    > Unit testing expanded to complete code coverage.
+    - `tests/test_network_scan_scan_run_reports.py`
+
++ Added: New __Network Scan Scan Runs__ service collection with five operations.
+    - _aggregate_scan_runs_
+    - _get_scan_runs_
+    - _create_scan_runs_
+    - _update_scan_runs_
+    - _query_scan_runs_
+    - `_endpoint/__init__.py`
+    - `_endpoint/_network_scan_scan_runs.py`
+    - `_payload/__init__.py`
+    - `_payload/_network_scan_scan_runs.py`
+    - `__init__.py`
+    - `network_scan_scan_runs.py`
+    > Unit testing expanded to complete code coverage.
+    - `tests/test_network_scan_scan_runs.py`
+
++ Added: New __Network Scan Scanners__ service collection with four operations.
+    - _aggregate_scanners_
+    - _get_scanners_
+    - _update_scanners_
+    - _query_scanners_
+    - `_endpoint/__init__.py`
+    - `_endpoint/_network_scan_scanners.py`
+    - `_payload/__init__.py`
+    - `_payload/_network_scan_scanners.py`
+    - `__init__.py`
+    - `network_scan_scanners.py`
+    > Unit testing expanded to complete code coverage.
+    - `tests/test_network_scan_scanners.py`
+
++ Added: New __Network Scan Templates__ service collection with six operations.
+    - _get_template_configs_
+    - _get_templates_
+    - _create_templates_
+    - _update_templates_
+    - _delete_templates_
+    - _query_templates_
+    - `_endpoint/__init__.py`
+    - `_endpoint/_network_scan_templates.py`
+    - `_payload/__init__.py`
+    - `_payload/_network_scan_templates.py`
+    - `__init__.py`
+    - `network_scan_templates.py`
+    > Unit testing expanded to complete code coverage.
+    - `tests/test_network_scan_templates.py`
+
++ Added: New __Network Scan Networks__ service collection with six operations.
+    - _aggregate_networks_
+    - _get_networks_
+    - _create_networks_
+    - _update_networks_
+    - _delete_networks_
+    - _query_networks_
+    - `_endpoint/__init__.py`
+    - `_endpoint/_network_scan_networks.py`
+    - `_payload/__init__.py`
+    - `_payload/_network_scan_networks.py`
+    - `__init__.py`
+    - `network_scan_networks.py`
+    > Unit testing expanded to complete code coverage.
+    - `tests/test_network_scan_networks.py`
+
++ Added: New __Network Scan Scans__ service collection with six operations.
+    - _aggregate_scans_
+    - _get_scans_
+    - _create_scans_
+    - _update_scans_
+    - _delete_scans_
+    - _query_scans_
+    - `_endpoint/__init__.py`
+    - `_endpoint/_network_scan_scans.py`
+    - `_payload/__init__.py`
+    - `_payload/_network_scan_scans.py`
+    - `__init__.py`
+    - `network_scan_scans.py`
+    > Unit testing expanded to complete code coverage.
+    - `tests/test_network_scan_scans.py`
+
++ Added: New __Network Scan Zones__ service collection with seven operations.
+    - _aggregate_zones_
+    - _combined_zones_
+    - _get_zones_
+    - _create_zones_
+    - _update_zones_
+    - _delete_zones_
+    - _query_zones_
+    - `_endpoint/__init__.py`
+    - `_endpoint/_network_scan_zones.py`
+    - `_payload/__init__.py`
+    - `_payload/_network_scan_zones.py`
+    - `__init__.py`
+    - `network_scan_zones.py`
+    > Unit testing expanded to complete code coverage.
+    - `tests/test_network_scan_zones.py`
+
++ Added: New __Network Scan__ parent service collection aggregating all eight Network Scan sub-services via multiple inheritance.
+    - `__init__.py`
+    - `network_scan.py`
+
++ Added: Added one new operation to the __Spotlight Vulnerabilities__ service collection.
+    - _combinedQueryInstalledPatches_
+    - `_endpoint/_spotlight_vulnerabilties.py`
+    - `spotlight_vulnerabilities.py`
+    > Unit testing expanded to complete code coverage.
+    - `tests/test_spotlight_vulnerabilities.py`
+    - Thanks to @vratiskol for their contribution!
+
++ Added: Added two new operations to the __NGSIEM__ service collection.
+    - _CloneParser_
+    - _TestParserFromTemplate_
+    - `_endpoint/_ngsiem.py`
+    - `_endpoint/deprecated/_ngsiem.py`
+    - `_payload/__init__.py`
+    - `_payload/_ngsiem.py`
+    - `ngsiem.py`
+    > Unit testing expanded to complete code coverage.
+    - `tests/test_ngsiem.py`
+
++ Added: Added `device_policies.data-protection.applied`, `device_policies.data-protection.policy_id`, `device_policies.data-protection.policy_type`, `device_policies.data-protection-cloud.applied`, `device_policies.data-protection-cloud.policy_id`, `device_policies.data-protection-cloud.policy_type`, `device_policies.network-scan-content.applied`, `device_policies.network-scan-content.policy_id`, and `device_policies.network-scan-content.policy_type` as allowed filter and sort fields in the _CombinedHiddenDevicesByFilter_, _QueryDevicesByFilter_, and _QueryDevicesByFilterScroll_ operations within the __Hosts__ service collection.
+    - `_endpoint/_hosts.py`
+    - `_endpoint/deprecated/_hosts.py`
+    - `hosts.py`
+
++ Added: Added `multi_arch` as an allowed filter keyword in the _AggregateImageCountByBaseOS_, _AggregateImageCountByState_, _AggregateImageCount_, _GetCombinedImages_, _CombinedImageByVulnerabilityCount_, _CombinedImageDetail_, and _ReadCombinedImagesExport_ operations within the __Container Images__ service collection.
+    - `_endpoint/_container_images.py`
+    - `container_images.py`
+
++ Updated: Updated available FQL filter fields documentation in the _combinedQueryVulnerabilities_ operation within the __Spotlight Vulnerabilities__ service collection.
+    - `_endpoint/_spotlight_vulnerabilities.py`
+    - `_endpoint/deprecated/_spotlight_vulnerabilities.py`
+    - `spotlight_vulnerabilities.py`
+
++ Updated: Updated available sort fields documentation in the _query_scheduled_scans_ operation within the __ODS__ service collection.
+    - `_endpoint/_ods.py`
+    - `_endpoint/deprecated/_ods.py`
+    - `ods.py`
+
++ Deprecated: All operations within the __Incidents__ service collection have been deprecated by CrowdStrike and will be removed in the next major release.
+    - _CrowdScore_
+    - _GetBehaviors_
+    - _PerformIncidentAction_
+    - _GetIncidents_
+    - _QueryBehaviors_
+    - _QueryIncidents_
+    - `_endpoint/deprecated/_mapping.py`
+
++ Deprecated: The _AggregateFCIncidents_ and _QueryIncidentIdsByFilter_ operations within the __Falcon Complete Dashboard__ service collection have been deprecated by CrowdStrike and will be removed in the next major release.
+    - `_endpoint/deprecated/_mapping.py`
+
+## Issues resolved
++ Fixed: JSONDecodeError import bug.
+    - `util/_functions.py`
+    - `util/_auth.py`
+
++ Fixed: Added missing parameters `is_enabled` and `host_groups` to the _entities_policy_patch_v2_ operation from the __Data Protection Configuration__ service collection.
+    - `_payload/_data_protection_configuration.py`
+    - `data_protection_configuration.py`
+
++ Fixed: Added backward compatibility for `file` and `lookup_file` parameters. Closes #1372.
+    - `ngsiem.py`
+    > Unit testing updated to reflect modified operations.
+    - `tests/test_ngsiem.py`
+
++ Fixed: Fixed `case_id` and `description` not being sent as form data in the _upload_file_ operation within the __Case Management__ service collection. Closes #1445.
+    - `case_management.py`
+
++ Fixed: Added missing `anomaly`, `guardrail_notifications`, `mitre_attack`, and `template_id` parameters to the correlation rules payload builder. List parameters now accept comma-delimited strings or lists. Closes #1450.
+    - `_payload/_correlation_rules.py`
+
++ Fixed: Added missing `facet` keyword argument documentation to the _query_combined_hosts_ operation within the __Discover__ service collection. Closes #1382.
+    - `discover.py`
+
++ Fixed: Fixed _upload_file_ operation in the __NGSIEM__ service collection not returning the file ID on successful upload.
+    - `ngsiem.py`
+
 # Version 1.6.1
 ## Added features and functionality
 + Added: New __Admission Control Policies__ service collection with 15 operations.
@@ -170,6 +367,12 @@
     > Unit testing expanded to complete code coverage.
     - `tests/test_cloud_policies.py`
 
++ Removed: Removed `GetCSPMGCPUserScriptsAttachment` operation from the __D4CRegistration__ service collection.
+
++ Removed: Removed `GetCombinedImages` operation from the __FalconContainer__ service collection.
+
++ Removed: Removed `getCombinedAssessmentsQuery` operation from the __ZeroTrustAssessment__ service collection.
+
 + Added: Added `rule_category`, `rule_cloneable`, `rule_compliance_benchmark_uuid`, `rule_resource_type_name`, and `rule_risk_factor` as allowed filter and sort fields in the _QueryRules_ operation within the __Cloud Policies__ service collection.
     - `_endpoint/_cloud_policies.py`
     - `cloud_policies.py`

{crowdstrike_falconpy_dev-1.6.1 → crowdstrike_falconpy_dev-1.6.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: crowdstrike-falconpy-dev
-Version: 1.6.1
+Version: 1.6.2
 Summary: The CrowdStrike Falcon SDK for Python
 Project-URL: Documentation, https://www.falconpy.io
 Project-URL: Homepage, https://github.com/CrowdStrike/falconpy

{crowdstrike_falconpy_dev-1.6.1 → crowdstrike_falconpy_dev-1.6.2}/src/falconpydev/__init__.py

@@ -180,6 +180,15 @@ from .message_center import MessageCenter
 from .ml_exclusions import MLExclusions
 from .mobile_enrollment import MobileEnrollment
 from .mssp import FlightControl
+from .network_scan_global_configs import NetworkScanGlobalConfigs
+from .network_scan_networks import NetworkScanNetworks
+from .network_scan_scan_run_reports import NetworkScanScanRunReports
+from .network_scan_scan_runs import NetworkScanScanRuns
+from .network_scan_scanners import NetworkScanScanners
+from .network_scan_scans import NetworkScanScans
+from .network_scan_templates import NetworkScanTemplates
+from .network_scan_zones import NetworkScanZones
+from .network_scan import NetworkScan
 from .ngsiem import NGSIEM
 from .oauth2 import OAuth2
 from .ods import ODS
@@ -264,7 +273,10 @@ __all__ = [
     "CloudSecurityCompliance", "CaseManagement", "SaasSecurity", "DataProtectionConfiguration",
     "CorrelationRulesAdmin", "CloudSecurityDetections", "CloudPolicies", "CloudGoogleCloudRegistration",
     "CloudSecurity", "AdmissionControlPolicies",
-    "SpotlightVulnerabilityMetadata", "ServerlessExports", "ServerlessVulnerabilities"
+    "SpotlightVulnerabilityMetadata", "ServerlessExports", "ServerlessVulnerabilities",
+    "NetworkScanGlobalConfigs", "NetworkScanNetworks", "NetworkScanScanRunReports",
+    "NetworkScanScanRuns", "NetworkScanScanners", "NetworkScanScans",
+    "NetworkScanTemplates", "NetworkScanZones", "NetworkScan"
     ]
 """
 This is free and unencumbered software released into the public domain.

{crowdstrike_falconpy_dev-1.6.1 → crowdstrike_falconpy_dev-1.6.2}/src/falconpydev/_endpoint/__init__.py

@@ -141,6 +141,14 @@ from ._message_center import _message_center_endpoints
 from ._ml_exclusions import _ml_exclusions_endpoints
 from ._mobile_enrollment import _mobile_enrollment_endpoints
 from ._mssp import _mssp_endpoints
+from ._network_scan_global_configs import _network_scan_global_configs_endpoints
+from ._network_scan_networks import _network_scan_networks_endpoints
+from ._network_scan_scan_run_reports import _network_scan_scan_run_reports_endpoints
+from ._network_scan_scan_runs import _network_scan_scan_runs_endpoints
+from ._network_scan_scanners import _network_scan_scanners_endpoints
+from ._network_scan_scans import _network_scan_scans_endpoints
+from ._network_scan_templates import _network_scan_templates_endpoints
+from ._network_scan_zones import _network_scan_zones_endpoints
 from ._ngsiem import _ngsiem_endpoints
 from ._oauth2 import _oauth2_endpoints
 from ._ods import _ods_endpoints
@@ -248,6 +256,14 @@ api_endpoints.extend(_message_center_endpoints)
 api_endpoints.extend(_ml_exclusions_endpoints)
 api_endpoints.extend(_mobile_enrollment_endpoints)
 api_endpoints.extend(_mssp_endpoints)
+api_endpoints.extend(_network_scan_global_configs_endpoints)
+api_endpoints.extend(_network_scan_networks_endpoints)
+api_endpoints.extend(_network_scan_scan_run_reports_endpoints)
+api_endpoints.extend(_network_scan_scan_runs_endpoints)
+api_endpoints.extend(_network_scan_scanners_endpoints)
+api_endpoints.extend(_network_scan_scans_endpoints)
+api_endpoints.extend(_network_scan_templates_endpoints)
+api_endpoints.extend(_network_scan_zones_endpoints)
 api_endpoints.extend(_ngsiem_endpoints)
 api_endpoints.extend(_oauth2_endpoints)
 api_endpoints.extend(_ods_endpoints)

{crowdstrike_falconpy_dev-1.6.1 → crowdstrike_falconpy_dev-1.6.2}/src/falconpydev/_endpoint/_aspm.py

@@ -46,6 +46,7 @@ _aspm_endpoints = [
     "aspm",
     [
       {
+        "type": "string",
         "enum": [
           "sensitive_data",
           "reachable",
@@ -55,18 +56,17 @@ _aspm_endpoints = [
           "risk_severity",
           "sensitive_data_tags"
         ],
-        "type": "string",
         "name": "query_name",
         "in": "query",
         "required": True
       },
       {
+        "type": "string",
         "enum": [
           "aws",
           "azure",
           "gcp"
         ],
-        "type": "string",
         "name": "cloud_provider",
         "in": "query",
         "required": True
@@ -111,6 +111,7 @@ _aspm_endpoints = [
     "aspm",
     [
       {
+        "type": "string",
         "enum": [
           "sensitive_data",
           "reachable",
@@ -118,22 +119,21 @@ _aspm_endpoints = [
           "dependencies",
           "vulnerable_libraries"
         ],
-        "type": "string",
         "name": "query_name",
         "in": "query",
         "required": True
       },
       {
-        "enum": [
-          "aws",
-          "azure",
-          "gcp"
-        ],
         "type": "array",
         "items": {
           "type": "string"
         },
         "collectionFormat": "csv",
+        "enum": [
+          "aws",
+          "azure",
+          "gcp"
+        ],
         "name": "cloud_provider",
         "in": "query"
       },
@@ -323,26 +323,26 @@ _aspm_endpoints = [
         "in": "query"
       },
       {
+        "type": "array",
+        "items": {
+          "type": "string"
+        },
+        "collectionFormat": "csv",
         "enum": [
           "artifact_id",
           "artifact_name",
           "artifact_hash",
           "artifact_full_path"
         ],
-        "type": "array",
-        "items": {
-          "type": "string"
-        },
-        "collectionFormat": "csv",
         "name": "orderBy",
         "in": "query"
       },
       {
+        "type": "string",
         "enum": [
           "asc",
           "desc"
         ],
-        "type": "string",
         "name": "direction",
         "in": "query"
       }
@@ -413,22 +413,22 @@ _aspm_endpoints = [
         "in": "query"
       },
       {
+        "type": "string",
         "enum": [
           "name",
           "id",
           "state",
           "type"
         ],
-        "type": "string",
         "name": "order_by",
         "in": "query"
       },
       {
+        "type": "string",
         "enum": [
           "asc",
           "desc"
         ],
-        "type": "string",
         "name": "direction",
         "in": "query"
       },
@@ -455,7 +455,7 @@ _aspm_endpoints = [
       {
         "type": "array",
         "items": {
-          "type": "integer"
+          "type": "string"
         },
         "collectionFormat": "csv",
         "description": "executor node states",
@@ -532,7 +532,7 @@ _aspm_endpoints = [
       {
         "type": "array",
         "items": {
-          "type": "integer"
+          "type": "string"
         },
         "collectionFormat": "csv",
         "description": "executor node states",
@@ -559,8 +559,8 @@ _aspm_endpoints = [
     "aspm",
     [
       {
-        "pattern": "[0-9]+",
         "type": "integer",
+        "pattern": "[0-9]+",
         "name": "ID",
         "in": "path",
         "required": True
@@ -575,8 +575,8 @@ _aspm_endpoints = [
     "aspm",
     [
       {
-        "pattern": "[0-9]+",
         "type": "integer",
+        "pattern": "[0-9]+",
         "name": "ID",
         "in": "path",
         "required": True
@@ -610,8 +610,8 @@ _aspm_endpoints = [
     "aspm",
     [
       {
-        "pattern": "[0-9]+",
         "type": "integer",
+        "pattern": "[0-9]+",
         "description": "Group ID",
         "name": "ID",
         "in": "path",
@@ -627,8 +627,8 @@ _aspm_endpoints = [
     "aspm",
     [
       {
-        "pattern": "[0-9]+",
         "type": "integer",
+        "pattern": "[0-9]+",
         "description": "Group ID",
         "name": "ID",
         "in": "path",
@@ -644,8 +644,8 @@ _aspm_endpoints = [
     "aspm",
     [
       {
-        "pattern": "[0-9]+",
         "type": "integer",
+        "pattern": "[0-9]+",
         "description": "Group ID",
         "name": "ID",
         "in": "path",
@@ -661,8 +661,8 @@ _aspm_endpoints = [
     "aspm",
     [
       {
-        "pattern": "[0-9]+",
         "type": "integer",
+        "pattern": "[0-9]+",
         "description": "Group ID",
         "name": "ID",
         "in": "path",
@@ -726,21 +726,21 @@ _aspm_endpoints = [
         "in": "query"
       },
       {
+        "type": "string",
         "enum": [
           "name",
           "id",
           "integrationTask"
         ],
-        "type": "string",
         "name": "orderBy",
         "in": "query"
       },
       {
+        "type": "string",
         "enum": [
           "asc",
           "desc"
         ],
-        "type": "string",
         "name": "direction",
         "in": "query"
       },
@@ -803,21 +803,21 @@ _aspm_endpoints = [
         "in": "query"
       },
       {
+        "type": "string",
         "enum": [
           "name",
           "id",
           "integrationTask"
         ],
-        "type": "string",
         "name": "orderBy",
         "in": "query"
       },
       {
+        "type": "string",
         "enum": [
           "asc",
           "desc"
         ],
-        "type": "string",
         "name": "direction",
         "in": "query"
       },
@@ -846,11 +846,11 @@ _aspm_endpoints = [
     "aspm",
     [
       {
+        "type": "string",
         "enum": [
           "collecting",
           "exporting"
         ],
-        "type": "string",
         "name": "category",
         "in": "query"
       },
@@ -899,21 +899,21 @@ _aspm_endpoints = [
         "in": "query"
       },
       {
+        "type": "string",
         "enum": [
           "name",
           "id",
           "integrationTask"
         ],
-        "type": "string",
         "name": "orderBy",
         "in": "query"
       },
       {
+        "type": "string",
         "enum": [
           "asc",
           "desc"
         ],
-        "type": "string",
         "name": "direction",
         "in": "query"
       },
@@ -942,8 +942,8 @@ _aspm_endpoints = [
     "aspm",
     [
       {
-        "pattern": "[0-9]+",
         "type": "integer",
+        "pattern": "[0-9]+",
         "name": "ID",
         "in": "path",
         "required": True
@@ -963,8 +963,8 @@ _aspm_endpoints = [
     "aspm",
     [
       {
-        "pattern": "[0-9]+",
         "type": "integer",
+        "pattern": "[0-9]+",
         "name": "ID",
         "in": "path",
         "required": True
@@ -979,8 +979,8 @@ _aspm_endpoints = [
     "aspm",
     [
       {
-        "pattern": "[0-9]+",
         "type": "integer",
+        "pattern": "[0-9]+",
         "name": "ID",
         "in": "path",
         "required": True
@@ -1005,8 +1005,8 @@ _aspm_endpoints = [
     "aspm",
     [
       {
-        "pattern": "[0-9]+",
         "type": "integer",
+        "pattern": "[0-9]+",
         "name": "ID",
         "in": "path",
         "required": True
@@ -1031,8 +1031,8 @@ _aspm_endpoints = [
     "aspm",
     [
       {
-        "pattern": "[0-9]+",
         "type": "integer",
+        "pattern": "[0-9]+",
         "name": "ID",
         "in": "path",
         "required": True
@@ -1117,8 +1117,8 @@ _aspm_endpoints = [
     "aspm",
     [
       {
-        "pattern": "[0-9]+",
         "type": "integer",
+        "pattern": "[0-9]+",
         "name": "ID",
         "in": "path",
         "required": True
@@ -1138,8 +1138,8 @@ _aspm_endpoints = [
     "aspm",
     [
       {
-        "pattern": "[0-9]+",
         "type": "integer",
+        "pattern": "[0-9]+",
         "name": "ID",
         "in": "path",
         "required": True