payShield host commands

Data & MAC

payShield LU — Import an HMAC key

answers with LV

Import a ZMK-protected HMAC key under the LMK. Local execution supports inherited attributes for formats 04 and 05 (Core pp.476–479).

Fields

FieldWhat it holds
ZMK under LMKEnter the protected transport key including its scheme, if present.
HMAC key under LMKBare key block for format 04, encrypted bytes in hex for format 00
Transport format00 proprietary, 01 PKCS#11 ECB, 02 PKCS#11 CBC, 03 X9.17, 04 Thales key block, 05 TR-31.
HMAC key format04 for Key Block LMK, 00 for Variant LMK
Hash identifierFF for a Key Block LMK
HMAC key usage indicatorFF for a Key Block LMK
HMAC key lengthFour decimal digits, in bytes
Key usage61–65 for SHA-1, SHA-224, SHA-256, SHA-384 or SHA-512
Mode of useC for generation and verification
Key versionTwo decimal digits
ExportabilityN for non-exportable
Optional blocks00–08 blocks. Example: 010508Ab c carries one four-character text value.
Message trailerOptional · up to 32 printable ASCII characters.

On the wire

The four zeros are the message header. The device echoes them in its response.

Import an HMAC key

0000LUS10128K0AB00E000008B38DA03315A7502DD46A8823509AB0372C2E56BB21A86873C7B46D38439DF9748D4B0AA28B6D9B28099BAB8376BA85056C6AD9D2D6AAB9FFFFRD0160M7HC00S0200HM0621PB0A7A0BF5D0B78860FB4F58A1A2107509D30D850BE5C2BF6415BBC896512ED5BB11835E2D63DD19A690FF6D1DD1655B644B0D2F3B11F1074145E24DD742FD3D3B63E8DA2A0504%00

4-char headercommand301 bytes of fields
Send LU to the simulator

Opens the simulator with this command already filled in.

Data & MAC