# Immuta CLI Release Notes ## Immuta CLI v1.4.0 Immuta CLI v1.4.0 was released July 10, 2024. It allows you to authenticate an export configuration to S3 using AWS IAM roles. ### Breaking Changes The following CLI `audit` commands have been removed: * `immuta audit exportConfig create:s3`; instead use `immuta audit exportConfig create:s3:accessKey` * `immuta audit exportConfig update:s3`; instead use `immuta audit exportConfig update:s3:accessKey` * `immuta audit exportConfig create:adls`; instead use `immuta audit exportConfig create:adls:sasToken` * `immuta audit exportConfig update:adls`; instead use `immuta audit exportConfig update:adls:sasToken` ### Downloads #### **Linux** * **Linux x86\_64 (amd64)**: ```shell curl -Lo immuta https://immuta-platform-artifacts.s3.amazonaws.com/cli/v1.4.0/immuta_cli_linux_amd64 && chmod +x immuta ``` * **Linux ARMv8 (arm64)**: ```shell curl -Lo immuta https://immuta-platform-artifacts.s3.amazonaws.com/cli/v1.4.0/immuta_cli_linux_arm64 && chmod +x immuta ``` #### **MacOS** * **Darwin x86\_64 (amd64)**: ```shell curl -Lo immuta https://immuta-platform-artifacts.s3.amazonaws.com/cli/v1.4.0/immuta_cli_darwin_amd64 && chmod +x immuta ``` * **Darwin ARMv8 (arm64)**: ```shell curl -Lo immuta https://immuta-platform-artifacts.s3.amazonaws.com/cli/v1.4.0/immuta_cli_darwin_arm64 && chmod +x immuta ``` #### **Windows** Download and add the binary to a directory in your system's $PATH as `immuta.exe`: * #### **Verify the File** The SHA 256 checksum is available to verify the file at . ## Immuta CLI v1.3.0 Immuta CLI v1.3.0 was released April 4, 2024. It allows you to [export universal audit model (UAM) events to ADLS Gen2](https://documentation.immuta.com/2024.3/detect-your-activity/audit/how-to-guides/export-adls#configure-the-immuta-cli). ### Downloads #### Linux * **Linux x86\_64 (amd64)**: ```shell curl -Lo immuta https://immuta-platform-artifacts.s3.amazonaws.com/cli/v1.3.0/immuta_cli_linux_amd64 && chmod +x immuta ``` * **Linux ARMv8 (arm64)**: ```shell curl -Lo immuta https://immuta-platform-artifacts.s3.amazonaws.com/cli/v1.3.0/immuta_cli_linux_arm64 && chmod +x immuta ``` #### MacOS * **Darwin x86\_64 (amd64)**: ```shell curl -Lo immuta https://immuta-platform-artifacts.s3.amazonaws.com/cli/v1.3.0/immuta_cli_darwin_amd64 && chmod +x immuta ``` * **Darwin ARMv8 (arm64)**: ```shell curl -Lo immuta https://immuta-platform-artifacts.s3.amazonaws.com/cli/v1.3.0/immuta_cli_darwin_arm64 && chmod +x immuta ``` #### Windows Download and add the binary to a directory in your system's $PATH as `immuta.exe`: * #### Verify the File The SHA 256 checksum is available to verify the file at . ## Immuta CLI v1.2.1 Immuta CLI v1.2.1 was released November 20, 2023. It fixes a bug with the integrations API. ### Downloads #### Linux * **Linux x86\_64 (amd64)**: ```shell curl -Lo immuta https://immuta-platform-artifacts.s3.amazonaws.com/cli/v1.2.1/immuta_cli_linux_amd64 && chmod +x immuta ``` * **Linux ARMv8 (arm64)**: ```shell curl -Lo immuta https://immuta-platform-artifacts.s3.amazonaws.com/cli/v1.2.1/immuta_cli_linux_arm64 && chmod +x immuta ``` #### MacOS * **Darwin x86\_64 (amd64)**: ```shell curl -Lo immuta https://immuta-platform-artifacts.s3.amazonaws.com/cli/v1.2.1/immuta_cli_darwin_amd64 && chmod +x immuta ``` * **Darwin ARMv8 (arm64)**: ```shell curl -Lo immuta https://immuta-platform-artifacts.s3.amazonaws.com/cli/v1.2.1/immuta_cli_darwin_arm64 && chmod +x immuta ``` #### Windows Download and add the binary to a directory in your system's $PATH as `immuta.exe`: * #### Verify the File The SHA 256 checksum is available to verify the file at . ## Immuta CLI v1.2.0 Immuta CLI v1.2.0 was released October 2, 2023. It fixes a bug with the audit export. ### Downloads #### Linux * **Linux x86\_64 (amd64)**: ```shell curl -Lo immuta https://immuta-platform-artifacts.s3.amazonaws.com/cli/v1.2.0/immuta_cli_linux_amd64 && chmod +x immuta ``` * **Linux ARMv8 (arm64)**: ```shell curl -Lo immuta https://immuta-platform-artifacts.s3.amazonaws.com/cli/v1.2.0/immuta_cli_linux_arm64 && chmod +x immuta ``` #### MacOS * **Darwin x86\_64 (amd64)**: ```shell curl -Lo immuta https://immuta-platform-artifacts.s3.amazonaws.com/cli/v1.2.0/immuta_cli_darwin_amd64 && chmod +x immuta ``` * **Darwin ARMv8 (arm64)**: ```shell curl -Lo immuta https://immuta-platform-artifacts.s3.amazonaws.com/cli/v1.2.0/immuta_cli_darwin_arm64 && chmod +x immuta ``` #### Windows Download and add the binary to a directory in your system's $PATH as `immuta.exe`: * #### Verify the File The SHA 256 checksum is available to verify the file at . ## Immuta CLI v1.2.0-1 Immuta CLI v1.2.0-1 was released August 19, 2022. It allows you to [export universal audit model (UAM) events to S3](https://documentation.immuta.com/2024.3/developer-guides/the-immuta-cli/cli-reference-guide). ### Downloads #### Linux * **Linux x86\_64 (amd64)**: ```shell curl -Lo immuta https://immuta-platform-artifacts.s3.amazonaws.com/cli/v1.2.0-1/immuta_cli_linux_amd64 && chmod +x immuta ``` * **Linux ARMv8 (arm64)**: ```shell curl -Lo immuta https://immuta-platform-artifacts.s3.amazonaws.com/cli/v1.2.0-1/immuta_cli_linux_arm64 && chmod +x immuta ``` #### MacOS * **Darwin x86\_64 (amd64)**: ```shell curl -Lo immuta https://immuta-platform-artifacts.s3.amazonaws.com/cli/v1.2.0-1/immuta_cli_darwin_amd64 && chmod +x immuta ``` * **Darwin ARMv8 (arm64)**: ```shell curl -Lo immuta https://immuta-platform-artifacts.s3.amazonaws.com/cli/v1.2.0-1/immuta_cli_darwin_arm64 && chmod +x immuta ``` #### Windows Download and add the binary to a directory in your system's $PATH as `immuta.exe`: * #### Verify the File The SHA 256 checksum is available to verify the file at . ## Immuta CLI v1.1.0 Immuta CLI v1.1.0 was released August 19, 2022. It allows you to overwrite existing files in output directory targets when you specify the `--force` flag to [clone your Immuta tenant](https://documentation.immuta.com/2024.3/developer-guides/the-immuta-cli/immuta#clone-your-tenant-immuta-clone) or [policies](https://documentation.immuta.com/2024.3/developer-guides/the-immuta-cli/policies#clone-global-policies-immuta-policy-clone). If this `--force` flag is omitted, you will receive an error when the output directory exists and is not empty. ### Downloads #### Linux * **Linux x86\_64 (amd64)**: ```shell curl -Lo immuta https://immuta-platform-artifacts.s3.amazonaws.com/cli/v1.1.0/immuta_cli_linux_amd64 && chmod +x immuta ``` * **Linux ARMv8 (arm64)**: ```shell curl -Lo immuta https://immuta-platform-artifacts.s3.amazonaws.com/cli/v1.1.0/immuta_cli_linux_arm64 && chmod +x immuta ``` #### MacOS * **Darwin x86\_64 (amd64)**: ```shell curl -Lo immuta https://immuta-platform-artifacts.s3.amazonaws.com/cli/v1.1.0/immuta_cli_darwin_amd64 && chmod +x immuta ``` * **Darwin ARMv8 (arm64)**: ```shell curl -Lo immuta https://immuta-platform-artifacts.s3.amazonaws.com/cli/v1.1.0/immuta_cli_darwin_arm64 && chmod +x immuta ``` #### Windows Download and add the binary to a directory in your system's $PATH as `immuta.exe`: * #### Verify the File The SHA 256 checksum is available to verify the file at . ## Immuta CLI v1.0.0 The Immuta CLI v1.0.0 was released April 26, 2022. It includes new commands that allow users to manage sensitive data discovery. ### Downloads #### Linux * **Linux x86\_64 (amd64)**: ```shell curl -Lo immuta https://immuta-platform-artifacts.s3.amazonaws.com/cli/v1.0.0/immuta_cli_linux_amd64 && chmod +x immuta ``` * **Linux ARMv8 (arm64)**: ```shell curl -Lo immuta https://immuta-platform-artifacts.s3.amazonaws.com/cli/v1.0.0/immuta_cli_linux_arm64 && chmod +x immuta ``` #### MacOS * **Darwin x86\_64 (amd64)**: ```shell curl -Lo immuta https://immuta-platform-artifacts.s3.amazonaws.com/cli/v1.0.0/immuta_cli_darwin_amd64 && chmod +x immuta ``` * **Darwin ARMv8 (arm64)**: ```shell curl -Lo immuta https://immuta-platform-artifacts.s3.amazonaws.com/cli/v1.0.0/immuta_cli_darwin_arm64 && chmod +x immuta ``` #### Windows Download and add the binary to a directory in your system's $PATH as `immuta.exe`: * #### Verify the File The SHA 256 checksum is available to verify the file at . ### New Commands * [**Run sensitive data discovery (SDD)**](https://documentation.immuta.com/2024.3/developer-guides/the-immuta-cli/manage-sensitive-data-discovery/sdd): The `immuta sdd run` command allows you to run SDD using the CLI instead of the API or UI. You can specify data sources on which to run SDD, or you can run SDD on all data sources. * [**Manage patterns**](https://documentation.immuta.com/2024.3/developer-guides/the-immuta-cli/manage-sensitive-data-discovery/classifiers): The `immuta sdd classifier` command and its sub commands allow you to create, search for, update, and delete sensitive data discovery rules. * [**Manage identification frameworks**](https://documentation.immuta.com/2024.3/developer-guides/the-immuta-cli/manage-sensitive-data-discovery/templates): The `immuta sdd template` command and its sub commands allow you to create, search for, update, and delete sensitive data discovery frameworks. [Global frameworks](https://documentation.immuta.com/2024.3/discover-your-data/data-discovery/how-to-guides/global-sdd#configure-the-global-framework) must be managed through the Immuta UI. ### Updates and Enhancements * `--output` or `-o` flag allows you to specify yaml or json for the output. * `--template` option for the `immuta api` command has been changed to `--outputTemplate`. Additionally, this option is now available for all commands so that users can customize the output. * `version` is now a flag instead of a command. ### Fixes * Running `immuta policy clone` when there were no policies available to clone did not indicate that a target directory was not created or updated. The CLI now prints the message `No global policies available to clone`. ### Deprecations * The `verbose` option is deprecated (in favor of the `--output` option). * The `version` command is deprecated.