Required commands

The required commands for CSNBT31X.

The TR31 Translate verb requires the following commands to be enabled in the active role:

Required commands for the TR31 Translate verb

Rule-array keyword Offset Command
TR-31 key block protection method
VARXOR-A X'014D' T31X - Permit version A TR-31 key blocks
VARDRV-B X'014E' T31X - Permit version B TR-31 key blocks
VARXOR-C X'014F' T31X - Permit version C TR-31 key blocks
VARDRV-D X'0382' T31X - Permit Version D TR-31 Key Blocks
INCL-CV X'0158' T31X - Permit any CCA key if INCL-CV is specified
When providing the INCL-CV keyword:
  • If this command is enabled in the active role, the key-type specific commands are not checked.
  • If this command is not enabled in the active role, the key-type specific commands are required.
ATTR-CV N/A
Note: No commands relating to specific CCA to TR-31 transitions are checked when this keyword is specified. Only the general access control commands related to export are checked.

Be aware of the interaction of access-control point X'0158' (T31X - Permit any CCA key if INCL-CV is specified) with the INCL-CV keyword. Without the INCL-CV keyword, most export translations are guarded by key-type-specific access control points, to guard the source CCA system against attacks involving re-import of the exported key under ambiguous circumstances. When the control vector is exported along with the key as an optional block securely bound to the encrypted key, the source system is somewhat protected because the key on import is allowed to have only the form of the included control vector. No expansion of capability is allowed. If access-control point X'0158' is enabled in the active role, the key-type-specific access control points are not checked when INCL-CV is provided. If ACP X'0158' is not enabled, the type-specific access control points are still required. Figure 1 illustrates this concept:

Figure 1. Interaction of access-control point X'0158' with keyword INCL-CV
Interaction of access-control point X'0158' with keyword INCL-CV

Be aware of access control point X'01B0' (T31X - Permit DES PINGEN to V0:N and DES PINVER to V1/V2:N) for export of PINGEN or PINVER keys to TR-31 key blocks, key usage V0, V1, or V2, and mode N. TR-31 key blocks may use the same mode N for PINGEN as well as PINVER keys. Enabling a PINGEN and PINVER access-control point while enabling offset X'01B0' (for keyword ANY, mode N) is NOT recommended. Failure to comply with this recommendation allows changing PINVER keys into PINGEN and the other way around.

In addition to the above commands, the verb requires these additional commands to be enabled in the active role depending on the TR-31 key usage rule-array keyword provided and additional information as shown in the table referenced in the rightmost column:
Table 1. Valid CCA to TR31 Translate translations and required access controls

Additional required commands for the TR31 Translate verb.

TR-31 key usage keyword Offset Command Specific key type and control vector attributes
"B0": TR-31 BDK base derivation keys
BDK X'0180' T31X - Permit DES KEYGENKY: DUKPT to B0:N/X See Table 8.
X’01CF’ T31X - Permit AES DKYGENKY:DUKPT BDK to B0:X See Table 8.
"B1": TR-31 Initial DUKPT keys
DUKPT X'03DF' T31X - Permit DES KEYGENKY:DUKPT, AES DKYGENKY:DUKPT to B1 See Table 8.
"B3": TR-31 KDK key derivation keys
KDK X'03E0' T31X - Permit DES DKYGENKY, AES KDKGENKY to B3 See Table 8.
"C0": TR-31 CVK card verification keys
CVK X'0181' T31X - Permit DES MAC/MACVER:AMEX-CSC to C0:G/C/V See Table 9.
X'0182' T31X - Permit DES MAC/MACVER: CVV-KEYA to C0:G/C/V
X'0183' T31X - Permit DES MAC/MACVER:ANY-MAC to C0:G/C/V
X'0184' T31X - Permit DES DATA to C0:G/C/V
"D0": TR-31 data encryption keys
ENC X'0185' T31X - Permit DES ENCIPHER/DECIPHER/CIPHER to D0:E/D/B See Table 10.
X'0186' T31X - Permit DES DATA to D0:E/D/B
"D3": TR-31 data encryption keys for sensitive data
ENCSENS X’03E1’ T31X - Permit CIPHER:XLATE to D3 Table 10
"E0", "E1", "E2", "E3", "E4", and "E5": TR-31 EMC/chip issuer master-key keys
EMVACMK X'0199' T31X - Permit DES DKYGENKY:DKYL0 + DMAC to E0:N/X See Table 9.
X'019A' T31X - Permit DES DKYGENKY:DKYL0 + DMV to E0:N/X
X'019B' T31X - Permit DES DKYGENKY:DKYL0 + DALL to E0:N/X
X'019C' T31X - Permit DES DKYGENKY:DKYL1 + DMAC to E0:N/X
X'019D' T31X - Permit DES DKYGENKY:DKYL1+DMV to E0:N/X
X'019E' T31X - Permit DES DKYGENKY:DKYL1+DALL to E0:N/X
EMVSCMK X'019F' T31X - Permit DES DKYGENKY:DKYL0+DDATA to E1:N/X See Table 9.
X'01A0' T31X - Permit DES DKYGENKY:DKYL0+DMPIN to E1:N/X
X'01A1' T31X - Permit DES DKYGENKY:DKYL0+DALL to E1:N/X
X'01A2' T31X - Permit DES DKYGENKY:DKYL1+DDATA to E1:N/X
X'01A3' T31X - Permit DES DKYGENKY:DKYL1+DMPIN to E1:N/X
X'01A4' T31X - Permit DES DKYGENKY:DKYL1+DALL to E1:N/X
EMVSIMK X'01A5' T31X - Permit DES DKYGENKY:DKYL0+DMAC to E2:N/X See Table 9.
X'01A6' T31X - Permit DES DKYGENKY:DKYL0+DALL to E2:N/X
X'01A7' T31X - Permit DES DKYGENKY:DKYL1+DMAC to E2:N/X
X'01A8' T31X - Permit DES DKYGENKY:DKYL1+DALL to E2:N/X
EMVDAMK X'01A9' T31X - Permit DES DATA/MAC/CIPHER/ENCIPHER to E3:N/G/E/X See Table 9.
EMVDNMK X'01AA' T31X - Permit DES DKYGENKY:DKYL0+DDATA to E4:N/X Table 9
X'01AB' T31X - Permit DES DKYGENKY:DKYL0+DALL to E4:N/X
EMVCPMK X'01AC' T31X - Permit DES DKYGENKY:DKYL0+DEXP to E5:N/X See Table 9.
X'01AD' T31X - Permit DES DKYGENKY:DKYL0+DMAC to E5:N/X
X'01AE' T31X - Permit DES DKYGENKY:DKYL0+DDATA to E5:N/X
X'01AF' T31X - Permit DES DKYGENKY:DKYL0+DALL to E5:N/X
"F0", "F1", "F2", "F3", and "F4": TR-31 EMV/chip issuer master keys
EMVAC-F X'03E4' T31X - Permit DES DKYGENKY:DKYL0+DMAC to F0:X Table 9
X'03E5' T31X - Permit DES DKYGENKY:DKYL0+DMV to F0:X
X'03E6' T31X - Permit DES DKYGENKY: DKYL0+DALL to F0:X
X'03FD' T31X - Permit AES DKYGENKY:D-ALL/DMAC to F0:X Table 6
EMVSC-F X'’03F5' T31X - Permit DES DKYGENKY:DKYL0+DDATA to F1:X Table 9
X'03F6' T31X - Permit DES DKYGENKY:DKYL0+DMPIN to F1:X
X'03F7' T31X - Permit DES DKYGENKY:DKYL0+DALL to F1:X
X'03FE' T31X - Permit AES DKYGENKY:DALL/DCIPHER to F1:X Table 6
EMVSI-F X'’03F8' T31X - Permit DES DKYGENKY:DKYL0+DMAC to F2:X Table 9
X'03F9' T31X - Permit DES DKYGENKY:DKYL0+DALL to F2:X
X'03FF' T31X - Permit AES DKYGENKY:D-ALL/DMAC to F2:X Table 6
EMVDA-F X'’03FA' T31X - Permit DES DATA/MAC/CIPHER/ENCIPHER to F3:N/G/E/X Table 9
X'0500' T31X - Permit AES CIPHER, DKYGENKY:DALL/DCIPHER to F3:E/B/X Table 6
EMVDN-F X'’03FB' T31X - Permit DES DKYGENKY:DKYL0+DDATA to F4:X Table 9
X'03FC' T31X - Permit DES DKYGENKY:DKYL0+DALL to F4:X
X'0501' T31X - Permit AES DKYGENKY:DALL/DCIPHER to F4:X Table 6
"K0" and "K1": TR-31 key encryption or wrapping, or key block protection keys
KEK X'0187' T31X - Permit DES EXPORTER/OKEYXLAT to K0:E See Table 11.
X'0188' T31X - Permit DES IMPORTER/IKEYXLAT to K0:D
X'02AD' T31X Permit EXPORTER to K0/K1:B
X'02AE' T31X Permit IMPORTER to K0/K1:B
X'03E3' T31X - Permit SECMSG:SMKEY to K0
KEK-WRAP X'0189'
X'018A'
"M0", "M1", "M3", and "M6": TR-31 ISO MAC algorithm keys
ISOMAC0 X'018B' T31X - Permit DES MAC/DATA/DATAM to M0:G/C See Table 14.
X'018C' T31X - Permit DES MACVER/DATAMV to M0:V
ISOMAC1 X'018D' T31X - Permit DES MAC/DATA/DATAM to M1:G/C
X'018E' T31X - Permit DES MACVER/DATAMV to M1:V
ISOMAC3 X'018F' T31X - Permit DES MAC/DATA/DATAM to M3:G/C
X'0190' T31X - Permit DES MACVER/DATAMV to M3:V
ISOMAC6 X'03E7' T31X - Permit DES MAC to M6 Table 9
"M7": TR-31 HMAC keys
HMAC X'020D' T31X - Permit HMAC MAC to M7:G/V/C See Table 13.
"P0", "V0", "V1": TR-31 PIN encryption or PIN verification keys
PINENC X'0191' T31X - Permit DES OPINENC to P0:E See Table 16.
X'0192' T31X - Permit DES IPINENC to P0:D
X'01D2' T31X - Permit AES PINPROT to P0:E/D
X'039E' T31X - Permit DES DKYGENKY:DKYL1+DALL to E0:N/X
X'03E2' T31X - Permit SECMSG:SMPIN to P0
X'050A' T31X – Permit AES PINPROT to P0:B
PINVO X'0193' T31X - Permit DES PINVER:NO-SPEC to V0
X'0194' T31X - Permit DES PINGEN:NO-SPEC to V0
X'01B0' T31X - Permit DES PINGEN to V0:N and DES PINVER to V1/V2:N
PINV3624 X'0195' T31X - Permit DES PINVER:NO-SPEC/IBM-PIN/IBM-PINO to V1
X'0196' T31X - Permit DES PINGEN:NO-SPEC/IBM-PIN/IBM-PINO to V1
X'01B0' T31X - Permit DES PINGEN to V0:N and DES PINVER to V1/V2:N
VISAPVV X'0197' T31X - Permit DES PINVER:NO-SPEC/VISA-PVV to V2
X'0198' T31X - Permit DES PINGEN:NO-SPEC/VISA-PVV to V2
X'01B0' T31X - Permit DES PINGEN to V0:N and DES PINVER to V1/V2:N