CAUTION: The SailPoint CLI is currently in pre-production and undergoing heavy development. Until the CLI reaches version 1.0.0, breaking changes may be introduced at any time while we work on refining the CLI.

SailPoint CLI - README

About The Project

The SailPoint Command Line Interface (CLI) makes it easy to interact with SailPoint's SaaS Platform in a programmatic way. Many functions that use to be accomplished through tools like Postman or from custom scripts can now be done directly on the command line with minimal setup.

Please use GitHub issues to submit bugs or make feature requests.

If you'd like to contribute directly (which we encourage!) please read the contribution guidelines below, first!

Contents

• Getting Started
  • Prerequisites
  • MacOS and Linux
  • Windows
• Configuration
  • Assisted Configuration
  • Manual Configuration
  • Environment Variable Configuration
• Usage
• Discuss
• License
• Contributing
• Code of Conduct

Getting Started

If you are looking to use the SailPoint CLI, please use the Releases section. If you want to build this project locally, follow the steps below.

Prerequisites

• Golang version 1.17 or above.

MacOS and Linux

Open your terminal app, navigate to the project directory, and run the following command:

make install

After that, make sure you can run the sail command.

sail

Windows

Open PowerShell as administrator, navigate to the project directory, and run the following command.

go build -o "C:\Program Files\sailpoint\sail.exe"

After that, add the following directory to the system PATH parameter. You can find instructions on how to do this from this article. This will only need to be done the first time you install the CLI.

C:\Program Files\sailpoint

After setting your environment variable, close all instances of your PowerShell or Command Prompt, open a new instance, and make sure you can run the sail command.

sail

Configuration

Before you begin, you will need to gather the following information.

• Create a personal access token, which will be used to authenticate the SailPoint CLI to your IdentityNow tenant. Take note of the Client ID and the Client Secret.
• Find your org/tenant name.

Assisted configuration

Run the configure command to configure the CLI for your tenant. This command will create a configuration file in your home directory to store your tenant's connection details.

sail configure

Manual configuration

Alternatively, you can manually create a configuration file in your home directory.

On Linux/Mac, run:

mkdir ~/.sailpoint
touch ~/.sailpoint/config.yaml

On Windows PowerShell, run:

New-Item -ItemType Directory -Path 'C:\Users\<username>\.sailpoint'
New-Item -ItemType File -Path 'C:\Users\<username>\.sailpoint\config.yaml'

The config.yaml file should contain the following information.

baseURL: https://{org}.api.identitynow.com # or baseURL: https://localhost:7100
tokenURL: https://{org}.api.identitynow.com/oauth/token
clientSecret: { clientSecret }
clientID: { clientID }
debug: false # Set to true for additional output

Environment variable configuration

You may also specify environment variables for your configuration. This can useful when using the CLI in an automated environment, like a CI/CD pipeline, where consuming the configuration from environment variables would be easier than creating the config file. Environment variables take precedent over values defined in a config file.

On Linux/Mac, export the following environment variables:

export SAIL_BASEURL=https://{org}.api.identitynow.com
export SAIL_TOKENURL=https://{org}.api.identitynow.com/oauth/token
export SAIL_CLIENTID={clientID}
export SAIL_CLIENTSECRET={clientSecret}
export SAIL_DEBUG=false

If you want your environment variables to persist across terminal sessions, you will need to add these exports to your shell profile, like ~/.bash_profile.

On Windows PowerShell run:

$env:SAIL_BASEURL = 'https://{org}.api.identitynow.com'
$env:SAIL_TOKENURL = 'https://{org}.api.identitynow.com/oauth/token'
$env:SAIL_CLIENTID = '{clientID}'
$env:SAIL_CLIENTSECRET = '{clientSecret}'
$env:SAIL_DEBUG = 'false'

If you want your environment variables to persist across PowerShell sessions, then use the following command instead:

[System.Environment]::SetEnvironmentVariable('SAIL_BASEURL','https://{org}.api.identitynow.com')

Usage

Run the sail command for an overview of the available commands and flags. You can use the -h flag with any available command to see additional options available for each command. You can find more information about each command below.

• connectors
• transforms

Discuss

Click Here to discuss this tool with other users.

License

Distributed under the MIT License. See the license for more information.

Contributing

Before you contribute you must sign our CLA. Please also read our contribution guidelines for all the details on contributing.

Code of Conduct

We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community. Read our code of conduct to learn more.

(back to top)