Add a new SSL key configuration (POST)
The POST command adds a new SSL key configuration to the system. If the key configuration already exists in the system, the system rejects it and returns an error. This command does not handle the key material.
Parameters
Parameter | Description | Example |
---|---|---|
{{code language="none"}} | User name that initiates the request. The specified user must have security-level access. | usr=security |
pwd 1 | Password of the security user that initiates the request. | pwd=ytiruces |
1 This parameter is required.
Sample request
Post content
SSL key configuration XML definition
<description><![CDATA[Key managed by John]]></description>
</keyConfig>
Attributes for XML definition
Attribute | Description | Example |
---|---|---|
name 2 | Name given to the SSL key configuration. | name="01_pfx_des_pas" |
server-ip 2 | IP address or range of IP addresses of the server(s) for which the key applies. Possible input options include:
| server-ip="172.10.1.*"
|
server-port 2 | Port or range of ports of the server for which the key applies. Possible input options include:
| server-port="443" |
description | Description of the key. | [Key managed by John] |
2 This attribute is required.
Sample successful response
<status result="success" />
</response>
Sample unsuccessful response
<status result="failure">
<msg code="xxxx" severity="error">
<![CDATA[Error message]]>
</msg>
</status>
</response>
Related topics
Composing-requests-in-configuration-APIs
SSL-Key-Management-API-error-messages
SSL-Key-Management-API-commands
Configuration-API-error-code-reference