Py42

Added

- Make `ExposureType.OUTSIDE_TRUSTED_DOMAINS` constant available.
- `sdk.securitydata` methods
- `stream_file_by_sha256()`
- `stream_file_by_md5()`

Changed

- `email` is now a required param on `py42.users.create_user()`.

Removed

- Faulty `py42.orgs.get_by_name()` method. Use `py42.orgs.get_all()` and/or any of the other `get_by_()` methods.

Fixed

- An unintended regression that caused `import py42.sdk.settings.debug` to fail.

Changed

- For security reasons, debug output no longer logs the headers on http requests.

Added

- Ability for users to provide their own logger for debug logging
- adds `sdk.detectionlists.refresh_user_scim_attributes()` to update user SCIM attributes in detection lists.

Fixed

- An issue that caused requests to `sdk.alerts.rules.get_all()`, `sdk.alerts.rules.get_all_by_name()`, and `sdk.alerts.rules.get_by_observer_id()` to fail due to a change made to their backing api.

Changed

- The default value of `py42.settings.items_per_page` has been changed to 500 (was 1000).
- Default debug logging moved from print statements to a logger writing to `sys.stderr`
- Debug logging levels now use standard levels from the `logging` module (old levels still work but are now
automatically mapped to appropriate `logging` module level, with both `debug.DEBUG` and `debug.TRACE` being mapped
to `logging.DEBUG`, as `DEBUG` is the lowest level of the `logging` module options).

Added

- `get_all_org_cold_storage_archives()` function to `ArchiveModule`, available at `sdk.archive.get_all_org_cold_storage_archives()`.

Fixed

- `AlertQuery` now defaults to a `page_size` of 500. A change made to the backing api of `sdk.alerts.search()` was causing all requests made with the previous default (10000) to fail.

Added

- `SavedSearchClient` available at `sdk.securitydata.savedsearches` with the following functions:
- `get()`
- `get_by_id()`
- `execute()`

- `get_scim_data_by_uid()` function to `UserClient`, available at `sdk.users.get_scim_data_by_uid()`.

Added

- `sdk.alerts.rules.get_by_observer_id()` to look up an alert rule by its observer id.

Changed

- The following methods that required either a single str or list of string argument can now also accept a tuple of strings:
- `sdk.alerts.get_details()`
- `sdk.alerts.resolve()`
- `sdk.alerts.reopen()`
- `sdk.detectionlists.add_risk_tags()`
- `sdk.detectionlists.remove_risk_tags()`

Removed

- `sdk.alerts.rules.get_by_name()`. Use `sdk.alerts.rules.get_all_by_name()` instead. It functions identically except for that it returns a generator of `Py42Response` objects rather than a list.