Axonius-api-client

AXONSHELL

AXONSHELL enhancements

- NEW COMMAND GROUP: axonshell enforcements - work with enforcement center
- `axonshell enforcements copy` - Copy an Enforcement Set.
- `axonshell enforcements create` - Create an Enforcement Set.
- `axonshell enforcements delete` - Delete an Enforcement Set.
- `axonshell enforcements get` - Get Enforcement Sets.
- `axonshell enforcements get-action-types` - Get Action Types.
- `axonshell enforcements update-action-add` - Add an action to a set.
- `axonshell enforcements update-action-main` - Update the main action of a set.
- `axonshell enforcements update-action-remove` - Remove an action from a set.
- `axonshell enforcements update-name` - Update the name of a set.
- `axonshell enforcements update-on-count-above` - Update only run when asset count is above N.
- `axonshell enforcements update-on-count-below` - Update only run when asset count is below N.
- `axonshell enforcements update-on-count-decreased` - Update only run when asset count decreases.
- `axonshell enforcements update-on-count-increased` - Update only run when asset count increases.
- `axonshell enforcements update-only-new-assets` - Update only run against new assets.
- `axonshell enforcements update-query` - Update the query of a set.
- `axonshell enforcements update-query-remove` - Remove the query from a set.
- `axonshell enforcements update-schedule-daily` - Update a set to run daily.
- `axonshell enforcements update-schedule-discovery` - Update a set to run on discovery.
- `axonshell enforcements update-schedule-hourly` - Update a set to run hourly.
- `axonshell enforcements update-schedule-monthly` - Update a set to run monthly.
- `axonshell enforcements update-schedule-never` - Update a set to never run.
- `axonshell enforcements update-schedule-weekly` - Update a set to run weekly.


API Library

API Library Enhancements
- client.enforcements: reworked completely, methods:
- `client.enforcements.attach_full_set()` - get the full details of an enforcement set and attach the basic details
- `client.enforcements.check_set_exists` - check if an enforcement set exists with the given name
- `client.enforcements.copy` - duplicate an enforcement set
- `client.enforcements.create` - create an enforcement set
- `client.enforcements.delete` - delete an enforcement set
- `client.enforcements.get_action_type` - get a single action type
- `client.enforcements.get_action_types` - get all action types
- `client.enforcements.get_set` - get a single enforcement set
- `client.enforcements.get_set_action` - create an action object for inclusion in an enforcement set
- `client.enforcements.get_sets` - get all enforcement sets
- `client.enforcements.get_sets_generator` - get all enforcement sets using a generator
- `client.enforcements.get_trigger_view` - get the associated saved query name and type for inclusion in an enforcement set
- `client.enforcements.update_action_add` - add an action to an action category (post, sucesss, failure) for an enforcement set
- `client.enforcements.update_action_main` - update the main action of an enforcement set
- `client.enforcements.update_action_remove` - remove an action from an action category (post, sucesss, failure) for an enforcement set
- `client.enforcements.update_from_model` - update an enforcement set
- `client.enforcements.update_name` - update the name of an enforcement set
- `client.enforcements.update_on_count_above` - update the on_count_above condition for an enforcement set
- `client.enforcements.update_on_count_below` - update the on_count_below condition for an enforcement set
- `client.enforcements.update_on_count_decreased` - update the on_count_decreased condition for an enforcement set
- `client.enforcements.update_on_count_increased` - update the on_count_increased condition for an enforcement set
- `client.enforcements.update_only_new_assets` - update the only_new_assets condition for an enforcement set
- `client.enforcements.update_query` - update the saved query name and type for an enforcement set
- `client.enforcements.update_query_remove` - remove the saved query trigger from an enforcement set
- `client.enforcements.update_schedule_daily` - change the schedule to run daily for an enforcement set
- `client.enforcements.update_schedule_discovery` - change the schedule to run every discovery for an enforcement set
- `client.enforcements.update_schedule_hourly` - change the schedule to run hourly for an enforcement set
- `client.enforcements.update_schedule_monthly` - change the schedule to run monthly for an enforcement set
- `client.enforcements.update_schedule_never` - change the schedule to never run for an enforcement set
- `client.enforcements.update_schedule_weekly` - change the schedule to run weekly for an enforcement set
- `client.enforcements._copy` - private method to copy an enforcement set
- `client.enforcements._create` - private method to create an enforcement set
- `client.enforcements._delete` - private method to delete an enforcement set
- `client.enforcements._get_action_types` - private method to get action types
- `client.enforcements._get_set` - private method to get an enforcement set by UUID
- `client.enforcements._get_sets` - private method to get all enforcement sets
- `client.enforcements._triggers_map` - map of trigger query types to api objects
- `client.enforcements._update` - private method to update an enforcement set

- client.instances: new methods:
- `client.instances.api_version - get the current API version of the REST API
- `client.instances.api_versions - get all available API versions of the REST API
- `client.instances._get_api_version` - private method to get current API version of the REST API
- `client.instances._get_api_versions`- private method to get all available versions of the REST API

What's Changed
* backmerge by lifehackjim in https://github.com/Axonius/axonius_api_client/pull/180
* windows does not support : in filename by lifehackjim in https://github.com/Axonius/axonius_api_client/pull/181
* Bugfix/assets export csv/empty column names by lifehackjim in https://github.com/Axonius/axonius_api_client/pull/183
* 4.30.0 by lifehackjim in https://github.com/Axonius/axonius_api_client/pull/185


**Full Changelog**: https://github.com/Axonius/axonius_api_client/compare/4.20.3...4.30.0

AXONSHELL

AXONSHELL bugfixes

- axonshell devices/users get
- empty column headers for --export-format csv

AXONSHELL

AXONSHELL bugfixes

- axonshell devices/users get
- Fixed support for templating in --export-path and --export-file, windows does not support ':' in filename

What's Changed
* windows does not support : in filename by lifehackjim in https://github.com/Axonius/axonius_api_client/pull/181
* 4.20.4 by lifehackjim in https://github.com/Axonius/axonius_api_client/pull/182


**Full Changelog**: https://github.com/Axonius/axonius_api_client/compare/4.20.3...4.20.4

AXONSHELL

AXONSHELL enhancments

- axonshell devices/users get
- Added support for templating in --export-path and --export-file, templates supported:
- **{DATE}** - will be replaced with current datetime stamp in UTC format
- **{HISTORY_DATE}** - will be replaced with date of history snapshot chosen or current datetime stamp in UTC format

What's Changed
* Feature/asset export file templating by lifehackjim in https://github.com/Axonius/axonius_api_client/pull/179


**Full Changelog**: https://github.com/Axonius/axonius_api_client/compare/4.20.2...4.20.3

AXONSHELL

AXONSHELL fixes

- axonshell certs from-file

'tuple' object has no attribute 'to_str'


- axonshell certs gui-get

** ERROR: WRAPPED EXCEPTION: builtins.FileNotFoundError
[Errno 2] No such file or directory: '/Users/jimbo/gh/Axonius/axonapi/10.20.3.233.pem'


AXONSHELL enhancments

- axonshell certs *
- add a barrier between each certificate printed out in str format

API Library

API Library fixes

- axonius_api_client.http.Http - fix requests environment variable merging
- If OS Environment variable `REQUESTS_CA_BUNDLE` exists, it would replace the supplied certpath causing SSL verification to fail.
- Fixed by passing in values from session instead of None.

**Full Changelog**: https://github.com/Axonius/axonius_api_client/compare/4.20.1...4.20.2

AXONSHELL

AXONSHELL fixes

AXONSHELL enhancments
- tweaks/minor fixes to numerous commands

- NEW ENVIRONMENT VARIABLES:
- AX_USER_AGENT: if set, will override the User Agent used internally

- NEW COMMAND GROUP: axonshell certs - work with SSL certificates
- axonshell certs ca-enable - enable/disable custom CAs setting in GUI
- axonshell certs ca-add - add a custom CA to the GUI from a file
- axonshell certs ca-remove - remove a custom CA from the GUI
- axonshell certs ca-get - get the current custom CAs in GUI
- axonshell certs gui-info - get basic info about the current SSL cert in GUI
- axonshell certs gui-reset - revert the GUI SSL cert to the one generated at install time
- axonshell certs gui-update - update the GUI SSL cert with a cert & key file
- axonshell certs csr-get - get the pending CSR
- axonshell certs csr-create - create a CSR
- axonshell certs csr-cancel - cancel a pending CSR
- axonshell certs from-file - display / convert certs from a PEM/PKCS7/DER file to PEM/str/json
- axonshell certs from-url - display / convert cert chain from a URL to PEM/str/json

- REMOVED COMMANDS:
- axonshell tools convert-cert - use axonshell certs from-file as a replacement

API Library

API Library fixes

API Library Enhancements
- package:
- numerous improvements to axonius_api_client.http.Http
- NEW MODULES:
- cert_human - to add tooling for working with SSL certs

- NEW DEPENDENCIES:
- asn1crypto>=1.4.0 for working with SSL certs

- NEW ENVIRONMENT VARIABLES:
- AX_USER_AGENT: if set, will override the User Agent used internally

- NEW METHODS:
- settings_global.ca_enable - enable/disable custom CAs setting in GUI
- settings_global.check_cert_is_ca - check if a cert is a CA cert
- settings_global.ca_add_path - add a custom CA to the GUI from a file
- settings_global.ca_add - add a custom CA to the GUI from bytes/str
- settings_global.cas_to_str - pretty print the custom CAs currently in GUI
- settings_global.ca_remove - remove a custom CA from the GUI
- settings_global.ca_get - get the current custom CAs in GUI
- settings_global.gui_cert_info - get basic info about the current SSL cert in GUI
- settings_global.gui_cert_reset - revert the GUI SSL cert to the one generated at install time
- settings_global.gui_cert_update_path - update the GUI SSL cert with a cert & key file
- settings_global.gui_cert_update - update the GUI SSL cert with a cert & key bytes/str
- settings_global.csr_get - get the pending CSR
- settings_global.csr_create - create a CSR
- settings_global.csr_cancel - cancel a pending CSR
- settings_global._cert_uploaded - direct API method
- settings_global._gui_cert_update - direct API method
- settings_global._gui_cert_reset - direct API method
- settings_global._cert_settings - direct API method
- settings_global._gui_cert_info - direct API method
- settings_global._csr_get - direct API method
- settings_global._csr_cancel - direct API method
- settings_global._csr_create - direct API method

What's Changed
* Feature/install ssl cert by nate-axonius in https://github.com/Axonius/axonius_api_client/pull/175


**Full Changelog**: https://github.com/Axonius/axonius_api_client/compare/4.20.0...4.20.1