app key access
The OLP CLI supports the following functionality for application access key management:
app key access list
Retrieves access keys of an application.
olp app key access list <app HRN> [command options]
Required parameters:
-
<app HRN>
The HRN of the application.
Optional parameters:
-
--enabled <true|false>
If set to true
, filters by enabled access keys. If not specified all keys are returned. -
--credentials <path to credentials file>
The name of a credentials file to use with the command. Credentials files are downloaded separately from the HERE platform portal. -
--profile <profile name>
The name of the credentials profile to use from the olpcli.ini
file. -
--json
Displays the command result in JSON format. -
--quiet
Displays a list of keys with no additional information.
For more information on using credentials and profiles, see Credentials setup.
Example:
The command below lists access keys of the application:
olp app key access list hrn:here:account::org:app/my-app-1234 --json
Output:
{"keys": [
{
"accessKeyId": "my-access-key-1234",
"clientId": "my-client-1234",
"accessKeyHrn": "hrn:here:account::org:accesskey/my-access-key-1234",
"clientHrn": "hrn:here:account::org:app/my-client-1234",
"createdTime": 1592482089625,
"enabled": true
}
]}
app key access create
Creates an access key for an application.
olp app key access create <app HRN> [command options]
Required parameters:
-
<app HRN>
The HRN of the application.
Optional parameters:
-
--credentials <path to credentials file>
The name of a credentials file to use with the command. Credentials files are downloaded separately from the HERE platform portal. -
--profile <profile name>
The name of the credentials profile to use from the olpcli.ini
file. -
--json
Displays the command result in JSON format. -
--quiet
Displays only the access key ID and the access key secret.
For more information on using credentials and profiles, see Credentials setup.
Example:
The command below creates an application access key:
olp app key access create hrn:here:account::org:app/my-app-1234
Output:
here.user.id = my-user-1234
here.client.id = my-client-1234
here.access.key.id = my-access-key-1234
here.access.key.secret = my-access-secret-1234
here.token.endpoint.url = https://account.api.here.com/oauth2/token
app key access delete
Deletes an access key for an application.
olp app key access delete <app HRN> <access key HRN> [command options]
Note
Processes associated with an app such as pipelines cease functioning a maximum of 24 hours after you disable or delete this app access key.
Required parameters:
-
<app HRN>
The HRN of the application. -
<access key HRN>
The HRN of the application access key.
Optional parameters:
-
--credentials <path to credentials file>
The name of a credentials file to use with the command. Credentials files are downloaded separately from the HERE platform portal. -
--profile <profile name>
The name of the credentials profile to use from the olpcli.ini
file. -
--quiet
Displays empty output with no additional information.
For more information on using credentials and profiles, see Credentials setup.
Example:
The command below deletes an application access key:
olp app key access delete hrn:here:account::org:app/my-app-1234 hrn:here:account::org:accesskey/my-accesskey-1234
Output:
Access key hrn:here:account::org:accesskey/my-accesskey-1234 has been deleted
app key access enable
Enables an access key of an application.
olp app key access enable <app HRN> <access key HRN> [command options]
Required parameters:
-
<app HRN>
The HRN of the application. -
<access key HRN>
The HRN of the application access key.
Optional parameters:
-
--credentials <path to credentials file>
The name of a credentials file to use with the command. Credentials files are downloaded separately from the HERE platform portal. -
--profile <profile name>
The name of the credentials profile to use from the olpcli.ini
file. -
--quiet
Displays empty output with no additional information.
For more information on using credentials and profiles, see Credentials setup.
Example:
The command below enables an application access key:
olp app key access enable hrn:here:account::org:app/my-app-1234 hrn:here:account::org:accesskey/my-accesskey-1234
Output:
Access key hrn:here:account::org:accesskey/my-accesskey-1234 has been enabled
app key access disable
Disables an access key of an application.
olp app key access disable <app HRN> <access key HRN> [command options]
Note
Processes associated with an app such as pipelines cease functioning a maximum of 24 hours after you disable or delete this app access key.
Required parameters:
-
<app HRN>
The HRN of the application. -
<access key HRN>
The HRN of the application access key.
Optional parameters:
-
--credentials <path to credentials file>
The name of a credentials file to use with the command. Credentials files are downloaded separately from the HERE platform portal. -
--profile <profile name>
The name of the credentials profile to use from the olpcli.ini
file. -
--quiet
Displays empty output with no additional information.
For more information on using credentials and profiles, see Credentials setup.
Example:
The command below disables an application access key:
olp app key access disable hrn:here:account::org:app/my-app-1234 hrn:here:account::org:accesskey/my-accesskey-1234
Output:
Access key hrn:here:account::org:accesskey/my-accesskey-1234 has been disabled