v1.0.0b1

1.0.0b1 - 2020-07-14

Changed

• -i (--incremental) has been removed, use -c (--use-checkpoint) with a string name for the checkpoint instead.

• The code42cli has been migrated to the click framework. This brings:

  • BREAKING CHANGE: Commands that accept multiple values for the same option now must have the option flag provided before each value:
    use --option value1 --option value2 instead of --option value1 value2 (which was previously possible).
  • Cosmetic changes to error messages, progress bars, and help message formatting.

• The print command on the security-data and alerts command groups has been replaced with the search command.
  This was a name change only, all other functionality remains the same.

• A profile created with the --disable-ssl-errors flag will now correctly not verify SSL certs when making requests. A warning message is printed
  each time the CLI is run with a profile configured this way, as it is not recommended.

Added

• Profile can now save multiple alert and file event checkpoints. The name of the checkpoint to be used for a given query should be passed to -c (--use-checkpoint).

Removed

• The write-to and send-to commands on security-data and alerts command groups.

v0.7.3

0.7.3 - 2020-06-23

Fixed

• Fixed bug that caused the last few entries in csv files to sometimes not be processed when performing bulk processing actions.

v0.7.2

0.7.2 - 2020-06-11

Fixed

• Fixed bug that caused alert-rules list to error due to page size restrictions on backing service.

v0.7.1

0.7.1 - 2020-06-10

Fixed

• Issue that prevented alerts from being retrieved successfully via code42 alerts commands due to a change in its backing API.

v0.7.0

0.7.0 - 2020-06-08

Changed

• code42cli no longer supports python 2.7.

• code42 profile create now uses required --name, --server and --username flags instead of positional arguments.

• code42 high-risk-employee add-risk-tags now uses required --username and --tag flags instead of positional arguments.

• code42 high-risk-employee remove-risk-tags now uses required --username and --tag flags instead of positional arguments.

Added

• code42 high-risk-employee bulk supports add-risk-tags and remove-risk-tags.

  • code42 high-risk-employee bulk generate-template <cmd> options add-risk-tags and remove-risk-tags.
    • add-risk-tags that takes a csv file with username and space separated risk tags.
    • remove-risk-tags that takes a csv file with username and space separated risk tags.

• Display, Fuzzy suggestions, valid keywords matching mistyped commands or arguments.

• code42 alerts:

  • Ability to search/poll for alerts with checkpointing using one of the following commands:
    • print to output to stdout.
    • write-to to output to a file.
    • send-to to output to server via UDP or TCP.

• code42 alert-rules commands:

  • add-user with parameters --rule-id and --username.
  • remove-user that takes a rule ID and optionally --username.
  • list.
  • show takes a rule ID.
  • bulk with subcommands:
    • add: that takes a csv file with rule IDs and usernames.
    • generate-template: that creates the file template. And parameters:
      • cmd: with options add and remove.
      • path
    • remove: that takes a csv file with rule IDs and usernames.

• code42 legal-hold commands:

  • add-user with parameters --matter-id/-m and --username/-u.
  • remove-user with parameters --matter-id/-m and --username/-u.
  • list prints out existing active legal hold matters.
  • show takes a matter_id and prints details of the matter.
    • optional argument --include-inactive additionally prints matter memberships that are no longer active.
    • optional argument --include-policy additionally prints out the matter's backup preservation policy in json form.
  • bulk with subcommands:
    • add-user: that takes a csv file with matter IDs and usernames.
    • remove-user: that takes a csv file with matter IDs and usernames.
    • generate-template: that creates the file templates.
      • cmd: with options add and remove.
      • path

• Success messages for profile delete and profile update.

• Additional information in the error log file:

  • The full command path for the command that errored.
  • User-facing error messages you see during adhoc sessions.

• A custom error in the error log when you try adding unknown risk tags to user.

• A custom error in the error log when you try adding a user to a detection list who is already added.

• Graceful handling of keyboard interrupts (ctrl-c) so stack traces aren't printed to console.

• Warning message printed when ctrl-c is encountered in the middle of an operation that could cause incorrect checkpoint
  state, a second ctrl-c is required to quit while that operation is ongoing.

• A progress bar that displays during bulk commands.

• Short option -u added for code42 high-risk-employee add-risk-tags and remove-risk-tags.

Fixed

• Fixed bug in bulk commands where value-less fields in csv files were treated as empty strings instead of None.
• Fixed anomaly where the path to the error log on Windows contained mixed slashes.

v0.6.0b2

bump (#92)

v0.6.0b1

prep for prerelease (#59)

v0.5.3

0.5.3 - 2020-05-04

Fixed

• Issue introduced in py42 v1.1.0 that prevented high-risk-employee and departing-employee commands from working properly.

v0.5.2

0.5.2 - 2020-04-29

Fixed

• Issue that prevented bulk csv loading.

v0.5.1

0.5.1 - 2020-04-27

Fixed

• Issue that prevented version 0.5.0 from updating its dependencies properly.

• Issue that prevented the add and bulk add functionality of departing-employee and high-risk-employee from successfully adding users to lists when specifying optional fields.