stc cipher enable

Home >	LunaSH Command Reference Guide > LunaSH Commands > stc > stc cipher enable

stc cipher enable

Enable the use of a symmetric encryption cipher algorithm for data encryption on an STC link. All data transmitted over the STC link will be encrypted using the cipher that is both enabled and that offers the highest level of security. For example, if AES 192 and AES 256 are enabled, and AES 128 is disabled, AES 256 will be used. You can use the command stc cipher show to show which ciphers are currently enabled/disabled.

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

Note: Performance is reduced for larger ciphers.

Syntax

stc cipher enable -partition <partition_name> -all -id <cipher_id>

Parameter	Shortcut	Description
-partition <partition_name>	-p <partition_name>	Specifies the name of the partition for which you want to enable the specified cipher.
-all	-a	Enable all ciphers.
-id <cipher_id>	-id <cipher_id>	Specifies the numerical identifier of the cipher you want to use, as listed using the command stc cipher show.

Example

lunash:>stc cipher show -p mapleleafs

This table lists the ciphers supported for STC links to the partition. Enabled

ciphers are accepted during STC link negotiation with a client. If all ciphers

are disabled, STC links to the partition are not encrypted.

STC Encryption: On

Cipher ID    Cipher Name                              Enabled

_________________________________________________________________

1            AES 128 Bit with Cipher Block Chaining   Yes

2            AES 192 Bit with Cipher Block Chaining   Yes

3            AES 256 Bit with Cipher Block Chaining   No

Command Result : 0 (Success)

lunash:> stc cipher enable -par mapleleafs -id 3

AES 256 Bit with Cipher Block Chaining is now enabled.

lunash:>stc cipher show -p mapleleafs

This table lists the ciphers supported for STC links to the partition. Enabled

ciphers are accepted during STC link negotiation with a client. If all ciphers

are disabled, STC links to the partition are not encrypted.

STC Encryption: On

Cipher ID    Cipher Name                              Enabled

_________________________________________________________________

1            AES 128 Bit with Cipher Block Chaining   Yes

2            AES 192 Bit with Cipher Block Chaining   Yes

3            AES 256 Bit with Cipher Block Chaining   Yes

Command Result : 0 (Success)