Crowdstrike-falconpy

Added features and functionality
+ Added: Return headers on failed authorization (401) when using the Uber class. Closes 578.
- `_util.py`
- `api_complete.py`
- Thank you to tsullivan06 for this enhancement suggestion!
+ Added: Allow dashed base url specifiers when creating instances of any class. Closes 580.
- `_util.py`
- Thanks to jhseceng for this enhancement suggestion!

Issues resolved
+ Fixed: Bandit false positive introduced by changes to hard-coded password scanning in v1.7.3. Relates to PyCQA/bandit843.
- `_token_fail_reason.py`
- `api_complete.py`
- `oauth2.py`

Other
+ Updated: Docstrings updated to reflect newly available platform names (`android`, `iOS`). Closes 582.
- `prevention_policy.py`

---

Added features and functionality
+ Added: Argument check in `update_detects_by_ids` (UpdateDetectsByIdsV2). When only a `comment` keyword is provided, `show_in_ui` is appended to the request with a `True` value, which satisfies update requirements.
- `detects.py`
- `tests/test_detects.py`
+ Added: Default value of `0` for `sequence_id` keyword in `check_command_status`, `check_active_responder_command_status` and `check_admin_command_status` methods within Real Time Response Service Classes.
- `real_time_response.py`
- `real_time_response_admin.py`
+ Added: Publicly exposed `confirm_base_region`, `confirm_base_url` methods and `BaseURL` enumerator.
- `__init__.py`

Issues resolved
+ Fixed: Missing alias for `api_preempt_proxy_post_graphql` (Operation ID syntax) in Identity Protection Service Class. Closes 567.
- `identity_protection.py`
- Thanks to tsullivan06 for identifying and reporting this issue!
+ Fixed: Incorrect variable used for dictionary key on boolean values within `command_payload` body payload handler. Closes 568.
- `_payload/_real_time_response.py`
- Relates to discussion [415](https://github.com/CrowdStrike/falconpy/discussions/415)

---

Added features and functionality
+ Added: Token renewal window customization. Developers may now customize the length of time between token expiration and token renewal. (Max: 20 minutes)
python
from falconpy import APIHarness
from falconpy import OAuth2

uber = APIHarness(client_id="CLIENT_ID", client_secret="CLIENT_SECRET", renew_window=300)
service = OAuth2(client_id="CLIENT_ID", client_secret="CLIENT_SECRET", renew_window=60)

- `_service_class.py`
- `api_complete.py`
- `oauth2.py`
- `tests/test_authentications.py`
- Thank you to tsullivan06 for this contribution!

+ Added: Error handling for when calling `query_vulnerabilities_combined` (combinedQueryVulnerabilities) without specifying a `filter` argument. (Must be present as a keyword or as part of the `parameters` dictionary.)
- `spotlight_vulnerabilities.py`
- `tests/test_spotlight_vulnerabilities.py`
- Thank you to tsullivan06 for this contribution!

+ Added: Export of `ServiceClass` generic base class as part of `__all__` within `__init__.py`. This change will allow developers to inherit from the Service Class base class without importing a protected module (which generates a warning in some editors).
python
from falconpy import ServiceClass

- `__init__.py`
- Thank you to morcef for this contribution!

Issues resolved
+ Fixed: Authentication issue when provided a base_url containing a trailing backslash.
- `_util.py`
- `tests/test_authorizations.py`
- Thanks to mwb8 for identifying and reporting this issue!

---

Issues resolved
+ Fixed: Bug in `process_service_request` (`_util.py`) impacting the `partition` keyword argument of the `refresh_active_stream` method in the Event Streams Service Class. Closes 547.
- `_util.py`
- `tests/test_event_streams.py`
- Thanks go out to kra-ts for contributing this fix!

---

Added features and functionality
+ Added: New _queryCombinedSensorUpdateKernels_ and _querySensorUpdateKernelsDistinct_ operations. (**SensorUpdatePolicy Service Class, Uber Class**)
- `_endpoint/_sensor_update_policies.py`
- `_util.py`
- `_version.py`
- `api_complete.py`
- `sensor_update_policy.py`
- `tests/test_sensor_update_policy.py`
- `tests/test_uber_api_complete.py`


---

Issues resolved
+ Fixed: Parameter abstraction handling issue with the `organization_ids` keyword of the `delete_aws_account` and `get_aws_account` methods within the CSPMRegistration Service Class. Closes 539.
- `cspm_registration.py`
- `tests/test_cspm_registration.py`

---