The ISO7816 commands base class. More...

#include <iso7816iso7816commands.hpp>

Inheritance diagram for logicalaccess::ISO7816ISO7816Commands:

Public Member Functions
	ISO7816ISO7816Commands ()
	Constructor.

	ISO7816ISO7816Commands (std::string)

virtual	~ISO7816ISO7816Commands ()
	Destructor.

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

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

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

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

ByteVector	getData (unsigned short dataObject, size_t length) override
	Get data.

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

void	putData (const ByteVector &data, unsigned short dataObject) override
	Put data.

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

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

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

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

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

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

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

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

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

ByteVector	generalAuthenticate_challenge (unsigned char algorithm, bool globalReference, unsigned char keyno) override

ByteVector	generalAuthenticate_response (unsigned char algorithm, bool globalReference, unsigned char keyno, const ByteVector &data) override

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

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

std::shared_ptr< ISO7816ReaderCardAdapter >	getISO7816ReaderCardAdapter () const
	Get the ISO7816 reader/card adapter.

Public Member Functions inherited from logicalaccess::ISO7816Commands
	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.

Static Protected Member Functions
static void	setP1P2 (size_t offset, unsigned short efid, unsigned char &p1, unsigned char &p2)
	Set P1 and P2 parameters.

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 base class.

Constructor & Destructor Documentation

◆ ISO7816ISO7816Commands() [1/2]

logicalaccess::ISO7816ISO7816Commands::ISO7816ISO7816Commands ( )

Constructor.

◆ ISO7816ISO7816Commands() [2/2]

logicalaccess::ISO7816ISO7816Commands::ISO7816ISO7816Commands ( std::string ct )

explicit

◆ ~ISO7816ISO7816Commands()

logicalaccess::ISO7816ISO7816Commands::~ISO7816ISO7816Commands ( )

virtual

Destructor.

Member Function Documentation

◆ appendrecord()

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

overridevirtual

Append a record to a file.

Parameters

data	The record data
fid	The FID

Implements logicalaccess::ISO7816Commands.

◆ applicationManagementRequest()

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

overridevirtual

Implements logicalaccess::ISO7816Commands.

◆ eraseBinary()

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

overridevirtual

Erase binary data.

Parameters

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

Returns: True on success, false otherwise.

Implements logicalaccess::ISO7816Commands.

◆ externalAuthenticate() [1/2]

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

overridevirtual

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.

Implements logicalaccess::ISO7816Commands.

◆ externalAuthenticate() [2/2]

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

overridevirtual

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.

Implements logicalaccess::ISO7816Commands.

◆ generalAuthenticate()

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

overridevirtual

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.

Implements logicalaccess::ISO7816Commands.

◆ generalAuthenticate_challenge()

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

overridevirtual

Implements logicalaccess::ISO7816Commands.

◆ generalAuthenticate_response()

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

overridevirtual

Implements logicalaccess::ISO7816Commands.

◆ getChallenge()

ByteVector logicalaccess::ISO7816ISO7816Commands::getChallenge ( unsigned int length = 8 )

overridevirtual

Get the ISO challenge for authentication.

Parameters

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

Returns: The ISO challenge.

Implements logicalaccess::ISO7816Commands.

◆ getData()

ByteVector logicalaccess::ISO7816ISO7816Commands::getData	(	unsigned short	dataObject,
		size_t	length
	)

overridevirtual

Get data.

Parameters

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

Returns: True on success, false otherwise.

Implements logicalaccess::ISO7816Commands.

◆ getDataList()

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

overridevirtual

Get data.

Parameters

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

Returns: The data of the object.

Implements logicalaccess::ISO7816Commands.

◆ getISO7816ReaderCardAdapter()

std::shared_ptr< ISO7816ReaderCardAdapter > logicalaccess::ISO7816ISO7816Commands::getISO7816ReaderCardAdapter ( ) const

inline

Get the ISO7816 reader/card adapter.

Returns: The ISO7816 reader/card adapter.

◆ getResponse()

ByteVector logicalaccess::ISO7816ISO7816Commands::getResponse ( unsigned char maxlength = 0 )

overridevirtual

Get response.

Parameters

maxlength The maximum expected length.

Returns: The response data.

Implements logicalaccess::ISO7816Commands.

◆ internalAuthenticate()

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

overridevirtual

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.

Implements logicalaccess::ISO7816Commands.

◆ putData()

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

overridevirtual

Put data.

Parameters

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

Returns: True on success, false otherwise.

Implements logicalaccess::ISO7816Commands.

◆ readBinary()

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

overridevirtual

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.

Implements logicalaccess::ISO7816Commands.

◆ readRecords()

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

overridevirtual

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

Implements logicalaccess::ISO7816Commands.

◆ removeApplication()

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

overridevirtual

Implements logicalaccess::ISO7816Commands.

◆ selectFile()

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

overridevirtual

Select a file.

Parameters

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

Implements logicalaccess::ISO7816Commands.

◆ setP1P2()

void logicalaccess::ISO7816ISO7816Commands::setP1P2	(	size_t	offset,
		unsigned short	efid,
		unsigned char &	p1,
		unsigned char &	p2
	)

staticprotected

Set P1 and P2 parameters.

Parameters

offset	The starting offset.
efid	The EF identifier.
p1	The parameter 1.
p2	The parameter 2.

◆ updateBinary()

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

overridevirtual

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.

Returns: True on success, false otherwise.

Implements logicalaccess::ISO7816Commands.

◆ writeBinary()

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

overridevirtual

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.

Returns: True on success, false otherwise.

Implements logicalaccess::ISO7816Commands.

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

C:/dev/lla/liblogicalaccess/plugins/logicalaccess/plugins/readers/iso7816/commands/iso7816iso7816commands.hpp
C:/dev/lla/liblogicalaccess/plugins/logicalaccess/plugins/readers/iso7816/commands/iso7816iso7816commands.cpp

Public Member Functions

Static Protected Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ ISO7816ISO7816Commands() [1/2]

◆ ISO7816ISO7816Commands() [2/2]

◆ ~ISO7816ISO7816Commands()

Member Function Documentation

◆ appendrecord()

◆ applicationManagementRequest()

◆ eraseBinary()

◆ externalAuthenticate() [1/2]

◆ externalAuthenticate() [2/2]

◆ generalAuthenticate()

◆ generalAuthenticate_challenge()

◆ generalAuthenticate_response()

◆ getChallenge()

◆ getData()

◆ getDataList()

◆ getISO7816ReaderCardAdapter()

◆ getResponse()

◆ internalAuthenticate()

◆ putData()

◆ readBinary()

◆ readRecords()

◆ removeApplication()

◆ selectFile()

◆ setP1P2()

◆ updateBinary()

◆ writeBinary()