v1.19.3

1.19.3 - 2021-11-09

Removed

• Removed method Get_alert_log(), method was no longer functional

Changed

• updated URI paths to use new standardized versioning scheme

v1.19.2

1.19.2 - 2021-10-19

Fixed

• Decreased get_all_alert_details batch size to 25 when retrieving alert queries due to performance concerns.

v1.19.1

1.19.1 - 2021-10-12

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.

v1.19.0

1.19.0 - 2021-09-21

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

v1.18.1

1.18.1 - 2021-09-15

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.

v1.18.0

1.18.0 - 2021-08-19

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

v1.17.0

1.17.0 - 2021-08-10

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

v1.16.1

1.16.1 - 2021-07-20

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.

v1.16.0

1.16.0 - 2021-07-08

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().

v1.15.1

1.15.1 - 2021-06-22

Changed

• The DateObserved alert query filter now parses timestamps using microsecond precision.
• Change JWT auth token label from v3_user_token to Bearer when authenticating against the /c42api/v3/auth/jwt endpoint.

Fixed

• Python2.7 bug where non-unicode str timestamps would fail when used in a query filter.