REST API  5.0.0
REST API for SafeNet Network HSMs
PUT /api/lunasa/webServer

PUT /api/lunasa/webServer

Sets the configuration of the web server providing the REST API.

Parameters

cipherList

cipherList is the cipher suite the REST API service is to accept for applications requesting connection to the web server. cipherList is a sub-set of the ciphers known to the REST API service.

Use: Required

JSON Schema:

   Object
   type: string

netDevice

netDevice is the interface to which the REST API service is bound. Valid interfaces for SA7 are: eth0, eth1, eth2, eth3, all, all_ipv4, bond0 and bond1. ("all" includes all ipv6 and ipv4 addresses.) Valid interfaces for SA6 are: eth0, eth1, all, bond0. ("all" includes all ipv4 addresses.)

Use: Required

JSON Schema:

   Object
   type: string

port

port is the logical end-point number reserved for the REST API service. The port must be within the range: 80 to 65535.

Use: Required

JSON Schema:

   Object
   type: integer

threads

threads is the number of simultaneous connections the REST API service supports. A small number of threads implies restricted administrative access to the appliance.

Use: Required

JSON Schema:

   Object
   type: integer

corsOrigins

corsOrigins is the list that determines the Access-Control-Allow-Origin header of responses.

Use: Required

JSON Schema:

   Object
   type: array
       corsOrigins: Object
                      type: string

Responses

204

Success

400

Unexpected error

Example Request

   PUT 
   https://1.2.3.4:8443/api/lunasa/webServer
   { 
      "cipherList" : "ECDHE-RSA-AES256-GCM-SHA384,ECDHE-ECDSA-AES256-GCM-SHA384,ECDHE-RSA-AES256-SHA384,ECDHE-ECDSA-AES256-SHA384,DHE-RSA-AES256-GCM-SHA384,DHE-RSA-AES256-SHA256,ECDH-RSA-AES256-GCM-SHA384,ECDH-ECDSA-AES256-GCM-SHA384,ECDH-RSA-AES256-SHA384,ECDH-ECDSA-AES256-SHA384,AES256-GCM-SHA384,AES256-SHA256,ECDHE-RSA-AES128-GCM-SHA256,ECDHE-ECDSA-AES128-GCM-SHA256,ECDHE-RSA-AES128-SHA256,ECDHE-ECDSA-AES128-SHA256,DHE-RSA-AES128-GCM-SHA256,DHE-RSA-AES128-SHA256,ECDH-RSA-AES128-GCM-SHA256,ECDH-ECDSA-AES128-GCM-SHA256,ECDH-RSA-AES128-SHA256,ECDH-ECDSA-AES128-SHA256,AES128-GCM-SHA256,AES128-SHA256",
      "netDevice" : "eth1",
      "port" : 8443,
      "threads" : 5,
      "corsOrigins" :["*"]
   }

Example Result

{
}