Passivetotal

Enhancements

- Better support for unit tests in client libraries with ability to set a
session to override default request methods.
- Add flexibility to library class instantiation to prefer keyword parameters
over config file keys.
- Support for new `create_date` Articles API data field and query parameter. Enables
searching for most recent articles instead of returning all of them at once, and
provides visiblity to situations where an article published in the past was recently
added to the Articles collection.


Breaking Changes

- Previously, calls to `analyzer.AllArticles()` would return all articles without a date
limit. Now, it will return only articles created after the starting date set with
`analyzer.set_date_range()`. The current module-level default for all date-bounded queries
is 90 days back, so now this function will return all articles created in the last 90 days.
- `age` property of an Article analyzer object is now based on `create_date` instead of publish
date.


Bug Fixes

[ none ]

Enhancements

- Send new request headers for metrics and troubleshooting with the `set_context`
method on the `analyzer` module and within the core API request libs.
- Abstract package version into a distinct file to consolidate updates and ensure
consistency across docs and pypi. Add `get_version` method to `analyzer` module
for easy access to the current version number.


Bug Fixes

Enhancements

- Adds support for the Illuminate CTI module with Intel Profile API library
calls and `analzyer` objects. Includes support for all API parameters and
handles pagination automatically.
- Adds support for Illuminate Attack Surface Intelligence including third-party
attack surfaces.
- Ability to filter all RecordList analyzer objects by a list of values using
new `filter_in` method.
- Ability to filter all RecordList analyzer objects by a case-insensitive
substring search using new `filter_substring` method. Especially useful for
filtering a list of Attack Surface Insights or Attack Surface Third-Party vendors.



Bug Fixes

- Filter methods on RecordList objects now consistently return lists instead of
filters.
- Property return NotImplemented type for base methods.
- Ensure strings are returned for firstseen / lastseen dates in certificates
property. Was causing json encoding errors when trying to encode
`certificates.as_dict`.
- Add missing `duration` property to pDNS `resolutions.as_dict`
- Fixed save_to_project() API call; was broken after introduction of new API
exception types.

Enhancements:

- Raise `AnalyzerAPIError` when a non-200 response is returned from the API.
- Add SSL hash field to list of SSL fields in dictionary output for more convenient
integrations.
- Add firstseen and lastseen dates to SSL Certificate records.
- Optional support for the Pandas data analysis library. Adds as_df property to all
Analyzer objects to render the object as a Pandas dataframe.
- Add option to specify module-level date ranges with `datetime` objects for
easier integration with other libraries.
- Subdomain API support with the `subdomains` property of Hostname objects.



Bug Fixes

- `is_ip()` regex fix to avoid matching on hostnames with embedded IPs.
- Fixed broken `available` property on summary objects.
- Fixed missing publish date on Articles

Enhancements:

- Throw `AnalyzerError` when a hostname cannot be resolved to an IP
- Add links to summary card as_dict method



Bug Fixes

- Added missing docstring for `services` property
- Fixed various issues with `as_dict` property to ensure only serializable
types made it into the dictionary.
- Ensured Projects would load by GUID regardless of visiblity.
- Removed a partially-implemented __str__ method in `MalwareList` method
- Ensured all __str__ methods in `analyzer` objects always return a string
- Upserting an artifact triggered an API error when setting a tag
- Ensure `summary` property returns ints, not None, when fields are missing
- Properly handle defanged ip addresses
- Exclude Nones from sets in various properties to avoid problems with `NoneTypes`

Enhancements:

- Added an `as_dict` property across all Analyzer objects to simplify integration
with other systems. Returns a dictionary representation of the object or the list.
- New `projects` attribute on IPAddress and Hostname objects returns list of projects
that contain that host as an artifact.
- New `analyzer.set_project()` method on the Analyzer module to set an active project
by name or guid, and new `add_to_project()` methods on Analyzer objects to quickly
add the object to the active project.
- Direct methods on new `Project` and `Artifact` objects to directly manipulate monitoring
status and tags.


Bug Fixes:

- Added missing ArtifactsRequest to package-level imports