Prerequisites¶

The following steps are required before running most CLI workflows. Complete these once, then proceed to the specific workflow guide.

1. Install Idsec CLI¶

Install the CLI with Homebrew:

brew tap cyberark/tools
brew trust cyberark/tools
brew install idsec

macOS / Linux

# Requires Go 1.25+
go install github.com/cyberark/idsec-cli-golang/cmd/idsec@latest

Make sure that the PATH environment variable points to the Go binary. For example:

export PATH=$PATH:$(go env GOPATH)/bin

Windows (PowerShell)

# Requires Go 1.25+ and Git for Windows 2.24+ on PATH
go install github.com/cyberark/idsec-cli-golang/cmd/idsec@latest

The Go installer adds its own bin directory to PATH but not the one go install writes to, so add that as well:

$env:Path += ";$(go env GOPATH)\bin"

This lasts for the current session only. To keep it, add the same directory to PATH under System Properties > Environment Variables.

Silently:

idsec configure --silent --work-with-isp --isp-username myuser

idsec login --silent --isp-secret <my-idsec-secret>