Luna EFT Programmer's Guide
Chapter 6
Transfer Functions
Get_Key_Details
Request Content
EE0202
FM
Length
3
1
Attribute
h
h
Key Spec
Var
K-Spec
Key Type
1
d
KVC Type
1
h
Length
3
1
1
Attribute
h
h
h
Var
h
Response Content
EE0202
rc
Parity
KVC
PHW
D
Luna EFT (PHeft/SHP)
D
PSO/PSG
D
PTK-EFT
D
Description
Function Code
Function Modifier = 00
Key specifier for the host stored key
(Formats: 10,11,12,13,
14,15,16,17,18,20,50, 93)
Indicates the KM-variant with which the
key K is encrypted
0x00: Standard
0x01: MDC2 KVC (Only for PPK and MPK)
Description
Function Code
Return Code
For DES/3DES keys, indicates whether the
key has odd, even or mixed parity.
KVC for the host stored key.
This function provides non-sensitive details of a host stored key that is stored in simple KM
encrypted form.
Key Type
For key specifiers that contain an authenticated key Block incorporating the
key type, this field must be set to zero (i.e. for key specifier formats 15, 17 and
18).
For key specifier incorporating encryption counter as zero in KSN (i.e. for key
specifier format 20), the KVC shall be calculated on initial key and key type
shall be ignored.
Otherwise, following keytypes shall be used with format 20 key specifier to
calculate KVC on transaction keys.
00: DPK
01: PPK
02: MPK
For key specifier formats 10, 11, 13, 14, 16 and 50 this field indicates the KMvariant with which the key is encrypted as follows:
00: DPK
01: PPK
02: MPK
03: KIS
04: KIR
05: KTM
06: CSCK
KVC Type
07: KPV,DT
08: KPVV
09: KCVV
10:KI
16: ZKA KGK
17: ZKA KKBLZ
18: ZKA MK
24: BDK
30: IMKAC
31: IMKSMI
32:IMKSMC
33: IMKDAC
34: IMKDN
35: KTK
36: PTK
37: KMC
38: IMK-CVC
40:DK-DPK
44:DK-KIR
41:DK-PPK
42:DK-MPK
43: DK-KIS
Specifies the method used to calculate the KVC. Values supported are :
0x00 for standard method
0x01 for MDC2 Method (This value is only valid when the key passed to the
function is PPK or MPK)
Parity
© SafeNet, Inc.
For DES/3DES keys, this field indicates whether the plain text key has odd, even
68
Luna EFT Programmer's Guide
Chapter 6
Transfer Functions
or mixed parity, as follows:
01: Odd parity. 02: Even parity. 03: Mixed parity
KVC
For DES/3DES keys, the field contains the 3-byte 'standard ' KVC
If the KVC type is 0x01 the MDC2 method for KVC calculation will be used. The
KVC returned will be a 16 byte hexadecimal value.
PTK-EFT
int EFT_EE0202_GetKeyDetails(
IN
UCHAR
FM,
IN
KEYSPEC
*K,
IN
UCHAR
KeyType,
IN
UCHAR
KVCType,
OUT
UCHAR
*Parity,
OUT
EFTBUFFER
*KVC);
© SafeNet, Inc.
69
Luna EFT Programmer's Guide
© SafeNet, Inc.
Chapter 6
Transfer Functions
70