Py42

Added

- The following enums classes are now available to reference in `py42.constants` in addition to their original modules:
- `CaseStatus`
- `RiskTags`
- `TrustedActivityType`
- `DepartingEmployeeFilters`
- `HighRiskEmployeeFilters`

Fixed

- Bug where `sdk.alerts.get_all_alert_details()` was raising error when no alerts were found in query.

Added

- New `trustedactivities` client with the following new methods:
- `sdk.trustedactivities.get_all()` to get all trusted activities.
- `sdk.trustedactivities.create()` to create a new trusted activity.
- `sdk.trustedactivities.get()` to get details about a single trusted activity.
- `sdk.trustedactivities.update()` to update a trusted activity.
- `sdk.trustedactivities.delete()` to delete a trusted activity

- New custom exceptions
- `Py42TrustedActivityInvalidChangeError`
- `Py42TrustedActivityConflictError`
- `Py42TrustedActivityInvalidCharacterError`
- `Py42TrustedActivityIdNotFound`

- New custom `HTTP 409 error` wrapper class `Py42ConflictError`

Fixed

- Bug where `sdk.securitydata.search_all_file_events()` errored when `page_token` param was `None`.
- Issue where `sdk.devices.get_page()` raises a vague error message when provided with invalid org UID.

Added

- New alias method `sdk.securitydata.savedsearches.search_file_events()` for existing method `sdk.securitydata.savedsearches.execute()`.

- Two new `riskIndicator.UserBehavior` filter values
- `First use of destination`
- `Rare use of destination`

Changed

- Updated minimum version of `requests` library to 2.4.2

Added

- `RiskIndicator` and `RiskSeverity` filter classes to new `py42.sdk.queries.fileevents.filters.risk_filter` module.

- Support for Incydr SKUs that do not include backup and restore functionality to `sdk.securitydata.stream_file_by_sha256()` and `sdk.securitydata.stream_file_by_md5()`.

- New method `sdk.alerts.get_all_alert_details()` as a helper to make getting alerts with details easier (combines `sdk.alerts.search_all_pages()` and `sdk.alerts.get_details()`).

- New method `sdk.loginconfig.get_for_user()` to identify if a user's login type is `LOCAL`, `LOCAL_2FA`, or `CLOUD_SSO`.

Removed

- py42 no longer supports python 2.7 or python 3.5.

- Usage of `Py42MFARequiredError`. Use `sdk.loginconfig.get_for_user()` instead to check if a user is configured for two-factor authentication.

- FED (File Extraction Detection) - related functionality from the `SecurityDataClient` class
- `get_security_plan_storage_info_list()`
- `get_all_plan_security_events()`
- `get_all_user_security_events()`
- `PlanStorageInfo` class

Fixed

- Issue where debug logs double-stringified JSON data while logging requests.

- Issue where `sdk.securitydata.search_file_events()` and `sdk.alerts.search()` would raise `UnicodeError`
when queries included certain unicode characters.