payShield host commands

Data & MAC

payShield L0 — Generate an HMAC Secret Key

answers with L1

Generate a secret HMAC key. Local generation supports Key Block LMKs and their supported optional headers.

Fields

FieldWhat it holds
Hash identifierFF for a Key Block LMK
HMAC key usage indicatorFF for a Key Block LMK
HMAC key lengthFour decimal digits, in bytes
HMAC key format04 for Key Block LMK, 00 for Variant LMK
Key usage61–65 for SHA-1, SHA-224, SHA-256, SHA-384 or SHA-512
AlgorithmH0 for HMAC
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.

Generate an HMAC Secret Key

0000L0FFFF003204#63H0C00N00

4-char headercommand21 bytes of fields
Send L0 to the simulator

Opens the simulator with this command already filled in.

Data & MAC