In a previous article "
Identifying a reader model" I described a proposal for the PC/SC workgroup to uniquely identify a (USB) reader.
History
The proposal was accepted at the
November 2011 meeting.
I added the needed
#define in
pcsc-lite version 1.8.3 I just released 2 days ago. The support is also added in my
CCID driver and a release is expected soon.
You can find sample code using the new feature in
PCSC/UnitaryTests/ directory with
FEATURE_CCID_ESC_COMMAND_Xiring.py.
Source code
The code is:
#! /usr/bin/env python
"""
# FEATURE_CCID_ESC_COMMAND_Xiring.py: Unitary test for
# FEATURE_CCID_ESC_COMMAND
# Copyright (C) 2012 Ludovic Rousseau
"""
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 3 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License along
# with this program; if not, see <http://www.gnu.org/licenses/>.
# You have to enable the use of Escape commands with the
# DRIVER_OPTION_CCID_EXCHANGE_AUTHORIZED bit in the ifdDriverOptions
# option of the CCID driver Info.plist file
from smartcard.System import readers
from smartcard.pcsc.PCSCPart10 import (getFeatureRequest, hasFeature,
getTlvProperties, FEATURE_CCID_ESC_COMMAND, SCARD_SHARE_DIRECT)
# use the first reader
card_connection = readers()[0].createConnection()
card_connection.connect(mode=SCARD_SHARE_DIRECT)
# get CCID Escape control code
feature_list = getFeatureRequest(card_connection)
ccid_esc_command = hasFeature(feature_list, FEATURE_CCID_ESC_COMMAND)
if ccid_esc_command is None:
raise Exception("The reader does not support FEATURE_CCID_ESC_COMMAND")
# get the TLV PROPERTIES
tlv = getTlvProperties(card_connection)
# check we are using a Xiring Leo v1 or v2 reader
if tlv['PCSCv2_PART10_PROPERTY_wIdVendor'] == 0x0F14 \
and (tlv['PCSCv2_PART10_PROPERTY_wIdProduct'] in [0x0037, 0x0038]):
# proprietary escape command for Xiring Leo readers
version = [ord(c) for c in "VERSION"]
res = card_connection.control(ccid_esc_command, version)
print res
print "VERSION:", ''.join([chr(x) for x in res])
serial = [ord(c) for c in "GET_SN"]
res = card_connection.control(ccid_esc_command, serial)
print res
print "GET_SN:", ''.join([chr(x) for x in res])
else:
print "Xiring Leo reader not found"
Comments
Compared to the example in example in "Identifying a reader model" the name are
PCSCv2_PART10_PROPERTY_wIdVendor and
PCSCv2_PART10_PROPERTY_wIdProduct instead of
PCSCv2_PART10_PROPERTY_idVendor and
PCSCv2_PART10_PROPERTY_idProduct. A "w" has been added to suggest a (windows) word type (16 bits).
The names have also been added in
pyscard (the
PC/SC Python wrapper) in revision
590. But I have no idea of when a new stable version of pyscard will be released.
Conclusion
It is now/soon possible to identify a reader model before sending a, possibly, dangerous command if sent to another reader.
Since the Escape commands are dangerous by default, they are disabled in the CCID driver. You will need to edit the Info.plist file and change the value of ifdDriverOptions to add the DRIVER_OPTION_CCID_EXCHANGE_AUTHORIZED bit.
