Before interacting with the CLI, you must register a corresponding app in AAC. You can use the contents of sample-client.yaml
to import an app quickly.
register
takes the following parameters:
-s scope
(Optional)environment
authorization_provider
client_id
./dhcli register -s offline_access bologna aac.digitalhub-dev.smartcommunitylab.it c_dhcliclientid
It will create a .cli.ini
file in the user's home directory (or, if not possible, in the current one), generating a section with the specified environment name and containing the configuration retrieved from the authorization provider.
use
takes the following parameters:
environment
./dhcli use bologna
It sets the environment to use when none is specified in the configuration file's default section.
login
is to be used after registering an environment with the register
command. It takes the following parameters:
environment
(Optional)
./dhcli login bologna
It will read the corresponding section from the configuration file and log in to the authorization provider. It will update the section with the access token obtained. If no environment is specified, it will use the one set by the use
command.
refresh
is to be used after the login
command, to update access_token
and refresh_token
. It takes the following parameters:
environment
(Optional)
./dhcli refresh bologna
If no environment is specified, it will use the one set by the use
command.
remove
takes the following parameters:
environment
./dhcli remove bologna
It removes the section from the configuration file.
init
takes the following parameters:
core_endpoint
token
./dhcli init <core_endpoint> <token>
It installs the python package through pip, matching core's version.