REST API  4.0.0
REST API for SafeNet Network HSMs
POST /api/lunasa/actions/{actionid}

POST /api/lunasa/actions/{actionid}

Performs the specified action.

Reboot: Reboot will restart the appliance, this will cause downtime in the server and the loss of all sessions. If the webServer service is not set to run on boot, the server will not run when the appliance starts back up.

RegenerateCertificate: RegenerateCertificate will generate a new appliance certificate with default arguments unless otherwise specified.


Parameters

actionid

The identifier of the action to be performed

Use: Required

JSON Schema:

   Object
   type: string

address

The address to be assigned to the CN of the certificate. The default of the attribute is the hostname of the appliance. This is used only for RegenerateCertificate.

Use: Optional

JSON Schema:

   Object
   type: string

days

The number of days for the certificate to be valid. The default value of the attribute is 365. This is used only for RegenerateCertificate.

Use: Optional

JSON Schema:

   Object
   type: int

startDate

The date on which this certificate will be valid. The default of the attribute is now. This is used only for RegenerateCertificate.

Use: Optional

JSON Schema:

   Object
   type: date

Responses

204

Success

400

Unexpected error

404

Invalid action.

Example Request

   POST
   https://1.2.3.4:8443/api/lunasa/actions/reboot
   {}

   POST
   https://1.2.3.4:8443/api/lunasa/actions/regenerateCertificate
   {
       "startDate" : "2018-2-30",
       "days" : 300,
       "address" : "123.43.23.1"
   }

Example Result

{}

Notes

Reboot action will create a waiting task.

RegenerateCertificate will require SO authentication when the forceSoLogin flag is enabled. (See GET /api/lunasa)