Package pt.gov.cartaodecidadao

Class PTEID_Card

java.lang.Object

pt.gov.cartaodecidadao.PTEID_Object

pt.gov.cartaodecidadao.PTEID_Card

All Implemented Interfaces:

PTEID_SigningDevice

Direct Known Subclasses:

PTEID_SmartCard

public class PTEID_Card
extends PTEID_Object
implements PTEID_SigningDevice

Abstract base class for all the card types supported.
PTEID_ReaderContext::getCard() method
will return such an object.

Method Summary

Modifier and Type	Method	Description
void	delete()
PTEID_Certificate	getAuthentication()
PTEID_Certificate	getCA()
PTEID_Certificate	getCert(PTEID_CertifType type)
PTEID_Certificates	getCertificates()
PTEID_SigningDeviceType	getDeviceType()
PTEID_Certificate	getRoot()
PTEID_Certificate	getSignature()
PTEID_CardType	getType()	Return the type of the card
void	initPaceAuthentication(String secret, long length, PTEID_CardPaceSecretType secretType)	Init the Pace authentication process
long	PTEID_SigningDevice_GetInterfaceCPtr()
PTEID_ByteArray	readFile(String fileID)	Read a File from the card.
PTEID_ByteArray	readFile(String fileID, long ulOffset)	Read a File from the card.
PTEID_ByteArray	readFile(String fileID, long ulOffset, long ulMaxLength)	Read a File from the card.
PTEID_ByteArray	sendAPDU(PTEID_ByteArray cmd)	Send an APDU command to the card and get the result.
PTEID_ByteArray	Sign(PTEID_ByteArray data)	Signs a block of data using RSA-PKCS#1 using cards of type PTEID_CARDTYPE_IAS07 or ECDSA using newer cards of type PTEID_CARDTYPE_IAS5 In the ECDSA case the signature is returned in IEEE P1363 format, i.e.
PTEID_ByteArray	Sign(PTEID_ByteArray data, boolean signatureKey)	Signs a block of data using RSA-PKCS#1 using cards of type PTEID_CARDTYPE_IAS07 or ECDSA using newer cards of type PTEID_CARDTYPE_IAS5 In the ECDSA case the signature is returned in IEEE P1363 format, i.e.
PTEID_ByteArray	Sign(PTEID_ByteArray data, PTEID_RSAPaddingType paddingType)	Signs a block of data using RSA-PKCS#1, RSA-PSS or ECDSA.
PTEID_ByteArray	Sign(PTEID_ByteArray data, PTEID_RSAPaddingType paddingType, boolean signatureKey)	Signs a block of data using RSA-PKCS#1, RSA-PSS or ECDSA.
void	SignASiC(String path)
void	SignASiC(String path, PTEID_SignatureLevel level)
int	SignPDF(PTEID_PDFSignature sig_handler, int page, double coord_x, double coord_y, String location, String reason, String outfile_path)
int	SignPDF(PTEID_PDFSignature sig_handler, int page, int page_sector, boolean is_landscape, String location, String reason, String outfile_path)
PTEID_ByteArray	SignSHA256(PTEID_ByteArray data)	Deprecated. Use PTEID_Card::Sign instead.
PTEID_ByteArray	SignSHA256(PTEID_ByteArray data, boolean signatureKey)	Deprecated. Use PTEID_Card::Sign instead.
PTEID_ByteArray	SignXades(String output_path, String[] paths, long n_paths)
PTEID_ByteArray	SignXades(String output_path, String[] paths, long n_paths, PTEID_SignatureLevel level)
PTEID_ByteArray	SignXadesA(String output_path, String[] paths, long n_paths)
void	SignXadesAIndividual(String output_path, String[] paths, long n_paths)
void	SignXadesIndividual(String output_path, String[] paths, long n_paths)
PTEID_ByteArray	SignXadesT(String output_path, String[] paths, long n_paths)
void	SignXadesTIndividual(String output_path, String[] paths, long n_paths)
boolean	writeFile(String fileID, PTEID_ByteArray oData)	Write a file to the card.
boolean	writeFile(String fileID, PTEID_ByteArray oData, long ulOffset)	Write a file to the card.

Methods inherited from class java.lang.Object

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

Method Details

delete

public void delete()

Overrides:

delete in class PTEID_Object

PTEID_SigningDevice_GetInterfaceCPtr

public long PTEID_SigningDevice_GetInterfaceCPtr()

Specified by:

PTEID_SigningDevice_GetInterfaceCPtr in interface PTEID_SigningDevice

getType

public PTEID_CardType getType()
                       throws PTEID_Exception

Return the type of the card

Throws:

PTEID_Exception

sendAPDU

public PTEID_ByteArray sendAPDU(PTEID_ByteArray cmd)
                         throws PTEID_Exception

Send an APDU command to the card and get the result.

Parameters:

cmd - is the apdu command

Returns:

A PTEID_ByteArray containing the result

Throws:

PTEID_Exception

Sign

public PTEID_ByteArray Sign(PTEID_ByteArray data,
 boolean signatureKey)
                     throws PTEID_Exception

Signs a block of data using RSA-PKCS#1 using cards of type PTEID_CARDTYPE_IAS07 or ECDSA using newer cards of type PTEID_CARDTYPE_IAS5
In the ECDSA case the signature is returned in IEEE P1363 format, i.e. the signature is the concatenation of r and s values generated by the algorithm.
In some application contexts encoding the signature into the ASN.1 format described in RFC-5480 may be needed.

Specified by:

Sign in interface PTEID_SigningDevice

Parameters:

data - block of data to be signed. Has to be hashed using either sha1, sha256, sha384 or sha512. Therefore,
size of data array has to be at max 64 bytes.

signatureKey - by default uses the 'Authentication private key' to sign message. Setting this to true
makes use of 'Signature private key' instead.

Returns:

PTEID_ByteArray containing the signature

Throws:

PTEID_Exception

Sign

public PTEID_ByteArray Sign(PTEID_ByteArray data)
                     throws PTEID_Exception

Signs a block of data using RSA-PKCS#1 using cards of type PTEID_CARDTYPE_IAS07 or ECDSA using newer cards of type PTEID_CARDTYPE_IAS5
In the ECDSA case the signature is returned in IEEE P1363 format, i.e. the signature is the concatenation of r and s values generated by the algorithm.
In some application contexts encoding the signature into the ASN.1 format described in RFC-5480 may be needed.

Specified by:

Sign in interface PTEID_SigningDevice

Parameters:

data - block of data to be signed. Has to be hashed using either sha1, sha256, sha384 or sha512. Therefore,
size of data array has to be at max 64 bytes.

Returns:

PTEID_ByteArray containing the signature

Throws:

PTEID_Exception

SignSHA256

public PTEID_ByteArray SignSHA256(PTEID_ByteArray data,
 boolean signatureKey)
                           throws PTEID_Exception

Deprecated.

Use PTEID_Card::Sign instead.

Specified by:

SignSHA256 in interface PTEID_SigningDevice

Throws:

PTEID_Exception

SignSHA256

public PTEID_ByteArray SignSHA256(PTEID_ByteArray data)
                           throws PTEID_Exception

Deprecated.

Use PTEID_Card::Sign instead.

Specified by:

SignSHA256 in interface PTEID_SigningDevice

Throws:

PTEID_Exception

Sign

public PTEID_ByteArray Sign(PTEID_ByteArray data,
 PTEID_RSAPaddingType paddingType,
 boolean signatureKey)
                     throws PTEID_Exception

Signs a block of data using RSA-PKCS#1, RSA-PSS or ECDSA. This method can be used to select the RSA padding algorithm to use with cards
of type PTEID_CARDTYPE_IAS07. When using newer cards of type PTEID_CARDTYPE_IAS5 parameter is ignored and an ECDSA signature is returned.

Parameters:

data - block of data to be signed. Has to be hashed using either sha1, sha256, sha384 or sha512. Therefore,
data has to be at max 64 bytes.

paddingType - either RSA-PSS or RSA-PKCS#1

signatureKey - by default uses the 'Authentication private key' to sign message. Setting this to true
makes use of 'Signature private key' instead.

Returns:

PTEID_ByteArray containing the signature

Throws:

PTEID_Exception

Sign

public PTEID_ByteArray Sign(PTEID_ByteArray data,
 PTEID_RSAPaddingType paddingType)
                     throws PTEID_Exception

Signs a block of data using RSA-PKCS#1, RSA-PSS or ECDSA. This method can be used to select the RSA padding algorithm to use with cards
of type PTEID_CARDTYPE_IAS07. When using newer cards of type PTEID_CARDTYPE_IAS5 parameter is ignored and an ECDSA signature is returned.

Parameters:

data - block of data to be signed. Has to be hashed using either sha1, sha256, sha384 or sha512. Therefore,
data has to be at max 64 bytes.

paddingType - either RSA-PSS or RSA-PKCS#1

Returns:

PTEID_ByteArray containing the signature

Throws:

PTEID_Exception

SignXades

public PTEID_ByteArray SignXades(String output_path,
 String[] paths,
 long n_paths,
 PTEID_SignatureLevel level)
                          throws PTEID_Exception

Specified by:

SignXades in interface PTEID_SigningDevice

Throws:

PTEID_Exception

SignXades

public PTEID_ByteArray SignXades(String output_path,
 String[] paths,
 long n_paths)
                          throws PTEID_Exception

Specified by:

SignXades in interface PTEID_SigningDevice

Throws:

PTEID_Exception

SignXadesT

public PTEID_ByteArray SignXadesT(String output_path,
 String[] paths,
 long n_paths)
                           throws PTEID_Exception

Specified by:

SignXadesT in interface PTEID_SigningDevice

Throws:

PTEID_Exception

SignXadesA

public PTEID_ByteArray SignXadesA(String output_path,
 String[] paths,
 long n_paths)
                           throws PTEID_Exception

Specified by:

SignXadesA in interface PTEID_SigningDevice

Throws:

PTEID_Exception

SignXadesIndividual

public void SignXadesIndividual(String output_path,
 String[] paths,
 long n_paths)
                         throws PTEID_Exception

Specified by:

SignXadesIndividual in interface PTEID_SigningDevice

Throws:

PTEID_Exception

SignXadesTIndividual

public void SignXadesTIndividual(String output_path,
 String[] paths,
 long n_paths)
                          throws PTEID_Exception

Specified by:

SignXadesTIndividual in interface PTEID_SigningDevice

Throws:

PTEID_Exception

SignXadesAIndividual

public void SignXadesAIndividual(String output_path,
 String[] paths,
 long n_paths)
                          throws PTEID_Exception

Specified by:

SignXadesAIndividual in interface PTEID_SigningDevice

Throws:

PTEID_Exception

SignASiC

public void SignASiC(String path,
 PTEID_SignatureLevel level)

Specified by:

SignASiC in interface PTEID_SigningDevice

SignASiC

public void SignASiC(String path)

Specified by:

SignASiC in interface PTEID_SigningDevice

SignPDF

public int SignPDF(PTEID_PDFSignature sig_handler,
 int page,
 int page_sector,
 boolean is_landscape,
 String location,
 String reason,
 String outfile_path)
            throws PTEID_Exception

Specified by:

SignPDF in interface PTEID_SigningDevice

Throws:

PTEID_Exception

SignPDF

public int SignPDF(PTEID_PDFSignature sig_handler,
 int page,
 double coord_x,
 double coord_y,
 String location,
 String reason,
 String outfile_path)
            throws PTEID_Exception

Specified by:

SignPDF in interface PTEID_SigningDevice

Throws:

PTEID_Exception

getCertificates

public PTEID_Certificates getCertificates()
                                   throws PTEID_Exception

Specified by:

getCertificates in interface PTEID_SigningDevice

Returns:

an object to access all the certificates on the card.

Throws:

PTEID_Exception

getCert

public PTEID_Certificate getCert(PTEID_CertifType type)
                          throws PTEID_Exception

Specified by:

getCert in interface PTEID_SigningDevice

Throws:

PTEID_Exception

getRoot

public PTEID_Certificate getRoot()
                          throws PTEID_Exception

Specified by:

getRoot in interface PTEID_SigningDevice

Throws:

PTEID_Exception

getCA

public PTEID_Certificate getCA()
                        throws PTEID_Exception

Specified by:

getCA in interface PTEID_SigningDevice

Throws:

PTEID_Exception

getSignature

public PTEID_Certificate getSignature()
                               throws PTEID_Exception

Specified by:

getSignature in interface PTEID_SigningDevice

Throws:

PTEID_Exception

getAuthentication

public PTEID_Certificate getAuthentication()
                                    throws PTEID_Exception

Specified by:

getAuthentication in interface PTEID_SigningDevice

Throws:

PTEID_Exception

getDeviceType

public PTEID_SigningDeviceType getDeviceType()

Specified by:

getDeviceType in interface PTEID_SigningDevice

readFile

public PTEID_ByteArray readFile(String fileID,
 long ulOffset,
 long ulMaxLength)
                         throws PTEID_Exception

Read a File from the card.

Parameters:

fileID - is the path of the file

ulOffset - is the offset to begin the reading

ulMaxLength - is the maximum length of bytes to read

Returns:

A PTEID_ByteArray with the content of the file

Throws:

PTEID_Exception

readFile

public PTEID_ByteArray readFile(String fileID,
 long ulOffset)
                         throws PTEID_Exception

Read a File from the card.

Parameters:

fileID - is the path of the file

ulOffset - is the offset to begin the reading

Returns:

A PTEID_ByteArray with the content of the file

Throws:

PTEID_Exception

readFile

public PTEID_ByteArray readFile(String fileID)
                         throws PTEID_Exception

Read a File from the card.

Parameters:

fileID - is the path of the file

Returns:

A PTEID_ByteArray with the content of the file

Throws:

PTEID_Exception

writeFile

public boolean writeFile(String fileID,
 PTEID_ByteArray oData,
 long ulOffset)
                  throws PTEID_Exception

Write a file to the card.

Parameters:

fileID - is the path of the file

oData - contents the bytes to write

ulOffset - is the offset to begin the writing

Throws:

PTEID_Exception

writeFile

public boolean writeFile(String fileID,
 PTEID_ByteArray oData)
                  throws PTEID_Exception

Write a file to the card.

Parameters:

fileID - is the path of the file

oData - contents the bytes to write

Throws:

PTEID_Exception

initPaceAuthentication

public void initPaceAuthentication(String secret,
 long length,
 PTEID_CardPaceSecretType secretType)
                            throws PTEID_Exception

Init the Pace authentication process

Parameters:

secret - string that holds the secret to make the PACE process

length - size of the secret string

secretType - type of the secret used to make the PACE process

Throws:

PTEID_Exception