payShield host commands

Data & MAC

payShield LW — Export an HMAC key

answers with LX

Export a protected HMAC key under a ZMK. Local execution supports block formats 04 and 05 with basic HMAC headers (Core pp.480–482).

Fields

FieldWhat it holds
ZMK under LMKEnter the protected transport key including its scheme, if present.
HMAC key format04 for Key Block LMK, 00 for Variant LMK
Transport format00 proprietary, 01 PKCS#11 ECB, 02 PKCS#11 CBC, 03 X9.17, 04 Thales key block, 05 TR-31.
HMAC key under LMKBare key block for format 04, encrypted bytes in hex for format 00
Modified exportabilityLeave empty to inherit. N requests a non-exportable copy.
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.

Export an HMAC key

0000LWS10128K0AB00E000008B38DA03315A7502DD46A8823509AB0372C2E56BB21A86873C7B46D38439DF98EBC9B96E00436D8C9A861B5FBF60BC2B5852375146BDCE60405FFFF1012863HC00S000073BA882EFDBE179FC3D745D38855A3242816F645ACF773EFBAE0EF9AFA6051E4E9631F365EAC24BE0DD22040E16627B5402EAF88CAD1FE15%00

4-char headercommand268 bytes of fields
Send LW to the simulator

Opens the simulator with this command already filled in.

Data & MAC