stcconfig rekeythresholdset

Set the rekey threshold for the symmetric key used to encrypt data on an STC link. The symmetric key is used to encode the number of messages specified by the threshold value, after which it is regenerated and the counter is reset to 0.

The default of 400 million messages would force a rekeying operation once every 24 hours on an HSM under heavy load (processing approximately 5000 messages/second), or once a week for an HSM under light load (processing approximately 700 messages/second).

Syntax

stcconfig rekeythresholdset -slot <slot_ID> -value <threshold>

Argument(s) Shortcut Description
-slot <slot_ID> -s

Specifies the slot containing the partition for which you want to set the rekey threshold.

This argument is available only if you are logged into the HSM's Admin partition.

-value <threshold> -v

An integer that specifies the key life (in millions of encoded messages) for the STC symmetric key.

Enter a value of 0 to disable rekeying.

Range: 0 to 4000 million messages.

Default: 400 million messages.

Example

lunacm:> stcconfig rekeythresholdset -value 600

Successfully changed the rekey threshold for the current slot to 600. (in millions of messages)

Command Result : No Error