CCID free software driver

See the USB CCID and ICCD specifications from the USB working group.

Source download

Get released/stable versions

Go in the Download section. I provide .tar.bz2 archives ready to be built using:

The latest README is at README.md.

Get the current source code from git

If you are a C-language developper (or you know what you are doing), you can also access the git developement version. You may need to use the git version to support the latest added readers.

Main CCID/ICCD features supported

• Exchange levels
  • short APDU
  • extended APDU (with some limitations and lack of support from PC/SC)
  • TPDU
  • character
• card protocols
  • T=0
  • T=1
• Protocol Parameter Selection (PPS)
  • negociation made by the driver if needed
  • highest card/reader communication speed selected
  • specific mode supported
• multi-slot readers
• composite CCID devices
• PC/SC v2 part 10 features:
  • GET_FEATURE_REQUEST
  • secure PIN verify (FEATURE_VERIFY_PIN_DIRECT)
  • modify PIN entry (FEATURE_MODIFY_PIN_DIRECT)
  • reader PIN properties (FEATURE_IFD_PIN_PROPERTIES)
  • Multifunctional Card Terminal reader direct (FEATURE_MCT_READER_DIRECT)
  • retrieve reader properties in TLV form (FEATURE_GET_TLV_PROPERTIES)
    • bMinPINSize and bMaxPINSize: How to know the PIN sizes supported by a pinpad reader?
    • bEntryValidationCondition
    • bPPDUSupport
    • sFirmwareID
    • bTimeOut2
    • wLcdMaxCharacters and wLcdMaxLines
    • wLcdLayout
    • dwMaxAPDUDataSize
    • wIdVendor and wIdProduct
  • send CCID escape commands (FEATURE_CCID_ESC_COMMAND)
• Data rates list
• Localize LCD display messages (Gemalto GemPC PIN PAD, Covadis VГ©ga-Alpha)
• Extended APDU (for T=1 cards only and if your reader is in TPDU mode or extended APDU mode. For T=0 cards this is managed by the application itself.)
• SCardGetAttrib() attributes
• ICCD versions A and B
• USB selective suspend
• RAM consumption efficiency for embedded systems using —enable-embedded
• CCID descriptor statistics

CCID features not yet supported

• Manage suspend/resume (for example in a laptop)
• Reader clock frequency change

Contact me if you want to see the support of the above not yet supported features and you have a budget.

Non CCID features that I do not plan to support

In fact I may implement one of these features if you have a budget.

How to get support

If you have a problem and want to get support from me you shall include the following information:

Versions

• CCID driver version
• pcsc-lite version
• the output of the command » /usr/sbin/pcscd —version «

Platform

• Operating system or GNU/Linux distribution name and version
• Hardware details: Standard compatible PC, special board, Raspberry Pi, etc.
• Smart card middleware name and version
• Smart card reader manufacturer name and reader model name
• Smart card name

Then you shall generate a complete log (do not truncate it).

• If you need to enter the smart card PIN to reproduce the problem then consider changing your PIN before generating the logs as the PIN value will be included in the logs.
• Kill any running pcscd process
• (re)start pcscd exactly as described bellow:
• Stop pcscd (using Control-C) after the problem occured and send me the generated log.txt file

gdb backtrace

If you experience a crash of pcscd it is useful for me to have a backtrace.

Then copy/paste the complete output in your bug report.

Mailing list

If you have general questions or bug reports you should use the Pcsclite-muscle mailing list.

First search the mailing list archives. Maybe your probem has already been reported and solved. If you have not found a solution then subscribe to the Pcsclite-muscle mailing list and send your request to pcsclite-muscle@lists.infradead.org..

Check reader’s compliance to CCID specification

To know if a smart card reader is CCID compliant and should be supported by this driver but is not listed bellow

Just get the source code of this driver, install the build dependencies (see Build-Depends: for Debian systems) and do:

and send me (ludovic.rousseau@free.fr) the generated output.txt file.

If your reader is CCID compliant and you would like to add it to the list of readers I would also need:

• The URL of a web page describing the reader. Typically the web page of the reader description on the manufacturer web site.
• A picture of the reader. In general a picture is already available on the manufacturer web page described above.

CCID/ICCD readers

• Supported readers
• Should work readers
• Unsupported readers
• Disabled readers

All the readers are also included in a big matrix.

Reader selection

You can use an interactive reader selection tool at: Reader selection.

Authors

The main author is Ludovic Rousseau .

I reused source code from other free software projects whose authors are:

• Carlos Prados for the PPS and ATR parsing code (taken from his towitoto driver) in towitoko/ directory.
• Olaf Kirch for the T=1 TPDU code (from the OpenCT package) in openct/ directory. I (Ludovic Rousseau) greatly improved this code.

Licence

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.

This library 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 Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

Supported Operating Systems

GNU/Linux

GNU/Linux using libusb 1.0.x and later

Mac OS X

Apple includes my CCID driver (version 1.3.8, released in June 2008) since Leopard 10.5.6. See the mail from Shawn Geddis to have a list of changes.

Snow Leopard (10.6.x) and later

Mac OS X Snow Leopard (10.6) and later are supported without patches. To build the driver you need to extract the archive and do:

Leopard (10.5)

Mac OS X Leopard (10.5) is supported with a simple patch. To build the driver you need to extract the archive and do:

NOTE: The execution of ./MacOSX/configure will fail if you have a space character in your current working directory pathname.

NOTE: Apple’s version of pcsc-lite installed with Leopard has many bugs and problems.

Tiger (10.4)

Mac OS X Tiger (10.4) uses an old pcsc-lite with some problems:

• A missing call to IFDHSetProtocolParameters() so the reader is not configured correctly regarding to the card ATR.
• A wrong API for SCardControl() so you can’t use a pin pad reader or any other feature provided by SCardControl() .
• No way to generate a cold reset. Only a warm reset is possible. Uncomment the line #CFLAGS=»$CFLAGS -DFAKE_CARD_CHANGED» in MacOSX/configure to fake a card movement after a reset to simulate a cold reset. Note that SCardReconnect() will then fail with SCARD_W_REMOVED_CARD .

You can use this (now unmaintained) patch.

Solaris

The driver should work on Solaris.

I can’t test is myself so patches are welcome if needed.

You can find a PC/SC-lite package form Oracle.

FreeBSD

The driver is available in the freshport.

NetBSD (pkgsrc)

The driver is available in pkgsrc as security/ccid.

Other operating systems

It may or may not work.

Available binaries

The drivers are also available as packages libccid

Rutoken драйверы для моделей S, Lite и ECP

Установка Rutoken драйвера — первый шаг для начала работы с ключевым носителем семейства Рутокен. Специальный комплект ПО помогает операционной системе распознать подключенный USB-токен и обеспечивает корректное выполнение всех функций. В пакет вспомогательных программ входит панель управления, в которой можно менять настройки, выбирать криптопровайдера, смотреть сведения о сертификатах и ключевых парах цифровой подписи.

В этой статье расскажем, какие программные средства, используемые для аутентификации пользователей, а также для хранения сертификатов, ключей ЭП и других закрытых данных, нужны для носителей Рутокен. Подробно опишем все этапы работы с ПО — от загрузки до удаления.

Какое ПО необходимо для Rutoken S, Lite и ECP

Линейка носителей Рутокен включает базовые модели S, Lite и ECP(ЭЦП) 2.0, каждая из которых имеет несколько модификаций. Вспомогательные программы обязательны только для работы с носителем S, в то время как Lite и ECP 2.0 могут функционировать без предварительной настройки рабочего места. Но в некоторых случаях специальное ПО может потребоваться и для «автономных» моделей.

Rutoken S и Lite не имеют «вшитых» средств криптозащиты (СКЗИ), поэтому все операции выполняются через сторонние криптопровайдеры. Носитель Лайт отличается наличием поддержки CCID-driver, который присутствует по умолчанию у большинства версий ОС Microsoft Windows и MacOS. Благодаря этому преимуществу токен не нуждается во вспомогательном программном обеспечении, тогда как для модели S требуются специальные утилиты.

Наиболее защищенное устройство — ECP 2.0 — отличается от двух других наличием встроенных СКЗИ, благодаря которым все криптографические операции с закрытым ключом выполняются внутри USB-токена. Носитель сертифицирован ФСБ и ФСТЭК, а применяемые алгоритмы шифрования отвечают требованиям новых ГОСТ 2012 года (Р 34.10-2012 и Р 34.10-2012). Из всей линейки только этот токен может использоваться в ЕГАИС, для работы с которой необходимо специальное ПО.

Подпишись на наш канал в Яндекс Дзен — Онлайн-касса!
Получай первым горячие новости и лайфхаки!

Где и как скачать драйверы Rutoken

Актуальные версии утилит выложены на официальном сайте производителя — ЗАО «Актив-софт». Архивы с дистрибутивами и инструкции можно найти в разделе «Центр загрузки». Список бесплатного ПО представлен с левой стороны экрана. Для модели S необходимо скачать драйверы Rutoken для Windows, MacOS или *nix, для Рутокен ЭЦП 2.0 может потребоваться ПО для ЕГАИС.

Процесс скачивания EXE- или PKG-файла начнется автоматически, как только вы поставите галочку в «Лицензионном соглашении» и кликните по ссылке. Загрузка занимает несколько секунд. Для установки утилит на ПК необходимо иметь права администратора системы.

После завершения загрузки запустите установщик и выполните необходимые действия — введите пароль администратора ОС и нажимайте кнопки в процессе («Далее», «Установить», «Да» и «Закрыть»). Может потребоваться перезагрузка компьютера.

Важно: перед запуском инсталлятора закройте все работающие приложения и извлеките устройства из USB-портов. После завершения процесса вставьте носитель в разъем USB. Если на устройстве загорелся зеленый индикатор, значит все выполнено верно.

Как установить CCID для Rutoken Lite

Модель Rutoken Lite по умолчанию «воспринимается» операционными системами Windows и MacOS с поддержкой стандарта CCID (работа с контактными смарт-картами и USB-считывателями). Утилита входит в изначальный состав ОС либо инсталлируется автоматически при обновлении.

Если по каким-либо причинам средства системы не установили нужный пакет программ, попробуйте сделать это вручную. Как правило, такая проблема встречается в устаревших ОС Windows 2000, 2003 и XP SP2. Ручная установка CCID:

1. Зайдите в службу обновлений Microsoft через Internet Explorer.
2. Загрузите и установите ActiveX, нажав на область подтверждения, а затем на кнопку «Установить».
3. В строке поиска службы обновлений введите «Microsoft CCID» и кликните «Найти».
4. В появившемся списке выберите «Microsoft driver update for USB Smart Card reader» для определенной ОС Windows и нажмите «Добавить».
5. Нажмите на ссылку «Посмотреть корзину», которая появится в правом верхнем углу под строкой поиска.
6. На открывшейся странице нажмите «Загрузить». В окне «Параметры загрузки» выберите папку для загружаемого обновления, нажмите «Продолжить», а после завершения процесса — «Закрыть».
7. Найдите папку на ПК, откройте ее и дважды кликните по файлу с расширением .cab.
8. Извлеките файлы. Для этого кликните по ним правой клавишей мыши и нажмите «Извлечь», а затем выберите конечную папку на ПК и снова кликните «Извлечь».

1. Задай вопрос нашему специалисту в конце статьи.
2. Получи подробную консультацию и полное описание нюансов!
3. Или найди уже готовый ответ в комментариях наших читателей.

На втором этапе вставьте Рутокен в USB-разъем компьютера и установите CCID через «Мастер нового оборудования»:

1. В первом окне выберите «Нет, не в этот раз», чтобы отменить автоматическое подключение через службу обновлений.
2. Сузьте область поиска до конкретной папки, в которую был извлечен файл. Для этого во втором окне задайте параметр «Установка из указанного места», а в следующем — «Выполнить поиск в указанных местах».
3. Поставьте галочку рядом с «Включить следующие места поиска» и выберите папку из списка, нажав «Обзор».

Чтобы завершить установку, кликните «Далее» и «Готово».

Как обновить Rutoken Lite драйвер

Если при подключении Rutoken Lite появляется сообщение Windows об ошибке драйвера, проблема также решается вручную. В большинстве случаев система перестает «воспринимать» утилиту из-за отсутствия или повреждения компонентов и записей реестра, но в некоторых случаях причиной является устаревание версии ПО. Для восстановления корректной работы токена можно сделать следующее:

1. Зайдите в «Диспетчер устройств», выберите в соответствующей вкладке «Устройство чтения смарт-карт» и нажмите «Обновить драйверы». Поскольку обновление будет выполняться вручную, выберите соответствующие пункты «Выполнить поиск на этом компьютере» и «Установка с диска». Укажите путь к папке. Выберите «Устройство чтения смарт-карт», дождитесь завершения установки и нажмите «Закрыть».
2. Если первый способ не сработал, попробуйте удалить установленное ПО и установить более новую версию через службу обновления Windows. Последовательность действий мы уже описали в предыдущем разделе статьи.

Для удаления можно использовать программу Uninstall Tool.