Code42cli

Added

- New command `code42 users list` with options:
- `--org-uid` filters on org membership.
- `--role-name` filters on users having a particular role.
- `--active` and `--inactive` filter on user status.

Fixed

- Bug where some CSV outputs on Windows would have an extra newline between the rows.

- Issue where outputting or sending an alert or file-event with a timestamp without
decimals would error.

- A performance issue with the `code42 departing-employee bulk add` command.

Changed

- `code42 alert-rules list` now outputs via a pager when results contain more than 10 rules.

- `code42 cases list` now outputs via a pager when results contain more than 10 cases.

Added

- `code42 legal-hold search-events` command:
- `--matter-id` filters based on a legal hold uid.
- `--begin` filters based on a beginning timestamp.
- `--end` filters based on an end timestamp.
- `--event-type` filters based on a list of event types.

Fixed

- Arguments/options that read data from files now attempt to autodetect file encodings.
Resolving a bug where CSVs written on Windows with Powershell would fail to be read properly.

Added

- `code42cli.extensions` module exposes `sdk_options` decorator and `script` group for writing custom extension scripts
using the Code42 CLI.

- `code42 devices list` options:
- `--include-legal-hold-membership` prints the legal hold matter name and ID for any active device on legal hold
- `--include-total-storage` prints the backup archive count and total storage

Changed

- Command options for `profile update`:
- `-n` `--name` is not required, and if omitted will use the default profile.
- `-s` `--server` and `-u` `--username` are not required and can be updated independently now.
- Example: `code42 profile update -s 1.2.3.4:1234`

Fixed

- Issue where `code42 alert-rules bulk add` would show as successful when adding users to a non-existent alert rule.

Added

- New choice `TLS-TCP` for `--protocol` option used by `send-to` commands:
- `code42 security-data send-to`
- `code42 alerts send-to`
- `code42 audit-logs send-to`
for more securely transporting data. Included are new flags:
- `--certs`
- `--ignore-cert-validation`

Changed

- The error text in cases command when:
- `cases create` sets a name that already exists in the system.
- `cases create` sets a description that has more than 250 characters.
- `cases update` sets a description that has more than 250 characters.
- `cases file-events add` is performed on an already closed case.
- `cases file-events add` sets an event id that is already added to the case.
- `cases file-events remove` is performed on an already closed case.

Added

- The `devices` command is added. Included are:
- `devices deactivate` to deactivate a single device.
- `devices reactivate` to reactivate a single device.
- `devices show` to retrieve detailed information about a device.
- `devices list` to retrieve info about many devices, including device settings.
- `devices list-backup-sets` to retrieve detailed info about device backup sets.
- `devices bulk deactivate` to deactivate a list of devices.
- `devices bulk reactivate` to reactivate a list of devices.
- `devices bulk generate-template` to create a blank CSV file for bulk commands.

- `code42 departing-employee list` command.

- `code42 high-risk-employee list` command.

- `code42 cases` commands:
- `create` to create a new case.
- `update` to update case details.
- `export` to download a case summary as a PDF file.
- `list` to view all cases.
- `show` to view the details of a particular case.

- `code42 cases file-events` commands:
- `add` to add an event to a case.
- `remove` to remove an event from a case.
- `list` to view all events associated with a case.

Changed

- The error text when removing an employee from a detection list now references the employee
by ID rather than the username.

- Improved help text for date option arguments.