com.yello.api.redsys

Class RedsysKey

java.lang.Object

com.yello.api.redsys.RedsysKey

public final class RedsysKey
extends java.lang.Object

The RedsysKey Class

The RedsysKey class represents a Redsys cryptographic key to be uploaded to the security processor

Field Summary

Fields

Modifier and Type	Field and Description
static int	KCV_SIZE

Constructor Summary

Constructors

Constructor and Description
RedsysKey(byte[] key, byte[] kcv) Constructor

Method Summary

Modifier and Type	Method and Description
static byte[]	buildKCV(byte[] key) Build KCV value for a given key
static byte[]	decrypt(byte[] key, byte[] payload) Encrypts a payload with a given key
static byte[]	encrypt(byte[] old_key, byte[] new_key) Encrypt a new redsys key by the old one This is a helper function is used for a Redsys key processing test.
byte[]	getBytes() Gets the byte array of the Redsys key block
void	setId(int id) Sets the Key ID
void	setVersion(short version) Sets the version of the key
static int	sizeOf()

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

KCV_SIZE

public static int KCV_SIZE

Constructor Detail

RedsysKey

public RedsysKey(byte[] key,
                 byte[] kcv)
          throws RedsysKeyProcessingException

Constructor

Parameters:

key - byte array of a Redsys key

kcv - byte array of the key KCV value

Throws:

RedsysKeyProcessingException - general error

Method Detail

encrypt

public static byte[] encrypt(byte[] old_key,
                             byte[] new_key)
                      throws javax.crypto.NoSuchPaddingException,
                             java.security.NoSuchAlgorithmException,
                             java.security.InvalidKeyException,
                             javax.crypto.BadPaddingException,
                             javax.crypto.IllegalBlockSizeException,
                             java.security.InvalidAlgorithmParameterException

Encrypt a new redsys key by the old one This is a helper function is used for a Redsys key processing test. Normally Java library gets already encrypted new key and new key KCV value.

Parameters:

old_key - - key which is used for a new key encryption

new_key - - new key for the encryption

Returns:

- encrypted key blob

Throws:

javax.crypto.NoSuchPaddingException - padding exception error

java.security.NoSuchAlgorithmException - invalid algo error

java.security.InvalidKeyException - invalid key error

javax.crypto.BadPaddingException - invalid padding error

javax.crypto.IllegalBlockSizeException - invalid encryption block size error

java.security.InvalidAlgorithmParameterException - invalid algo params error

decrypt

public static byte[] decrypt(byte[] key,
                             byte[] payload)
                      throws javax.crypto.NoSuchPaddingException,
                             java.security.NoSuchAlgorithmException,
                             java.security.InvalidKeyException,
                             javax.crypto.BadPaddingException,
                             javax.crypto.IllegalBlockSizeException,
                             java.security.InvalidAlgorithmParameterException

Encrypts a payload with a given key

Parameters:

key - - key which is used for a new key encryption

payload - - payload for encryption

Returns:

- encrypted payload

Throws:

javax.crypto.NoSuchPaddingException - padding exception error

java.security.NoSuchAlgorithmException - invalid algo error

java.security.InvalidKeyException - invalid key error

javax.crypto.BadPaddingException - invalid padding error

javax.crypto.IllegalBlockSizeException - invalid encryption block size error

java.security.InvalidAlgorithmParameterException - invalid algo params error

buildKCV

public static byte[] buildKCV(byte[] key)
                       throws javax.crypto.NoSuchPaddingException,
                              java.security.NoSuchAlgorithmException,
                              java.security.InvalidKeyException,
                              javax.crypto.BadPaddingException,
                              javax.crypto.IllegalBlockSizeException,
                              java.security.InvalidAlgorithmParameterException

Build KCV value for a given key

Parameters:

key - - key meterial to build KCV from

Returns:

key KCV value

Throws:

javax.crypto.NoSuchPaddingException - padding exception error

java.security.NoSuchAlgorithmException - invalid algo error

java.security.InvalidKeyException - invalid key error

javax.crypto.BadPaddingException - invalid padding error

javax.crypto.IllegalBlockSizeException - invalid encryption block size error

java.security.InvalidAlgorithmParameterException - invalid algo params error

setId

public void setId(int id)

Sets the Key ID

Parameters:

id - key ID

setVersion

public void setVersion(short version)

Sets the version of the key

Parameters:

version - key version

sizeOf

public static int sizeOf()

Returns:

size of binary key block structured as follows:

     struct {
          uint32_t key_id
          uint16_t version
          uint8_t kcv[3]
          uint8_t pad[3]
          uint8_t key[16]
     }
 

getBytes

public byte[] getBytes()

Gets the byte array of the Redsys key block

Returns:

byte[] array of the Redsys key block