All pages
Powered by GitBook
1 of 1

Loading...

DUKPT Key Mapping

Terms and Definitions

  • DUKPT – Derived Unique Key Per Transaction

  • OID – Object Identifier

  • SRED - Secure Reading and Exchange of Data

There are 7 OIDs defined for these 7 SRED Data IDs.

Each OID value contains a two-byte DUKPT slot ID and a one-byte transformation ID.

DUKPT Slot IDs

The existing TR31 Module supports 32 MagTek DUKPT Slot IDs, from 0x2000 to 0x201F.

The Key Injection Software Tool shall inject DUKPT keys through these DUKPT Slot IDs.

Transformation IDs

This is the list of DUKPT transformations defined in both the Legacy and AES specifications.

During TR31 Key Injection, each DUKPT Slot ID contains a parameter indicates the purpose of a Key Set.

  • Example 1: The restriction value is 0x3F

    • This Key Set can be used for all purposes.

  • Example 2: The restriction value is 0x3E

SRED Data ID map configuration values (Slot ID and Transformation ID) must be checked and rejected if they don’t meet the following conditions.

  • The DUKPT Slot ID must be loaded. (Table - Settings of Injected DUKPT Slot IDs)

  • The loaded DUKPT Slot ID must allows this type of SRED Data ID. (Table - The Definition of Restriction Bitmap).

  • The transformation must be allowed by Table - Allowed Key Mapping Table.

Here is the list of parameters of 4 DUKPT Slot IDs based on the existing Key Injection Tool.

If the Transformation ID of the latest key mapping request is different, then the original OID setting of the other SRED Data ID will be forced to match the latest OID setting. For example, SRED Data ID 2 has been mapped to 0x2007 0x04, user wants to map SRED Data ID 4 to 0x2007 0x05, then the OID setting of SRED Data ID 2 will be forced to 0x2007 0x05.

The following OID Values indicate that:

  • 200701: Map PIN-TDES to DKPTM7-2007 PIN Encryption Variant.

  • 20020B: Map Account Data to DKPTM2-2002 Data Encryption Usage.

  • 200702: Map MAC to DKPTM7-2007 MAC Generate/Verify Variant.

Figure 1 - Configuration Usage Values

2: Account Data

0x010102040102

3

3: MAC

0x010102040103

3

4: Magneprint (supported on devices with MSR Only)

0x010102040104

3

5: MagTek Token

0x010102040105

3

6: User Data 1

0x010102040106

3

7: PIN-AES (supported on PED devices Only)

0x010102040107

3

PIN Encryption

Legacy

00 00 00 00 00 00 00 FF

2

MAC Generate/Verify

Legacy

00 00 00 00 00 00 FF 00

3

MAC Verify

Legacy

00 00 00 00 FF 00 00 00

4

Data Enc/Decryption

Legacy

00 00 00 00 00 FF 00 00

5

Data Encryption

Legacy

00 00 00 FF 00 00 00 00

6

Reserved

7

PIN Encryption

AES

0x1000

8

MAC Generate

AES

0x2000

9

MAC Verify

AES

0x2001

A

MAC Generate/Verify

AES

0x2002

B

Data Encryption

AES

0x3000

C

Data Decryption

AES

0x3001

D

Data Enc/Decryption

AES

0x3002

Magneprint

MAC

Account Data

PIN

This Key Set can be used for all purposes, except PIN Encryption.
  • Example 3: The restriction value is 0x01

    • This Key Set can be used for PIN Encryption only.

  • DKPTM3-2003

    AES-256

    0x3F

    DKPTM7-2007

    TDES

    0x3F

    PIN-TDES (supported on PED devices Only)

    01

    Not allowed

    2

    Account Data

    01, 04, 05

    0B, 0D

    3

    Transaction MAC

    02

    08, 0A

    4

    MagnePrint (supported on devices with MSR Only)

    01, 04, 05

    0B, 0D

    5

    MagTek Token (RFU)

    RFU

    RFU

    6

    User Data #1 (RFU)

    RFU

    RFU

    7

    PIN-AES (supported on PED devices Only)

    Not allowed

    07

    …

    RFU

    -

    -

    20030B: Map MangePrint to DKPTM3-2003 Data Encryption Usage.
  • 000004: MagTek Token is RFU, 0000 ID does not exist (this is default value).

  • 000004: User Data is RFU, 0000 ID does not exist (this is default value).

  • 200207: Map PIN-AES to DKPTM2-2002 PIN Encryption Usage.

  • SRED Data ID

    OID

    OID Size

    0: Not assigned

    N/A

    N/A

    1: PIN-TDES (supported on PED devices Only)

    0x010102040101

    Transformation

    ID #

    Usage Name

    Type

    Data for calculation

    0

    Reserved

    Bit #

    5

    4

    3

    2

    1

    0

    Data Type

    User Data

    (RFU)

    DUKPT Slot ID

    Key Type

    Restrictions

    DKPTM0-2000

    TDES

    0x3E

    DKPTM2-2002

    AES-128

    SRED

    Data ID

    Data Type

    (Working Key Purpose)

    Allowed Legacy

    DUKPT

    Transforms

    Allowed AES

    DUKPT

    Transforms

    0

    Not assigned

    -

    -

    SRED Data IDs and OIDs

    Restrictions of a DUKPT Slot ID

    Transformation IDs for DUKPT Legacy and AES

    The Definition of Restriction Bitmap

    The Rules of Key Mapping

    The settings of DUKPT Slot IDs injected through TR31

    Settings of Injected DUKPT Slot IDs

    Allowed Key Mapping Table

    Note: If SRED Data ID 2 and 4 are mapped to the same Key Set, then they must have the same Transformation ID.

    Examples of Key Mapping

    3

    1

    Token

    (RFU)

    0x3F

    1