ee.ria.DigiDoc.idcard

Interface Token

public interface Token

EstEID token interface.

Method Summary

Modifier and Type	Method and Description
byte[]	calculateSignature(byte[] pin2, byte[] hash, boolean ecc) Calculate electronic signature with pre-calculated hash.
byte[]	certificate(CertificateType type) Read certificate data of the cardholder.
void	changeCode(CodeType type, byte[] currentCode, byte[] newCode) Change PIN1/PIN2/PUK code.
int	codeRetryCounter(CodeType type) Read retry counter for PIN1/PIN2/PUK code.
static Token	create(SmartCardReader reader) Create an instance of Token based on the current card in the reader.
byte[]	decrypt(byte[] pin1, byte[] data, boolean ecc) Decrypt data.
PersonalData	personalData() Read personal information of the cardholder.
void	unblockAndChangeCode(byte[] pukCode, CodeType type, byte[] newCode) Unblock PIN1/PIN2 via PUK code and change it to a new value.

Method Detail

personalData

PersonalData personalData()
                   throws SmartCardReaderException

Read personal information of the cardholder.

Returns:

Personal data of the cardholder.

Throws:

SmartCardReaderException - When reading failed.

changeCode

void changeCode(CodeType type,
                byte[] currentCode,
                byte[] newCode)
         throws SmartCardReaderException

Change PIN1/PIN2/PUK code.

Parameters:

type - Code type.

currentCode - Current code.

newCode - New code.

Throws:

SmartCardReaderException - When changing failed.

CodeVerificationException - When current code is wrong.

unblockAndChangeCode

void unblockAndChangeCode(byte[] pukCode,
                          CodeType type,
                          byte[] newCode)
                   throws SmartCardReaderException

Unblock PIN1/PIN2 via PUK code and change it to a new value. When PIN1/PIN2 is not blocked yet it will be blocked before unblocking.

Parameters:

pukCode - PUK code.

type - Code type.

newCode - New code.

Throws:

SmartCardReaderException - When changing failed.

CodeVerificationException - When PUK code is wrong.

codeRetryCounter

int codeRetryCounter(CodeType type)
              throws SmartCardReaderException

Read retry counter for PIN1/PIN2/PUK code.

Parameters:

type - Code type.

Returns:

Code retry counter.

Throws:

SmartCardReaderException

certificate

byte[] certificate(CertificateType type)
            throws SmartCardReaderException

Read certificate data of the cardholder.

Parameters:

type - Type of the certificate.

Returns:

Certificate data.

Throws:

SmartCardReaderException - When reading failed.

calculateSignature

byte[] calculateSignature(byte[] pin2,
                          byte[] hash,
                          boolean ecc)
                   throws SmartCardReaderException

Calculate electronic signature with pre-calculated hash.

Parameters:

pin2 - PIN2 code.

hash - Pre-calculated hash.

ecc - Whether it's a elliptic curve certificate.

Returns:

Signed data.

Throws:

SmartCardReaderException - When calculating signature failed.

CodeVerificationException - When PIN2 code is wrong.

decrypt

byte[] decrypt(byte[] pin1,
               byte[] data,
               boolean ecc)
        throws SmartCardReaderException

Decrypt data.

Parameters:

pin1 - PIN1 code.

data - Data to decrypt.

ecc - Whether it's a elliptic curve certificate.

Returns:

Decrypt result.

Throws:

SmartCardReaderException - When decrypting failed.

CodeVerificationException - When PIN1 code is wrong.

create

static Token create(SmartCardReader reader)
             throws SmartCardReaderException

Create an instance of Token based on the current card in the reader.

Parameters:

reader - Smart card reader instance, must be connected.

Returns:

Token instance.

Throws:

SmartCardReaderException - When card is not supported or reader is not connected.