IAM Command-Line Interface CLI
The iam CLI is a command-line tool providing commands used to manage Airlock IAM instances and the IAM configuration.
- Run
iam -h/iam --helpto get general usage and help information. - Run
iam <subcommand> -h/iam <subcommand> --helpto get usage and help for a given subcommand. E.g.,iam config -horiam reset --help.
The code block below shows the entire Help text (which appears after running iam -h):
Example
Usage: iam [-hV]
iam COMMAND [COMMAND-OPTIONS]
Airlock IAM is a comprehensive authentication and identity management solution for web applications and services
Options:
-h, --help Show this help message and exit
-V, --version Print version information and exit
Commands:
run Runs Airlock IAM
init Initializes one or more new instances with a default configuration
upgrade Upgrades an instance or a plugin configuration file to the current IAM version
config Validates, manipulates, or converts the IAM configuration (see subcommand help for details)
reset Reset the plugin configuration file.
sensitive-values Manages sensitive values for an instance
run-task Runs a given Service Container task
info Displays resolved parameters of an instance
status Displays status information about an instance
systemd Creates systemd service files
bash-install Installs bash auto completion and environment for the CLI
build-trust-store Builds a trust store file containing trusted certificates
default-parameters Shows descriptions and default values for all available application parameters (instance.
properties template)
Exit Codes for all subcommands (if not specified otherwise):
0 Action was completed successfully.
1 Action could not be completed due to an error.
Run 'iam COMMAND --help' for more information on a command.Notice
Starting with IAM 8.5, the IAM license and analytics feature is mandatory. If it is not configured, configuration activation will fail. The IAM CLI is used to configure the analytics plugin, during the init, reset, and upgrade operations. When you run any of these operations, you must specify your preferred analytics mode. For more information, see License and usage analytics.
Subcommands
- Following the initial command
iam, you can specify one subcommand. - Subcommands must be added without a dash (
-). For example: - Example
iam init
Further information and links