secret_key: Authentication in Plesk XML API¶
To authenticate API requests, you can use secret keys instead of credentials.
This topic describes how to create and manage secret keys using the secret_key
CLI utility.
You can also create and manage secret keys via Plesk XML API.
Note
For security reasons, Plesk does not store secret keys. It stores only their hashes.
Usage¶
secret_key <command> [
<option_1> [<param>]
[<option_2> [<param>]]
]
Example¶
The following command creates a secret key assigned to the IP address 192.0.2.1:
plesk bin secret_key -c -ip-address 192.0.2.1
Note
Once you have created a secret key, copy it and keep it safe.
For security reasons, secret keys are shown only when they are created.
The secret_key
CLI utility will not show them after that.
Commands¶
Command | Parameter | Description | Example |
---|---|---|---|
--create or -c |
Creates a secret key assigning it to the specified IP address (if any) or to the IP address of the request sender. Can be used with the Note Once you have created a secret key, copy it and keep it safe.
For security reasons, secret keys are shown only when they are created.
The |
To create a secret key assigned to the IP address 192.0.2.1 with the description “test key”: plesk bin secret_key --create -ip-address 192.0.2.1 -description "test key"
|
|
--list or -l |
Shows the information about all secret keys located on the server: key IDs, IP addresses the keys are assigned to, and key descriptions (if any). Note For security reasons, the command does not show secret keys themselves. |
To show the information about all secret keys located on the server: plesk bin secret_key --list
|
|
--delete or -d |
-key <secret_key_value | secret_key_ID> |
Deletes the specified secret key. Used with the |
To delete the key plesk bin secret_key --delete -key 53de495a-b405-ca64-35d3-54b0352edeec
To delete the key with the ID 3: plesk bin secret_key --delete -key 3
|
--help or -h |
Displays the help on the utility usage. | To see the help on the utility usage: plesk bin secret_key --help
or plesk bin secret_key -h
|
Options¶
Option | Parameter | Description | Example |
---|---|---|---|
-ip-address |
<IP_address> |
The IP address a secret key is assigned to. Used with the Plesk XML API will deny requests that use the secret key but were sent from other IP addresses. |
To create a secret key assigned to the IP address 192.0.2.1 with the description “test key”: plesk bin secret_key -create -ip-address 192.0.2.1 -description "test key"
|
-description |
<string> |
The secret key description. Used with the --create command. |
To create a secret key assigned to the IP address 192.0.2.1 with the description “test key”: plesk bin secret_key -create -ip-address 192.0.2.1 -description "test key"
|
-key |
<string> |
The secret key value or ID. Used with the --delete command. |
To delete the key plesk bin secret_key --delete -key 53de495a-b405-ca64-35d3-54b0352edeec
To delete the key with the ID 3: plesk bin secret_key --delete -key 3
|