net.jsign.jca

Class CryptoCertumCard

java.lang.Object

net.jsign.jca.CryptoCertumCard

public class CryptoCertumCard
extends Object

Simple smart card interface for Certum cards (cryptoCertum 3.6 Common Profile).

Since:

7.4

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	CryptoCertumCard.Certificate
class	CryptoCertumCard.Entry An entry on the card (key or certificate).
class	CryptoCertumCard.Key

Method Summary

Modifier and Type	Method and Description
List<String>	aliases() Return the name of the keys available on the card.
static CryptoCertumCard	getCard() Get the CryptoCertum card.
CryptoCertumCard.Certificate	getCertificate(String name) Return the certificate with the specified name.
byte[]	getChallenge(int length) Get a challenge from the card.
List<CryptoCertumCard.Entry>	getEntries() Return the list of keys and certificates available on the card.
byte[]	getFile(int fid) Get a file from the card.
byte[]	getFile(int fid, boolean partial) Get a file from the card.
CryptoCertumCard.Key	getKey(String name) Return the key with the specified name.
byte[]	getKeyData(int keyref) Return the public key data (modulus for RSA keys)
byte[]	sign(CryptoCertumCard.Key key, byte[] hash) Sign the specified hash with the specified key.
void	verify(int p1, int p2, String pin) Verify the PIN required for the protected operations.
void	verify(String pin) Set the PIN for the verify operation.

Methods inherited from class java.lang.Object

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

Method Detail

aliases

public List<String> aliases()
                     throws javax.smartcardio.CardException

Return the name of the keys available on the card.

Throws:

javax.smartcardio.CardException

getCard

public static CryptoCertumCard getCard()
                                throws javax.smartcardio.CardException

Get the CryptoCertum card.

Throws:

javax.smartcardio.CardException

getCertificate

public CryptoCertumCard.Certificate getCertificate(String name)
                                            throws javax.smartcardio.CardException

Return the certificate with the specified name.

Throws:

javax.smartcardio.CardException

getChallenge

public byte[] getChallenge(int length)
                    throws javax.smartcardio.CardException

Get a challenge from the card.

Parameters:

length - the length of the challenge in bytes (8 or 16)

Throws:

javax.smartcardio.CardException

getEntries

public List<CryptoCertumCard.Entry> getEntries()
                                        throws javax.smartcardio.CardException

Return the list of keys and certificates available on the card.

Throws:

javax.smartcardio.CardException

getFile

public byte[] getFile(int fid)
               throws javax.smartcardio.CardException

Get a file from the card. Known FIDs:

• 0x1021-0x102B: RSA Key #1-10
• 0x1031-0x103B: EC Key #1-10
• 0x2001-0x2015: Certificate #1-20
• 0x5032: object directory
• 0x5034: card info (factory id, serial number)

Parameters:

fid - the identifier of the file

Throws:

javax.smartcardio.CardException

getFile

public byte[] getFile(int fid,
                      boolean partial)
               throws javax.smartcardio.CardException

Get a file from the card. Known FIDs:

• 0x1021-0x102B: RSA Key #1-10
• 0x1031-0x103B: EC Key #1-10
• 0x2001-0x2015: Certificate #1-20
• 0x5032: object directory
• 0x5034: card info (factory id, serial number)

Parameters:

fid - the identifier of the file

partial - if true, return only the first 256 bytes of the file

Throws:

javax.smartcardio.CardException

getKey

public CryptoCertumCard.Key getKey(String name)
                            throws javax.smartcardio.CardException

Return the key with the specified name.

Throws:

javax.smartcardio.CardException

getKeyData

public byte[] getKeyData(int keyref)
                  throws javax.smartcardio.CardException

Return the public key data (modulus for RSA keys)

Parameters:

keyref - the reference of the key

Throws:

javax.smartcardio.CardException

sign

public byte[] sign(CryptoCertumCard.Key key,
                   byte[] hash)
            throws javax.smartcardio.CardException

Sign the specified hash with the specified key.

Parameters:

key - the key to use for signing

hash - the hash to sign

Throws:

javax.smartcardio.CardException

verify

public void verify(int p1,
                   int p2,
                   String pin)
            throws javax.smartcardio.CardException

Verify the PIN required for the protected operations.

Parameters:

p1 - 0x00: verify, 0xFF: reset

p2 - 0x83: PIN, 0x84: PUK

pin - the PIN

Throws:

javax.smartcardio.CardException

verify

public void verify(String pin)

Set the PIN for the verify operation.