CLI Transforms
Learn about the CLI commands you can use to create, manage, and test transforms in this guide.
In Identity Security Cloud (ISC), you can use transforms to manipulate attribute data without writing any code. For more information about transforms, refer to Transforms.
With the transforms
command, it's it easy to create, manage, and test transforms in the CLI.
Commands
To create, manage, and test transforms with the CLI, you can use these commands:
- Commands
- List transforms
- Download transforms
- Create transform
- Update transform
- Delete transform
- Preview transform
List transforms
To get a list of the transforms available in your tenant, run this command:
sail transform list
This command produces a table of available transforms.
Download transforms
To download all the transforms in your tenant and save them as json
files on your computer, run the following command. By default, this command will save the files in the current working directory. Use the -d
flag to specify a path to an output directory.
sail transform download -d transform_files
By default, this command will save the files in the current working directory. Use the -d
flag to specify a path to an output directory.
This command will overwrite any existing files with the same name, so be careful when you run this in a directory that has transforms that have been modified but not yet saved.
Create transform
To create a new transform from a json
file, run the following command. Use the -f
flag to specify the path to the json
file.
sail transform create -f transform.json
Update transform
To update a transform from a json
file, run the following command. Use the -f
flag to specify the path to the json
file.
sail transform update -f transform.json
A common workflow is to first download the transforms, then make edits to the transform file, and then use the update command to save those edits in ISC.
Delete transform
To delete a transform, run this command:
sail transform delete <transform-id>
To delete multiple transforms, use this syntax:
sail transform delete <transform-id> <transform-id> <transform-id>
You can use this command in conjunction with the ls
command to find the ID of the transform you want to delete.
This is an example of how you can find a transform ID and delete it:
sail transform list
+--------------------------------------+--------------------------+
| ID | NAME |
+--------------------------------------+--------------------------+
| 03d5187b-ab96-402c-b5a1-40b74285d77a | WIFI Group |
| 06d589cf-4d7d-4b40-8617-c221092ceb2c | Remove Diacritical Marks |
| 1f3a97cf-e58b-4fad-b2f2-0dcc19fb1627 | NETID |
+--------------------------------------+--------------------------+
sail transform delete 03d5187b-ab96-402c-b5a1-40b74285d77a
Preview transform
Use this command to preview a transform in your environment. The command offers two modes based upon the input:
-
Interactive Mode: Walk through the process interactively, providing the identity profile and identity as inputs dynamically.
-
Direct Mode: Specify the identity profile and identity upfront for a quicker preview.
Both modes display the transform result along with the associated identity attributes in a table format, giving you a clear overview of the applied transformation.
This command temporarily creates and deletes a transform in your environment to generate the preview.
Below is an example of Interactive Mode, where you'll provide inputs dynamically:
Alternatively, you can directly specify the identity profile and identity using the following command:
sail transform preview --profile 8b9960eebbdd43029393edd9dcf25976 --identity 1d2d747380634a38a48f079422833ed6 --file transform_files/DeriveFirstInitialLastNameInUpper.json
You can also include a flag --result-only
or -r
to return only the transform result, which is useful for creating tests or automating validation workflows.