Py42

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.

Fixed

- `sdk.securitydata.search_all_file_events()` now automatically escapes double-quote characters in the `page_token` param
when passed.

- An issue where `FileEventQuery.sort_direction` and `FileEventQuery.sort_key` properties were not applied to searches
when a `page_token` was passed in calls to `sdk.securitydata.search_all_file_events()`.

- Methods `sdk.auditlogs.get_all()` and `sdk.auditlogs.get_page()` now honor microseconds when parameters
`begin_time` or `end_time` are epoch times.

Added

- Custom exception `Py42InvalidEmailError` when providing an invalid email to `sdk.users.update_user()`.

- Custom exception `Py42InvalidPasswordError` when providing an invalid password to `sdk.users.update_user()`.

- Custom exception `Py42InvalidUsernameError` when providing an invalid username to `sdk.users.update_user()`.