VhlCfg / File / LegicKeyList Value

This is a list of keys required for accessing LEGIC data segments that are encrypted with a user-defined key.

The keys are transferred into the persistent key storage of the LEGIC SM on the first reboot after configuration has been loaded. The configuration value is deleted afterward.

The encryption keys are used by LegicUserKeyIndexList.

Properties

Format

Name Type/Size Description
- Array (until end of frame) -
KeyIndex Integer (8 bits) This byte defines the index in the key storage of the LEGIC SM the key should be stored to (0x00...0x7F).
KeyType Enumeration (8 bits) This byte defines the crypto algorithm that shall be used when working with the key.
Values (5):
  • DES (0x01)
    Key length: 8 bytes
  • TripleDES (0x02)
    Key length: 16 bytes
  • ThreeKeyTripleDES (0x03)
    Key length: 24 bytes
  • AES128 (0x04)
    Key length: 16 bytes
  • AES256 (0x05)
    Key length: 32 bytes
RFU Raw data (length 1 Byte) Fixed value 0x00
Optional field, condition: KeyType == KeyType.DES
DesKey Raw data (length 8 Bytes) This is the key that shall be used for DES encryption.
Optional field, condition: KeyType == KeyType.TripleDES
TripleDesKey Raw data (length 16 Bytes) This is the key that shall be used for 3DES encryption.
Optional field, condition: KeyType == KeyType.ThreeKeyTripleDES
ThreeKeyTripleDESKey Raw data (length 24 Bytes) This is the key that shall be used for 3K3DES encryption.
Optional field, condition: KeyType == KeyType.AES128
Aes128Key Raw data (length 16 Bytes) This is the key that shall be used for AES-128 encryption.
Optional field, condition: KeyType == KeyType.AES256
AES256Key Raw data (length 32 Bytes) This is the key that shall be used for AES-256 encryption.