imscli

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):

1. CLI flags — imscli authorize user --scopes openid
2. Environment variables — IMS_SCOPES=openid imscli authorize user
3. 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.