Home >

LunaSH Command Reference Guide > LunaSH Commands > stc > stc rekeythreshold set

stc rekeythreshold set

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).

You must be logged in as the HSM SO to use this command.

Syntax

stc rekeythreshold set -partition <partition> -value <key_life>

Parameter Shortcut Description
-partition <partition_name> -p <partition_name> Specifies the name of the partition for which you want to specify the STC rekey threshold.
-value <key_life> -v <key_life>

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

lunash:> stc rekeythreshold set -par mapleleafs -v 200
 
Successfully changed the rekey threshold for partition mapleleafs to 200 million messages.