EFT

Descripción detallada

Operaciones de transferencia electrónica de fondos.

Consulte la documentación técnica del HSM.

Funciones
Cadena	generateDUKPT (byte[] baKSI, byte[] baDID_CTR, int dwParam) throws TacException
	Genera una clave DUKPT dentro del HSM utilizando un KSI (Key Serial Identification), un DID (Device ID) y un CTR (Transaction Counter) del mismo KSN (Key Serial Number).
Cadena	generateDUKPTName (byte[] baKSI, byte[] baDID_CTR) throws TacException
	Genera el nombre del DUKPT a partir del KSI y el CTR introducidos.
Cadena	generateBDKName (byte[] baKSI) throws TacException
	Genera el nombre BDK a partir de un KSI (Key Serial Identification).
byte[]	translatePINBlock (String srcPEK, String dstPEK, int transBlockType, String PAN, byte[] inPINBlock) throws TacException
	Traduce un bloque PIN, descifrándolo con una clave y cifrándolo con otra.
byte[]	exportTR31 (String kbpk, String key, int usage, byte mode, byte export) throws TacException
	Exporta una clave en formato TR-31 según la norma ASC X9 TR 31-2018.
void	importTR31 (String kbpk, String key, int keyAttributes, byte[] keyBlock) throws TacException
	Importe una clave en formato TR-31 según la norma ASC X9 TR 31-2018.

Funciones

generarDUKPT()

String generateDUKPT	(	byte[]	baKSI,
		byte[]	baDID_CTR,
		int	dwParam ) throws TacException

Genera una clave DUKPT dentro del HSM utilizando un KSI (Key Serial Identification), un DID (Device ID) y un CTR (Transaction Counter) del mismo KSN (Key Serial Number).

Parámetros

baKSI	Buffer de tamaño TacNDJavaLib.MIN_KSI_LEN que contiene el KSI (primeros 05 bytes del KSN).
baDID_CTR	Buffer de tamaño TacNDJavaLib.MIN_CTR_LEN que contiene el DID y el CTR (últimos 05 bytes del KSN).
dwParam	Banderas de funcionamiento según la tabla siguiente. Valor Significado TacNDJavaLib.NEW_DUKPT_MODE_DUK Genera una DUK (Clave Única Derivada) estándar de acuerdo con el manual ISO X9.24-1-2004. TacNDJavaLib.NEW_DUKPT_MODE_PEK Genera una clave PEK (PIN Encryption Key) según el manual ISO X9.24-1-2004 A-1,A-6 aplicando el XOR de la máscara 0000 0000 0000 FF00 a las partes de la clave. TacNDJavaLib.NEW_DUKPT_MODE_MEK Genera una clave MEK (MAC Encryption Key) según el manual ISO X9.24-1-2004 A-1,A-6 aplicando el XOR de la máscara 0000 0000 0000 00FF a las partes de la clave. TacNDJavaLib.NEW_DUKPT_MODE_DE Diversifica la clave generada en formato de Cifrado de Datos. Aplica un XOR de la máscara 0000 0000 00FF 0000 0000 00FF 0000 a la clave DUKPT generada, encripta la clave izquierda del DUKPT utilizando el DUKPT generado y repite la encriptación con la clave derecha. Tras esta operación, une las partes izquierda y derecha cifradas para formar la clave de cifrado de datos. Como se describe en el MANUAL DE USUARIO IDTECH SecureMag Encrypted MagStripe Reader (80096504-001 RevL 06/19/14). Debe utilizarse en combinación (mediante la operación OR) con uno de los indicadores: TacNDJavaLib . NEW_DUKPT_MODE_DUK, TacNDJavaLib.NEW_DUKPT_MODE_PEK o TacNDJavaLib.NEW_DUKPT_MODE_MEK. TacNDJavaLib.NEW_DUKPT_MODE_EXP Genera una clave DUKPT exportable. Se trata de un indicador de atributo y debe utilizarse en combinación con otros indicadores. Utilícela sólo si se requiere específicamente. TacNDJavaLib.NEW_DUKPT_MODE_TMP Genera una clave DUKPT temporal. Se trata de un indicador de atributo y debe utilizarse en combinación con otros indicadores.

Devolución

Devuelve el nombre de la clave DUKPT generada.

Excepciones

TacException

generateDUKPTName()

String generateDUKPTName	(	byte[]	baKSI,
		byte[]	baDID_CTR ) throws TacException

Genera el nombre del DUKPT a partir del KSI y el CTR introducidos.

Parámetros

baKSI	Buffer de tamaño TacNDJavaLib.MIN_KSI_LEN que contiene el KSI (primeros 05 bytes del KSN).
baDID_CTR	Buffer de tamaño TacNDJavaLib.MIN_CTR_LEN que contiene el DID y el CTR (últimos 05 bytes del KSN).

Devolución

Devuelve el nombre de la clave DUKPT.

Excepciones

TacException

generateBDKName()

String generateBDKName

(

byte[]

baKSI

)

throws TacException

Genera el nombre BDK a partir de un KSI (Key Serial Identification).

Parámetros

baKSI

Buffer de tamaño TacNDJavaLib.MIN_KSI_LEN que contiene el KSI (primeros 05 bytes del KSN).

Devolución

Devuelve el nombre de la clave BDK.

Excepciones

TacException

translatePINBlock()

byte[] translatePINBlock	(	String	srcPEK,
		String	dstPEK,
		int	transBlockType,
		String	PAN,
		byte[]	inPINBlock ) throws TacException

Traduce un bloque PIN, descifrándolo con una clave y cifrándolo con otra.

El formato de bloque entrante se identifica automáticamente, y el formato de bloque saliente puede ser definido por el emisor de la llamada, siempre que el cambio de formato no sea de un PAN Unbound a un PAN Bound. Los formatos PAN Bound son aquellos que utilizan información PAN en su composición. Por tanto, es posible realizar tanto la traducción de claves como la traducción de formatos. El llamante puede realizar una validación forzada del formato indicando para el formato saliente, el mismo que está utilizando en el Bloque PIN entrante.

Parámetros

srcPEK	Identificador de la clave de descifrado dentro del HSM.
dstPEK	Identificador de la clave de cifrado dentro del HSM.
transBlockType	Identificador del formato del bloque de salida. Según la tabla siguiente. Valor Significado TacNDJavaLib.TP_TRANSLATE_TYPE_AUTO Realiza una conversión opaca, traduciendo del bloque con la clave de origen al bloque con la clave de destino, sin analizar el formato ni el contenido del bloque. PAN Bound: no se aplica. TacNDJavaLib.TP_TRANSLATE_TYPE_ISO_0 Utiliza ISO PIN Block Format 0 (equivalente a ANSI PIN Block Format 0 y VISA PIN Block Format 1). PAN Bound: sí. TacNDJavaLib.TP_TRANSLATE_TYPE_ISO_1 Utiliza el formato ISO PIN Block 1. PAN Bound: no. TacNDJavaLib.TP_TRANSLATE_TYPE_ISO_3 Utiliza el formato ISO PIN Block Format 3. PAN Bound: sí. TacNDJavaLib.TP_TRANSLATE_TYPE_IBM_3624 Tipo de bloque IBM 3624 utilizado. No implementado.
PAN	PAN (Número de cuenta principal).
inPINBlock	Entrada de bloque PIN. El búfer debe tener el tamaño de un PIN Block, TacNDJavaLib.DES_BLOCK (8 bytes).

Devolución

Salida del bloque PIN.

Excepciones

TacException

Notas

En el caso de una conversión no opaca, es decir, una traducción de formato, si no se puede reconocer el formato PIN Block de entrada, se devolverá un error D_ERR_OPERATION_FAILED.
El método ISO PIN Block Format 2 no está implementado en el HSM, ya que este formato está destinado a utilizarse para la protección del PIN cuando se envía desde el lector de tarjetas chip.

exportTR31()

byte[] exportTR31	(	String	kbpk,
		String	key,
		int	usage,
		byte	mode,
		byte	export ) throws TacException

Exporta una clave en formato TR-31 según la norma ASC X9 TR 31-2018.

Parámetros

kbpk	Nombre de la clave KBPK (Key Block Protection Key) utilizada para derivar las claves de cifrado y autenticación.
key	Nombre de la clave que se exportará del HSM.
usage	Identificador de uso de clave, como se describe en ASC X9 TR 31-2018 Sección A.5.1 tabla 6. Se aceptan las siguientes opciones. Valor Significado TacNDJavaLib.EFT_ME_TR31_EXP_USAGE_AUTO Define el identificador automáticamente. Se utilizan los siguientes valores: TacNDJavaLib . EFT_ME_TR31_EXP_USAGE_D0 para clave simétrica y TacNDJavaLib.EFT_ME_TR31_EXP_USAGE_D1 para clave asimétrica. TacNDJavaLib.EFT_ME_TR31_EXP_USAGE_B0 BDK Clave de derivación base TacNDJavaLib.EFT_ME_TR31_EXP_USAGE_B1 Clave inicial DUKPT TacNDJavaLib.EFT_ME_TR31_EXP_USAGE_B2 Clave base Clave variante TacNDJavaLib.EFT_ME_TR31_EXP_USAGE_C0 CVK Clave de verificación de la tarjeta TacNDJavaLib.EFT_ME_TR31_EXP_USAGE_D0 Clave simétrica para el cifrado de datos TacNDJavaLib.EFT_ME_TR31_EXP_USAGE_D1 Clave asimétrica para el cifrado de datos TacNDJavaLib.EFT_ME_TR31_EXP_USAGE_D2 Clave de encriptación de datos para la tabla de decimalización TacNDJavaLib.EFT_ME_TR31_EXP_USAGE_E0 EMV/chip Issuer Master Key: Criptogramas de aplicación TacNDJavaLib.EFT_ME_TR31_EXP_USAGE_E1 Clave maestra de emisor EMV/chip: mensajería segura para la confidencialidad TacNDJavaLib.EFT_ME_TR31_EXP_USAGE_E2 Clave maestra del emisor EMV/chip: mensajería segura para la integridad TacNDJavaLib.EFT_ME_TR31_EXP_USAGE_E3 EMV/chip Clave maestra del emisor: Código de autenticación de datos TacNDJavaLib.EFT_ME_TR31_EXP_USAGE_E4 EMV/chip Clave maestra del emisor: Números dinámicos TacNDJavaLib.EFT_ME_TR31_EXP_USAGE_E5 EMV/chip Emisor Llave maestra: Personalización de tarjetas TacNDJavaLib.EFT_ME_TR31_EXP_USAGE_E6 EMV/chip Llave maestra del emisor: Otro TacNDJavaLib.EFT_ME_TR31_EXP_USAGE_I0 Vector de inicialización (IV) TacNDJavaLib.EFT_ME_TR31_EXP_USAGE_K0 Cifrado o envoltura de claves TacNDJavaLib.EFT_ME_TR31_EXP_USAGE_K1 TR-31 Llave de protección del bloque de llaves TacNDJavaLib.EFT_ME_TR31_EXP_USAGE_K2 TR-34 Clave asimétrica TacNDJavaLib.EFT_ME_TR31_EXP_USAGE_K3 Clave asimétrica para acuerdo de claves/envuelta de claves TacNDJavaLib.EFT_ME_TR31_EXP_USAGE_M0 ISO 16609 MAC algoritmo 1 (utilizando TDEA) TacNDJavaLib.EFT_ME_TR31_EXP_USAGE_M1 ISO 9797-1 Algoritmo MAC 1 TacNDJavaLib.EFT_ME_TR31_EXP_USAGE_M2 ISO 9797-1 Algoritmo MAC 2 TacNDJavaLib.EFT_ME_TR31_EXP_USAGE_M3 ISO 9797-1 Algoritmo MAC 3 TacNDJavaLib.EFT_ME_TR31_EXP_USAGE_M4 ISO 9797-1 Algoritmo MAC 4 TacNDJavaLib.EFT_ME_TR31_EXP_USAGE_M5 ISO 9797-1:1999 Algoritmo MAC 5 TacNDJavaLib.EFT_ME_TR31_EXP_USAGE_M6 ISO 9797-1:2011 Algoritmo MAC 5/CMAC TacNDJavaLib.EFT_ME_TR31_EXP_USAGE_M7 HMAC TacNDJavaLib.EFT_ME_TR31_EXP_USAGE_M8 ISO 9797-1:2011 Algoritmo MAC 6 TacNDJavaLib.EFT_ME_TR31_EXP_USAGE_P0 Cifrado de PIN TacNDJavaLib.EFT_ME_TR31_EXP_USAGE_S0 Par de claves asimétricas para la firma digital TacNDJavaLib.EFT_ME_TR31_EXP_USAGE_S1 Par de claves asimétricas, clave CA TacNDJavaLib.EFT_ME_TR31_EXP_USAGE_S2 Par de claves asimétricas, clave no X9.24 TacNDJavaLib.EFT_ME_TR31_EXP_USAGE_V0 Verificación PIN, KPV, otro algoritmo TacNDJavaLib.EFT_ME_TR31_EXP_USAGE_V1 Verificación del PIN, IBM 3624 TacNDJavaLib.EFT_ME_TR31_EXP_USAGE_V2 Verificación del PIN, VISA PVV TacNDJavaLib.EFT_ME_TR31_EXP_USAGE_V3 Verificación del PIN, X9.132 algoritmo 1 TacNDJavaLib.EFT_ME_TR31_EXP_USAGE_V4 Verificación del PIN, X9.132 algoritmo 2
mode	Identificador del modo de uso de la clave, como se describe en ASC X9 TR 31-2018 Sección A.5.3 tabla 8. Se aceptan las siguientes opciones. Valor Significado TacNDJavaLib.EFT_ME_TR31_EXP_MODE_AUTO Define automáticamente el identificador del modo de uso. Se utiliza el siguiente valor TacNDJavaLib.EFT_ME_TR31_EXP_MODE_N. TacNDJavaLib.EFT_ME_TR31_EXP_MODE_B Cifrado y descifrado / Envolver y desenvolver TacNDJavaLib.EFT_ME_TR31_EXP_MODE_C Generación y verificación TacNDJavaLib.EFT_ME_TR31_EXP_MODE_D Sólo desencriptación / desenvoltura TacNDJavaLib.EFT_ME_TR31_EXP_MODE_E Cifrado / Sólo envoltura TacNDJavaLib.EFT_ME_TR31_EXP_MODE_G Sólo generación TacNDJavaLib.EFT_ME_TR31_EXP_MODE_N Sin restricciones especiales (excepto las definidas por el identificador de uso de la clave) TacNDJavaLib.EFT_ME_TR31_EXP_MODE_S Sólo firma TacNDJavaLib.EFT_ME_TR31_EXP_MODE_T Firma y descifrado TacNDJavaLib.EFT_ME_TR31_EXP_MODE_V Sólo verificación TacNDJavaLib.EFT_ME_TR31_EXP_MODE_X Clave utilizada para derivar otra(s) clave(s) TacNDJavaLib.EFT_ME_TR31_EXP_MODE_Y Clave utilizada para crear variantes de clave
export	Identificador clave de exportabilidad, como se describe en ASC X9 TR 31-2018 Sección A.5.5 tabla 10. Se aceptan las siguientes opciones. Valor Significado TacNDJavaLib.EFT_ME_TR31_EXP_AUTO Define automáticamente el identificador de exportabilidad. Se utiliza el siguiente valor TacNDJavaLib.EFT_ME_TR31_EXP_X9_24. TacNDJavaLib.EFT_ME_TR31_EXP_X9_24 Exportable con una KEK (clave de cifrado) en un formato que cumpla lo definido en los requisitos de X9.24 Partes 1 ó 2. TacNDJavaLib.EFT_ME_TR31_EXP_NON_EXPORTABLE No exportable por el destinatario del bloque de claves ni por el lugar de almacenamiento. No impide la exportación de claves derivadas de una clave no exportable. TacNDJavaLib.EFT_ME_TR31_EXP_KEK_EXPORTABLE Sensible, Exportable bajo una KEK (Clave de Cifrado) en un formato no necesariamente conforme con los requisitos de X9.24 Partes 1 ó 2.

Devolución

bloque de teclas

Excepciones

TacException

Notas

Esta API exporta una clave utilizando los métodos para generar bloque_clave abajo.

Algoritmo KBPK	Método de exportación
3DES	5.3.2.1 Método vinculante de derivación de claves - TDEA
AES	5.3.2.3 Método de vinculación de bloques de claves - AES

importarTR31()

void importTR31	(	String	kbpk,
		String	key,
		int	keyAttributes,
		byte[]	keyBlock ) throws TacException

Importe una clave en formato TR-31 según la norma ASC X9 TR 31-2018.

Parámetros

kbpk	Nombre de la clave KBPK (Key Block Protection Key) utilizada para derivar las claves de cifrado y autenticación.
key	Nombre de la clave que se importará en el HSM.
keyAttributes	Parámetros adicionales de la clave. Consulte las opciones del método createKey().
keyBlock	bloque de teclas

Excepciones

TacException

Notas

Esta API importa claves protegidas por los métodos de generación de la aplicación bloque_clave.

Algoritmo KBPK	Método
3DES	5.3.2.1 Método vinculante de derivación de claves - TDEA
AES	5.3.2.3 Método de vinculación de bloques de claves - AES