Skip to main content

Getting Started

SailPoint Identity Security Cloud integration project using the SailPoint CLI and SDKs (Python, TypeScript, Go, PowerShell).

Quick Setup​

Install prerequisites first, then run the setup script:

# 1. Install prerequisites (Git, Python, Node, Go, Wrangler, Just)
./install_prereqs.sh

# 2. Install all SDKs and CLI
./setup.sh

# Non-interactive (skip credential prompts)
./setup.sh --non-interactive

# Windows PowerShell
.\setup.ps1

Or use the task runner:

just prereqs
just setup

The setup script will:

  1. Install the SailPoint CLI (via Homebrew on macOS)
  2. Create a Python virtual environment and install the Python SDK
  3. Install the TypeScript SDK and Connector SDK via npm
  4. Install the Go SDK via Go modules
  5. Install the PowerShell SDK (PSSailpoint modules)
  6. Optionally configure your ISC credentials

Prerequisites​

Install all prerequisites with:

./install_prereqs.sh
# or
just prereqs

This installs:

  • Git
  • Python 3.9+
  • Node.js 18+ and npm
  • Go 1.21+
  • PowerShell 7+ (may require sudo on macOS — see PowerShell SDK docs)
  • Cloudflare Wrangler
  • Just (task runner)
  • Homebrew (macOS only)

Manual prerequisite install (macOS)​

brew install python@3 node go just
brew install --cask powershell
npm install -g wrangler

Verify Installation​

just verify

This checks that every SDK, the CLI, Wrangler, and Just are installed and reports pass/fail.

Credentials​

You need a Personal Access Token (PAT) from your ISC tenant. Create one at: ISC Admin Console > API > Personal Access Tokens.

Option A: Config file​

cp config.json.example config.json

Edit config.json:

{
  "ClientId": "your-client-id",
  "ClientSecret": "your-client-secret",
  "BaseURL": "https://your-tenant.api.identitynow.com"
}
warning

config.json contains secrets and is excluded via .gitignore. Never commit it.

Option B: Environment variables​

export SAIL_BASE_URL="https://your-tenant.api.identitynow.com"
export SAIL_CLIENT_ID="your-client-id"
export SAIL_CLIENT_SECRET="your-client-secret"