The ISO7816 commands class. More...

#include <iso7816commands.hpp>

Inheritance diagram for logicalaccess::ISO7816Commands:

Public Member Functions
	ISO7816Commands ()

	ISO7816Commands (std::string ct)

virtual	~ISO7816Commands ()

virtual ByteVector	readBinary (size_t length, size_t offset, unsigned short efid=0)=0
	Read binary data.

virtual void	writeBinary (const ByteVector &data, size_t offset, unsigned short efid=0)=0
	Write binary data.

virtual void	updateBinary (const ByteVector &data, size_t offset, unsigned short efid=0)=0
	Update binary data.

virtual void	eraseBinary (size_t offset, unsigned short efid=0)=0
	Erase binary data.

virtual ByteVector	getData (unsigned short dataObject, size_t length=0)=0
	Get data.

virtual ByteVector	getDataList (int64_t dataObject, unsigned short efid=ISO7816_DATA_OBJECT_SELECTED, unsigned char listtag=ISO7816_DATA_OBJECT_HEADERLIST, size_t length=0)
	Get data.

virtual ByteVector	getDataList (TLVPtr tlv, size_t length=0, unsigned short efid=ISO7816_DATA_OBJECT_SELECTED)
	Get data.

virtual ByteVector	getDataList (const ByteVector &data, size_t length=0, unsigned short efid=ISO7816_DATA_OBJECT_SELECTED)=0
	Get data.

virtual void	putData (const ByteVector &data, unsigned short dataObject)=0
	Put data.

virtual ByteVector	getResponse (unsigned char maxlength=0)=0
	Get response.

virtual void	selectFile (ISOSelectFileP1 p1, ISOSelectFileP2 p2, unsigned short efid)
	Select a file under current DF by the file identifier.

virtual void	selectFile (unsigned short efid)
	Select a file under current DF by the file identifier.

virtual void	selectFile (const ByteVector &dfname)
	Select a file by the DF name.

virtual void	selectFile (unsigned char p1, unsigned char p2, const ByteVector &data)=0
	Select a file.

virtual ByteVector	readRecords (unsigned short fid=0, unsigned char start_record=0, ISORecords record_number=ISO_RECORD_ONERECORD)=0
	Read records.

virtual void	appendrecord (const ByteVector &data=ByteVector(), unsigned short fid=0)=0
	Append a record to a file.

virtual ByteVector	getChallenge (unsigned int length=8)=0
	Get the ISO challenge for authentication.

virtual void	externalAuthenticate (unsigned char algorithm=0x00, bool globalReference=false, unsigned char keyno=0x00, const ByteVector &data=ByteVector())=0
	ISO external authenticate.

virtual ByteVector	externalAuthenticate (unsigned char algorithm, bool globalReference, unsigned char keyno, const ByteVector &data, unsigned char le)=0
	ISO external authenticate.

virtual ByteVector	internalAuthenticate (unsigned char algorithm=0x00, bool globalReference=false, unsigned char keyno=0x00, const ByteVector &RPCD2=ByteVector(), unsigned int length=16)=0
	ISO internal authenticate.

virtual ByteVector	generalAuthenticate (unsigned char algorithm, bool globalReference, unsigned char keyno, const ByteVector &dataField, unsigned char le)=0
	ISO general authenticate.

virtual ByteVector	generalAuthenticate_challenge (unsigned char algorithm, bool globalReference, unsigned char keyno)=0

virtual ByteVector	generalAuthenticate_response (unsigned char algorithm, bool globalReference, unsigned char keyno, const ByteVector &data)=0

virtual void	removeApplication (const ByteVector &data, ISORemoveApplicationP1 p1=P1_STATE_OPERATIONAL_OR_INITIALIZATION_TO_CREATION)=0

virtual void	removeApplication (TLVPtr tlv, ISORemoveApplicationP1 p1=P1_STATE_OPERATIONAL_OR_INITIALIZATION_TO_CREATION)

virtual ByteVector	applicationManagementRequest (const ByteVector &data, ISOApplicationManagementRequestP1 p1=P1_STATE_CREATION_TO_OPERATIONAL, unsigned char p2=0x00)=0

virtual ByteVector	applicationManagementRequest (TLVPtr tlv, ISOApplicationManagementRequestP1 p1=P1_STATE_CREATION_TO_OPERATIONAL, unsigned char p2=0x00)

Public Member Functions inherited from logicalaccess::Commands
	Commands ()=delete
	Constructor.

virtual	~Commands ()

std::shared_ptr< Chip >	getChip () const override
	Get the chip.

virtual void	setChip (std::shared_ptr< Chip > chip)
	Set the chip.

std::shared_ptr< ReaderCardAdapter >	getReaderCardAdapter () const override
	Get the reader/card adapter.

virtual void	setReaderCardAdapter (std::shared_ptr< ReaderCardAdapter > adapter)
	Set the reader/card adapter.

virtual const std::string &	getCmdType () const
	Get the cmd name.

virtual void	setCmdType (const std::string &command_type)
	Set the cmd name.

Public Member Functions inherited from logicalaccess::ICommands
virtual	~ICommands ()=default

virtual std::shared_ptr< Chip >	getChip () const =0
	Get the chip.

virtual std::shared_ptr< ReaderCardAdapter >	getReaderCardAdapter () const =0
	Get the reader/card adapter.

Additional Inherited Members
Protected Member Functions inherited from logicalaccess::Commands
	Commands (std::string commandtype)
	Constructor.

Protected Attributes inherited from logicalaccess::Commands
std::shared_ptr< ReaderCardAdapter >	d_readerCardAdapter
	The reader/card adapter.

std::weak_ptr< Chip >	d_chip
	The chip.

std::string	d_commandtype
	The command type.

Detailed Description

The ISO7816 commands class.

Constructor & Destructor Documentation

◆ ISO7816Commands() [1/2]

logicalaccess::ISO7816Commands::ISO7816Commands ( )

inline

◆ ISO7816Commands() [2/2]

logicalaccess::ISO7816Commands::ISO7816Commands ( std::string ct )

inlineexplicit

◆ ~ISO7816Commands()

logicalaccess::ISO7816Commands::~ISO7816Commands ( )

virtual

Member Function Documentation

◆ appendrecord()

virtual void logicalaccess::ISO7816Commands::appendrecord	(	const ByteVector &	data = `ByteVector()`,
		unsigned short	fid = `0`
	)

pure virtual

Append a record to a file.

Parameters

data	The record data
fid	The FID

Implemented in logicalaccess::ISO7816ISO7816Commands.

◆ applicationManagementRequest() [1/2]

virtual ByteVector logicalaccess::ISO7816Commands::applicationManagementRequest	(	const ByteVector &	data,
		ISOApplicationManagementRequestP1	p1 = `P1_STATE_CREATION_TO_OPERATIONAL`,
		unsigned char	p2 = `0x00`
	)

pure virtual

Implemented in logicalaccess::ISO7816ISO7816Commands.

◆ applicationManagementRequest() [2/2]

ByteVector logicalaccess::ISO7816Commands::applicationManagementRequest	(	TLVPtr	tlv,
		ISOApplicationManagementRequestP1	p1 = `P1_STATE_CREATION_TO_OPERATIONAL`,
		unsigned char	p2 = `0x00`
	)

virtual

◆ eraseBinary()

virtual void logicalaccess::ISO7816Commands::eraseBinary	(	size_t	offset,
		unsigned short	efid = `0`
	)

pure virtual

Erase binary data.

Parameters

offset	The erase offset.
efid	The EF identifier to set as current.

Implemented in logicalaccess::ISO7816ISO7816Commands.

◆ externalAuthenticate() [1/2]

virtual ByteVector logicalaccess::ISO7816Commands::externalAuthenticate	(	unsigned char	algorithm,
		bool	globalReference,
		unsigned char	keyno,
		const ByteVector &	data,
		unsigned char	le
	)

pure virtual

ISO external authenticate.

Parameters

algorithm	The ISO algorithm to use for authentication.
globalReference	True if the referenced key to authenticate is global (e.g. an MF secific key), false otherwise (e.g. DF specific key). false otherwise.
keyno	The key number.
data	The data.
le	Expected response length.

Returns: The authentication response.

Implemented in logicalaccess::ISO7816ISO7816Commands.

◆ externalAuthenticate() [2/2]

virtual void logicalaccess::ISO7816Commands::externalAuthenticate	(	unsigned char	algorithm = `0x00`,
		bool	globalReference = `false`,
		unsigned char	keyno = `0x00`,
		const ByteVector &	data = `ByteVector()`
	)

pure virtual

ISO external authenticate.

Parameters

algorithm	The ISO algorithm to use for authentication.
globalReference	True if the referenced key to authenticate is global (e.g. an MF secific key), false otherwise (e.g. DF specific key).
keyno	The key number.
data	The data.

Implemented in logicalaccess::ISO7816ISO7816Commands.

◆ generalAuthenticate()

virtual ByteVector logicalaccess::ISO7816Commands::generalAuthenticate	(	unsigned char	algorithm,
		bool	globalReference,
		unsigned char	keyno,
		const ByteVector &	dataField,
		unsigned char	le
	)

pure virtual

ISO general authenticate.

Parameters

algorithm	The ISO algorithm to use for authentication.
globalReference	True if the referenced key to authenticate is global (e.g. an MF secific key), false otherwise (e.g. DF specific key). false otherwise.
keyno	The key number.
dataField	The data.
le	Expected response length.

Returns: The authentication response.

Implemented in logicalaccess::ISO7816ISO7816Commands.

◆ generalAuthenticate_challenge()

virtual ByteVector logicalaccess::ISO7816Commands::generalAuthenticate_challenge	(	unsigned char	algorithm,
		bool	globalReference,
		unsigned char	keyno
	)

pure virtual

Implemented in logicalaccess::ISO7816ISO7816Commands.

◆ generalAuthenticate_response()

virtual ByteVector logicalaccess::ISO7816Commands::generalAuthenticate_response	(	unsigned char	algorithm,
		bool	globalReference,
		unsigned char	keyno,
		const ByteVector &	data
	)

pure virtual

Implemented in logicalaccess::ISO7816ISO7816Commands.

◆ getChallenge()

virtual ByteVector logicalaccess::ISO7816Commands::getChallenge ( unsigned int length = 8 )

pure virtual

Get the ISO challenge for authentication.

Parameters

length The challenge length (8 = 2K3DES, 16 = 3K3DES and AES)

Returns: The ISO challenge.

Implemented in logicalaccess::ISO7816ISO7816Commands.

◆ getData()

virtual ByteVector logicalaccess::ISO7816Commands::getData	(	unsigned short	dataObject,
		size_t	length = `0`
	)

pure virtual

Get data.

Parameters

dataObject	The data object to get.
length	The expected object length.

Returns: The data of the object.

Implemented in logicalaccess::ISO7816ISO7816Commands.

◆ getDataList() [1/3]

virtual ByteVector logicalaccess::ISO7816Commands::getDataList	(	const ByteVector &	data,
		size_t	length = `0`,
		unsigned short	efid = `ISO7816_DATA_OBJECT_SELECTED`
	)

pure virtual

Get data.

Parameters

data	The data object list to get.
length	The expected object length.

Returns: The data of the object.

Implemented in logicalaccess::ISO7816ISO7816Commands.

◆ getDataList() [2/3]

ByteVector logicalaccess::ISO7816Commands::getDataList	(	int64_t	dataObject,
		unsigned short	efid = `ISO7816_DATA_OBJECT_SELECTED`,
		unsigned char	listtag = `ISO7816_DATA_OBJECT_HEADERLIST`,
		size_t	length = `0`
	)

virtual

Get data.

Parameters

dataObject	The data object to get.
listtag	The list tag.
length	The expected object length.

Returns: The data of the object.

◆ getDataList() [3/3]

ByteVector logicalaccess::ISO7816Commands::getDataList	(	TLVPtr	tlv,
		size_t	length = `0`,
		unsigned short	efid = `ISO7816_DATA_OBJECT_SELECTED`
	)

virtual

Get data.

Parameters

tlv	The tlv with data object list to get.
length	The expected object length.

Returns: The data of the object.

◆ getResponse()

virtual ByteVector logicalaccess::ISO7816Commands::getResponse ( unsigned char maxlength = 0 )

pure virtual

Get response.

Parameters

maxlength The maximum expected length.

Returns: The response data.

Implemented in logicalaccess::ISO7816ISO7816Commands.

◆ internalAuthenticate()

virtual ByteVector logicalaccess::ISO7816Commands::internalAuthenticate	(	unsigned char	algorithm = `0x00`,
		bool	globalReference = `false`,
		unsigned char	keyno = `0x00`,
		const ByteVector &	RPCD2 = `ByteVector()`,
		unsigned int	length = `16`
	)

pure virtual

ISO internal authenticate.

Parameters

algorithm	The ISO algorithm to use for authentication.
globalReference	True if the referenced key to authenticate is global (e.g. an MF secific key), false otherwise (e.g. DF specific key).
keyno	The key number.
RPCD2	The RPCD2.
length	The length.

Returns: The cryptogram.

Implemented in logicalaccess::ISO7816ISO7816Commands.

◆ putData()

virtual void logicalaccess::ISO7816Commands::putData	(	const ByteVector &	data,
		unsigned short	dataObject
	)

pure virtual

Put data.

Parameters

data	The buffer that contains data.
dataLength	The buffer length.
dataObject	The data object to get.

Implemented in logicalaccess::ISO7816ISO7816Commands.

◆ readBinary()

virtual ByteVector logicalaccess::ISO7816Commands::readBinary	(	size_t	length,
		size_t	offset,
		unsigned short	efid = `0`
	)

pure virtual

Read binary data.

Parameters

data	The buffer that will contains data.
dataLength	The buffer length.
offset	The read offset.
efid	The EF identifier to set as current.

Returns: True on success, false otherwise.

Implemented in logicalaccess::ISO7816ISO7816Commands.

◆ readRecords()

virtual ByteVector logicalaccess::ISO7816Commands::readRecords	(	unsigned short	fid = `0`,
		unsigned char	start_record = `0`,
		ISORecords	record_number = `ISO_RECORD_ONERECORD`
	)

pure virtual

Read records.

Parameters

fid	The FID
start_record	The start record (0 = read last written record)
record_number	The number of records to read

Returns: The record(s) data

Implemented in logicalaccess::ISO7816ISO7816Commands.

◆ removeApplication() [1/2]

virtual void logicalaccess::ISO7816Commands::removeApplication	(	const ByteVector &	data,
		ISORemoveApplicationP1	p1 = `P1_STATE_OPERATIONAL_OR_INITIALIZATION_TO_CREATION`
	)

pure virtual

Implemented in logicalaccess::ISO7816ISO7816Commands.

◆ removeApplication() [2/2]

void logicalaccess::ISO7816Commands::removeApplication	(	TLVPtr	tlv,
		ISORemoveApplicationP1	p1 = `P1_STATE_OPERATIONAL_OR_INITIALIZATION_TO_CREATION`
	)

virtual

◆ selectFile() [1/4]

void logicalaccess::ISO7816Commands::selectFile ( const ByteVector & dfname )

virtual

Select a file by the DF name.

Parameters

dfname The DF name.

◆ selectFile() [2/4]

void logicalaccess::ISO7816Commands::selectFile	(	ISOSelectFileP1	p1,
		ISOSelectFileP2	p2,
		unsigned short	efid
	)

virtual

Select a file under current DF by the file identifier.

Parameters

p1	The P1 parameter.
p2	The P2 parameter.
efid	The file identifier.

◆ selectFile() [3/4]

virtual void logicalaccess::ISO7816Commands::selectFile	(	unsigned char	p1,
		unsigned char	p2,
		const ByteVector &	data
	)

pure virtual

Select a file.

Parameters

p1	The parameter 1.
p2	The parameter 2.
data	The data buffer.

Implemented in logicalaccess::ISO7816ISO7816Commands.

◆ selectFile() [4/4]

void logicalaccess::ISO7816Commands::selectFile ( unsigned short efid )

virtual

Select a file under current DF by the file identifier.

Parameters

efid	The file identifier.

◆ updateBinary()

virtual void logicalaccess::ISO7816Commands::updateBinary	(	const ByteVector &	data,
		size_t	offset,
		unsigned short	efid = `0`
	)

pure virtual

Update binary data.

Parameters

data	The buffer that contains data to update.
dataLength	The buffer length.
offset	The update offset.
efid	The EF identifier to set as current.

Implemented in logicalaccess::ISO7816ISO7816Commands.

◆ writeBinary()

virtual void logicalaccess::ISO7816Commands::writeBinary	(	const ByteVector &	data,
		size_t	offset,
		unsigned short	efid = `0`
	)

pure virtual

Write binary data.

Parameters

data	The buffer that contains data to write.
dataLength	The buffer length.
offset	The write offset.
efid	The EF identifier to set as current.

Implemented in logicalaccess::ISO7816ISO7816Commands.

The documentation for this class was generated from the following files:

C:/dev/lla/liblogicalaccess/plugins/logicalaccess/plugins/cards/iso7816/iso7816commands.hpp
C:/dev/lla/liblogicalaccess/plugins/logicalaccess/plugins/cards/iso7816/iso7816commands.cpp

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ ISO7816Commands() [1/2]

◆ ISO7816Commands() [2/2]

◆ ~ISO7816Commands()

Member Function Documentation

◆ appendrecord()

◆ applicationManagementRequest() [1/2]

◆ applicationManagementRequest() [2/2]

◆ eraseBinary()

◆ externalAuthenticate() [1/2]

◆ externalAuthenticate() [2/2]

◆ generalAuthenticate()

◆ generalAuthenticate_challenge()

◆ generalAuthenticate_response()

◆ getChallenge()

◆ getData()

◆ getDataList() [1/3]

◆ getDataList() [2/3]

◆ getDataList() [3/3]

◆ getResponse()

◆ internalAuthenticate()

◆ putData()

◆ readBinary()

◆ readRecords()

◆ removeApplication() [1/2]

◆ removeApplication() [2/2]

◆ selectFile() [1/4]

◆ selectFile() [2/4]

◆ selectFile() [3/4]

◆ selectFile() [4/4]

◆ updateBinary()

◆ writeBinary()