New version of pcsc-lite: 1.8.20

I just released a new version of pcsc-lite 1.8.20.
pcsc-lite is a Free Software implementation of the PC/SC (or WinSCard) API for Unix systems.

Changes:
1.8.20: Ludovic Rousseau
30 December 2016

• Fix a crash and potential security issue in pcscd

ATR statistics: TB2 - Global, deprecated

Article from the series "ATR statistics"

TB2 - Global, deprecated

The ISO 7816-3 specification is not public. So I can't copy/paste part of the text. I will use Wikipedia instead.

From Wikipedia https://en.wikipedia.org/wiki/Answer_to_reset#Interface_byte_TB2

TB₂, if present, is global. The usage of TB₂ is deprecated since the 2006 edition of the standard, which prescribes that cards should not include TB₂ in the ATR, and readers shall ignore TB₂ if present.

In the 1997 edition of the standard, TB₂ (8th to 1st bit) encode PI2, which when in range 50..250 (other values being RFU) encode V_PP in increments of 0.1 V, and subsumes the coarser indication given by PI1 of TB₁. Refer to that section for why modern Smart Cards have no use of V_PP, and thus of TB₂.

Historical note: Provision for TB₂ did not exist in ISO/IEC 7816-3:1989, and was introduced because V_PP = 12.5 V became a popular value in EEPROM technology, replacing 25 V and 21 V.

TB2	#	%
	2070	99.90 %
0x3F	1	0.05 %
0x45	1	0.05 %

Only 2 cards use a TB₂ value.

• 3B FF 00 FF 81 31 00 45 65 63 00 00 00 00 00 00 00 00 00 00 00 00 00 00
• TB₂= 0x45 Programming param PI2 (PI1 should be ignored): 69 (dV)
• This card also has TB₁ = 0xFF Programming Param P: 31 Volts, I: RFU 
• 3F FF 3F 3F 3F 3F 00 3F 3F FF 3F 3F 3F 3F 3F FF 3F FF 95 3F FF 95 3F FF
• TB₂ = 0x3F Programming param PI2 (PI1 should be ignored): 63 (dV)
• This card also has TB₁ = 0x3F Programming Param P: 31 Volts, I: 50 milliAmperes  

I agree these 2 ATRs are quiet unusual.

ATR statistics: TA2 - Global, specific mode byte

Article from the series "ATR statistics"

TA2 - Global, specific mode byte

The ISO 7816-3 specification is not public. So I can't copy/paste part of the text. I will use Wikipedia instead.

From Wikipedia https://en.wikipedia.org/wiki/Answer_to_reset#Interface_byte_TA2

Interface byte TA₂, if present, is global, and is named the specific mode byte.

Presence of TA₂ commands that the reader use specific mode as defined by TA₂ and earlier global bytes, rather than negotiable mode when TA₂ is absent.

TA₂ encodes in its 4 low-order bits an integer T defining the protocol required by the card, in the convention used for TD₁ (EMV prescribes that a card which T encoded in TA₂ does not match that in TD₁ shall be rejected).

The 5th bit is 0 to encodes that the required ETU duration is F_i/D_i clock cycles as defined by TA₁ (or its default value if absent); or 1 to indicate that the ETU duration is implicitly known (by some convention, or setting of the reader; EMV prescribes that such card shall be rejected).

The 6th and 7th bit are reserved for future use; 0 indicates not used.

The 8th bit is 1 to indicate that the card is unable to change the negotiable/specific mode (that is, does not propose other settings); or 0 to indicate that card has that ability (perhaps after a warm ATR).

Historical note: Provision for specific mode did not exist in ISO/IEC 7816-3:1989. Back then, the interface character TA₂ had no particular name or function, and was specific (to the protocol introduced by TD₁). ISO/IEC 7816-3:1997 introduced the specific mode and the specific mode byte, with interim note helping cards with specific mode byte TA₂ in their ATR dealing with a reader that did not implement specific mode.

TA2	#	%
	1983	95.70 %
0x81	48	2.32 %
0x80	31	1.50 %
0x00	10	0.48 %

TA₂ is used by only 4.30% of cards. 95.70% of smart cards in my list have no TA₂ defined.

• 0x81 indicates "Protocol to be used in spec mode: T=1 - Unable to change - defined by interface bytes".
• The 4 low-order bits are set to 0001b so T=1 protocol.
• The 8th bit set to 1 to indicate unable to change the negotiable/specific mode
• 0x80 indicates "Protocol to be used in spec mode: T=0 - Unable to change - defined by interface bytes"
• The 4 low-order bits are set to 0000b so T=0 protocol.
• The 8th bit set to 1 to indicate unable to change the negotiable/specific mode
• 0x00 indicates "Protocol to be used in spec mode: T=0 - Capable to change - defined by interface bytes"
• The 4 low-order bits are set to 0000b so T=0 protocol.
• The 8th bit set to 0 to indicate the card is able to change the negotiable/specific mode

New version of pcsc-lite: 1.8.19

I just released a new version of pcsc-lite 1.8.19.
pcsc-lite is a Free Software implementation of the PC/SC (or WinSCard) API for Unix systems.

Changes:
1.8.19: Ludovic Rousseau
9 December 2016

• SCardGetStatusChange(): Fix a (rare) race condition
• Doxygen:
• SCardGetStatusChange() may return SCARD_E_UNKNOWN_READER
• SCardConnect() and SCardReconnect() will never return SCARD_E_NOT_READY
• pcsc-spy:
• fix display of execution time
• log the thread number in the results
• Some other minor improvements

macOS Sierra and pam_smartcard

In Sierra a new smart card component has been introduced: pam_smartcard. PAM is Pluggable Authentication Modules.

The source code is available at macOS 10.12 Source and is part of the pam_modules component.

pam_smartcard

The pam_smartcard(8) manage is:

pam_smartcard(8)          BSD System Manager's Manual         pam_smartcard(8)

NAME
     pam_smartcard -- Smartcard PAM module

SYNOPSIS
     [service-name] function-class control-flag pam_smartcard [options]

DESCRIPTION
     The Smartcard PAM module supports authentication function class.  In
     terms of the function-class parameter, this is ``auth.''

   The Smartcard Authentication Module
     This module permits or denies users based on smartcard authentication
     support in the Open Directory database, and the presence of an appropri-
     ate smartcard in the reader attached to the local machine. When a card is
     locked, the user is asked to unlock it with his PIN.

   The following options may be passed to this account management module:
     no_check_shell
             Continues evaluation even if user's shell is not valid. Normally,
             users with a shell like /usr/bin/false are considered as dis-
             abled.

EXAMPLE
     Adding the following line on the top of the /etc/pam.d/sudo enables smartcard support for sudo:
             auth   sufficient     pam_smartcard.so

SEE ALSO
     pam.conf(5), pam(8) SmartCardServices(7)

BSD                             August 27, 2015                            BSD

I guess this is related to the introduction of the native support of PIV cards in Sierra. See "macOS Sierra and PIVToken source code".

The pam_smartcard PAM module is used by two services by default:

• authorization_ctk
• screensaver_ctk

$ grep pam_smartcard /etc/pam.d/*
/etc/pam.d/authorization_ctk:auth       required       pam_smartcard.so  use_first_pass
/etc/pam.d/screensaver_ctk:auth       required       pam_smartcard.so  use_first_pass

$ cat /etc/pam.d/authorization_ctk 
# ctk: auth 
auth       required       pam_smartcard.so   use_first_pass
account    required       pam_opendirectory.so

$ cat /etc/pam.d/screensaver_ctk 
# ctk: auth 
auth       required       pam_smartcard.so  use_first_pass
account    required       pam_opendirectory.so
account    sufficient     pam_self.so
account    required       pam_group.so no_warn group=admin,wheel fail_safe
account    required       pam_group.so no_warn deny group=admin,wheel ruser fail_safe

SmartCardServices

Another interesting man page is SmartCardServices(7). Here is an extract:

SmartCardServices(7) BSD Miscellaneous Information Manual SmartCardServices(7)

NAME
     SmartCardServices -- overview of smart card support

DESCRIPTION
     SmartCardServices is a set of components for OS X smart card support.

     Any smart card which supports the PIV standard is supported natively by
     OS X. Access to smart card items is possible using the keychain inter-
     face. Applications can install additional drivers for smart cards that
     are not natively supported.

     Smart card certificates are automatically added to user's keychain when a
     smart card is inserted. Smart card certificates can be listed with
     security using the list-smartcards or export-smartcard commands. Keychain
     Access GUI cannot be used to manipulate or list these certificates.

SETUP
     To associate users with smart cards, the system can be set up for either
     fixed key mapping or attribute based mapping. For fixed key use
     sc_auth(8) or use the dialog which appears automatically when an unasso-
     ciated smartcard is inserted into a reader. This dialog can be globally
     suppressed by:

           sudo defaults write /Library/Preferences/com.apple.security.smartcard UserPairing -bool NO

     Attribute matching can be set up using the appropriate AttributeMapping
     section in the configuration file as described below. There is no default
     configuration. If no AttributeMapping exists or the configuration file is
     missing, attribute matching is not used. If both fixed key mapping and
     attribute mapping are able to associate the inserted smart card with a
     user, attribute mapping takes precedence.

     By default certificates do not need to be trusted to allow association.
     Certificate trust can be globally enforced by setting:

           sudo defaults write /Library/Preferences/com.apple.security.smartcard checkCertificateTrust -bool YES

[...]

PAM PKCS#11?

Since PAM is available in macOS maybe the PAM PKCS#11 module can be used without too much changes? This module is for GNU/Linux but may be adapted for macOS.

In this case, adding support for smart card login in macOS, if you already have a PKCS#11 library for your card, should be easy.

Conclusion

The use of smart card in macOS for high level services (like authentication) is easier in Sierra, at least for PIV smart cards.

I imagine that the support of other smart cards models will be proposed by third parties "soon".

macOS Sierra and smart card source code

Apple released the source code of the open source components they use in Sierra (OS X 10.12 released in September 2016). The components are available at OS X 10.12 Source.

As I did for El Capitan in "OS X El Capitan and smart card source code" I will document what I found.

The smart card related components are:

• SecurityTokend
• SmartcardCCID

See "macOS Sierra and smart cards status" for a general discussion of the changes in El Capitan.

SecurityTokend

The version changed from 55108 in El Capitan to 55111 in Sierra.

The changes are very limited:

• the Xcode project uses Security.framework
• 1 bug fixed "to prevent uninitialized value when following CALL ends with exception" according to the source code comment

diffstat:

 SecurityTokend-55111/SecurityTokend.xcodeproj/project.pbxproj    |    6 ++++++
 SecurityTokend-55111/lib/transition.cpp                          |    1 +
 SecurityTokend-55111/security_tokend_client/transition.cpp       |    1 +
 3 files changed, 8 insertions(+)

SmartcardCCID

The version changed from 55008.40.1 in El Capitan (10.11.4) to 55013 in Sierra.

Changes:

• CCID driver upgraded from 1.4.21 (released 21 October 2015) to 1.4.24 (released 22 May 2016)
• two Apple patches (RSA_SecurID_getpasswd.c.patch, scardcontrol.c.patch) are no more needed since the problem is fixed upstream

No change:

• the same libusb version 1.0.9 is used. This version was released in 2012-04-02. The latest libusb version is 1.0.21 released in 2016-10-01.
• the CCID driver provided by Apple has 4 patches. These patches are related to the way Apple builds the driver.

Conclusion

No disruptive changes this time.

The source code of CryptoTokenKit (introduced in Yosemite. See "OS X Yosemite BETA and smart cards status") is not provided. That is not surprising since this it is an Apple only component and not a fork of an existing free software.

OS X El Capitan and CCID evolution

In a previous blog article "OS X El Capitan and CCID driver upgrades" I mentioned the evolution of the CCID driver for the same major release of OS X 10.11.x.

With the availability of the source code at Apple Open Source it is easy to see what happened.

OS X Version	SmartcardCCID	CCID
10.11	SmartcardCCID-55008	1.4.14
10.11.1	SmartcardCCID-55008	1.4.14
10.11.2	SmartcardCCID-55008.20.1	1.4.20
10.11.3	SmartcardCCID-55008.20.1	1.4.20
10.11.4	SmartcardCCID-55008.40.1	1.4.21
10.11.5	SmartcardCCID-55008.40.1	1.4.21
10.11.6	SmartcardCCID-55008.40.1	1.4.21

I will try to closely follow the evolution of macOS Sierra (10.12) source code to avoid surprises in the future.