imscli

command module

v0.16.0 Latest Latest Go to latest Published: Apr 17, 2026 License: Apache-2.0 Imports: 3 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/adobe/imscli

Links

Open Source Insights

README ¶

imscli

Go Version

A CLI tool to troubleshoot and automate Adobe IMS integrations.

Installation

Prebuilt binaries

Download the latest release for your platform from the releases page.

From source

go install github.com/adobe/imscli@latest

Quick Start

# Authorize as a user (launches browser for OAuth2 flow)
imscli authorize user --clientID <client-id> --clientSecret <secret> --organization <org> --scopes openid

# Validate a token
imscli validate accessToken --clientID <client-id> --accessToken <token>

# Decode a JWT locally (no API call)
imscli decode --token <jwt>

Commands

Command	Description
`authorize user`	OAuth2 Authorization Code Grant Flow (launches browser)
`authorize pkce`	Authorization Code Grant Flow with PKCE (mandatory for public clients, optional for private)
`authorize service`	Service authorization (client credentials + service token)
`authorize jwt`	JWT Bearer Flow (signed JWT exchanged for access token)
`authorize client`	Client Credentials Grant Flow
`validate`	Validate a token using the IMS API
`invalidate`	Invalidate a token using the IMS API
`decode`	Decode a JWT token locally
`refresh`	Refresh an access token
`exchange`	Cluster access token exchange across IMS Orgs
`profile`	Retrieve user profile
`organizations`	List user organizations
`admin`	Admin operations (profile, organizations) via service token
`dcr`	Dynamic Client Registration

See DOCUMENTATION.md for full details on each command.

Global Flags

These flags apply to all commands:

Flag	Short	Default	Description
`--url`	`-U`	`https://ims-na1.adobelogin.com`	IMS endpoint URL
`--proxyUrl`	`-P`		HTTP(S) proxy (`http(s)://host:port`)
`--proxyIgnoreTLS`	`-T`	`false`	Skip TLS verification (proxy only)
`--configFile`	`-f`		Configuration file path
`--timeout`		`30`	HTTP client timeout in seconds
`--verbose`	`-v`	`false`	Verbose output

Configuration

Parameters can be provided from three sources (highest to lowest priority):

CLI flags — imscli authorize user --scopes openid
Environment variables — IMS_SCOPES=openid imscli authorize user
Configuration file — ~/.config/imscli.yaml or specified with -f

See DOCUMENTATION.md for configuration file format and examples.

Contributing

Contributions are welcomed! Read the Contributing Guide for more information.

Licensing

This project is licensed under the Apache V2 License. See LICENSE for more information.

Documentation ¶

There is no documentation for this package.

Source Files ¶

View all Source files

main.go

Directories ¶

Path	Synopsis
cmd Package cmd defines the Cobra command tree for the imscli CLI.	Package cmd defines the Cobra command tree for the imscli CLI.
admin Package admin implements the admin subcommands (profile, organizations).	Package admin implements the admin subcommands (profile, organizations).
authz Package authz implements the authorize subcommands (user, pkce, service, jwt, client).	Package authz implements the authorize subcommands (user, pkce, service, jwt, client).
invalidate Package invalidate implements the invalidate subcommands for token invalidation.	Package invalidate implements the invalidate subcommands for token invalidation.
prettify Package prettify provides output formatting helpers for the CLI.	Package prettify provides output formatting helpers for the CLI.
validate Package validate implements the validate subcommands for token validation.	Package validate implements the validate subcommands for token validation.
ims Package ims implements the core business logic for interacting with the Adobe Identity Management System (IMS) API.	Package ims implements the core business logic for interacting with the Adobe Identity Management System (IMS) API.

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL