Инсталация на драйвери за четец и смарт карта в macOS

Обща информация

На няколко места в това ръководство пише че трябва да пуснете дадена команда от Terminal. Можете да стартирате Terminal от Applications/Utilities или като напишете Terminal в Spotlight.

Текстът написан с наклонен шрифт е обяснение на някои специфични настройки или възможности. Освен ако не използвате много необичаен софтуер или хардуер няма нужда да ги четете.

Текстът изписан по този начин са команди които трябва да въведете от Terminal. Не се налага да ги пишете, можете просто да ги копирате и поставяте директно чрез клипборд-а. За да работят коректно командите които започват със sudo е необходимо да имате парола за достъп до компютъра. Ако нямате такава може да зададете временна докато правите настройките, след което да я махнете. След като пуснете такава команда системата може да ви пита за паролата ви. При въвеждането на паролата няма да се покажат звездичики или някакви други символи. След като я въведете трябва да натиснете клавиша return.

Текстът написан с удебелен шрифт указва неща на които трябва да се обърне внимание.

Използвани съкращения и тяхното значение:

• УЕП (универсален електронен подпис).
• SCA (Smart card for Apple) – това е името на версията на OpenSC за Mac OS X.
• pcscd (PCSC smart card service) – това е софтуера чрез който програмите осъществяват достъп до четеца и съответно смарт картата.

Внимание

За работата с електроннен подпис под Mac OS X се използва софтуер и хардуер, които не са правени от Инфонотари и съответно ние нямаме контрол върху тях. Това е най-лесното ръководство, което сме успели да направим с ограничените си ресурси. Ако считате, че някоя част от него може да се продобри, моля пишете на support@infonotary.com с конкретно предложение. Всичко, което може да улесни процедурата, ще се появи тук веднага след като се уверим, че работи. Ако считате, че е прекалено трудно да се изпълнят няколкото команди от терминал, написани по долу, можете да си купите устройство (смарт карта и четец или токен) от някоя компания, предлагаща официална поддръжка за Mac OS X. В този случай обаче ние не можем да ви помогнем при евентуални проблеми.

Системни изисквания

• Софтуера нужен за работа на удостоверението за универсален електронен подпис на Mac поддържа само Mac OS X 10.5 или по-нова версия.

Драйвери за четци

Omnikey

За да можете да ползвате четците на OmniKey ще трябва да си инсталирате техният драйвер от сайта на производителя или от нашият сайт. Всички сертификати издавани от Инфонотари са с 2048 битов ключ, а вграденият в Mac OS X драйвер (ifd-ccid.bundle) не поддържа такава дължина на ключа.

За да се активира драйверът на OmniKey ще трябва да премахнете вграденият драйвер. Със следната команда можете да го преместите на десктопа за да не се зарежда:
H=$HOME; sudo mv /usr/libexec/SmartCardServices/drivers/ifd-ccid.bundle $H/Desktop
След това ако искате може да изтриете ifd-ccid.bundle от десктопа или да си го запазите някъде за всеки случай.

Вместо да го премахвате може и да изключите вашият четец от списъка с поддържаните от него четци като с текстов редактор или с Property List Editor премахнете от файла /usr/libexec/SmartCardServices/drivers/ifd-ccid.bundle/Contents/Info.plist описанието му - ifdVendorID e 076b, ifdProductID e 6622, a ifdFrendlyName e OmniKey CardMan 6121.

ACS

ACR 38

Четците на смарт карти ACR 38 не са съвместими със вграденият в Mac OS X драйвер за четци, така че ако използвате такъв четец ще трябва да си инсталирате драйвер от сайта на производителя.

ACR 38C

Ако вашият четец е означен с ACR38C-SPC-R от долната си страна, то той е CCID съвместим и няма нужда да се инсталира нищо допълнително.

Изтегляне и инсталация на OpenSC

За да можете да използвате вашият електронен подпис под OSX трябва да инсталирате OpenSC, който съдържа драйвер за смарт картата. С OpenSC не се инсталират програми с графичен интерфейс, така че след като го инсталирате няма да видите нови икони в папката Applications. Последната стабилна версия на инсталационният пакет (0.2.7) можете да изтеглите от сайта на проекта. В случай че ползвате Mac OS X 10.5 ще трябва да направите няколко настройки по време на инсталацията:

За да не се налага да стартирате ръчно pcscd (софтуера за работа с четци) трябва по време на инсталацията, на стъпка „Instalation Type“, да изберете „Customize“ както е показано на тази снимка:



След което да изберете „Smartcard reader autostart fix“, и да натиснете бутона „Install“:

След инсталацията да зададете коректните права на файла за автоматично стартиране на pcscd като изпълните следната команда:
sudo chmod 644 /Library/LaunchDaemons/org.opensc.pcscd.autostart . След това трябва да рестартирате компютъра за да се стартира pcscd.

Конфигуриране на OpenSC

За да не ви пита Firefox и другите програми използващи pkcs#11 за Secondary Authentication PIN, какъвто няма зададен на картата ( точното съобщение на Firefox e „Please enter master password for InfoNotary (Secondary Authentica“ ) трябва да редактирате конфигурационният файл на SCA. За целта със следната команда можете да го отворите в TextEdit:
sudo /Applications/TextEdit.app/Contents/MacOS/TextEdit /Library/OpenSC/etc/opensc.conf

В него трябва да добавите „num_slots = 1;“ на следващият ред след този текст:

app "opensc-pkcs11" {
	pkcs11  {

Би трябвало да се получи следното:

app "opensc-pkcs11" {
	pkcs11  {
		num_slots = 1;

След това трябва да запишете файла.

Проверка на инсталацията

След като инсталирате SCA и рестартирате компютъра си може да проверите дали четеца и картата се разпознават със следните команди от Terminal (четецът трябва да е включен в компютъра и картата да е поставена в него преди да пускате тестовете):

1) ps ax | grep pcscd | grep -v "grep pcscd" - тази команда проверява дали работи pcscd. Би трябвало да получите изход подобен на този:

2440 ?        Ssl    0:00 /usr/sbin/pcscd -f

В случай че не покаже нищо има проблем при инсталацията. Най-вероятната причина за това е некоректни права върху файла за автоматично стартиране. За да се справите с проблема ще трябва да включите опцията „Smartcard reader autostart fix“ при инсталацията на OpenSC и съответно да зададете правилните права за файла чрез следната команда - sudo chmod 644 /Library/LaunchDaemons/org.opensc.pcscd.autostart

2) /Library/OpenSC/bin/opensc-tool -l - тази команда ще покаже списък с всички включени в компютъра четци. Би трябвало да изведе нещо подобно:

Readers known about:
Nr.    Driver     Name
0      pcsc       OMNIKEY CardMan 6121 0

3) /Library/OpenSC/bin/opensc-tool -n - с тази команда можете да проверите дали картата ви се разпознава коректно. Ако всичко е наред би трябвало да се изпише „CardOS M4“. Ако получите грешка завършваща на „Failed to connect to card: Unresponsive card (correctly inserted?)“, най-вероятно картата ви е поставена наопаки в четеца.

Деинсталиране

Можете да деинсталирате SCA чрез следната команда - sudo /Library/OpenSC/bin/opensc-uninstall .

Документация

Документацията на SCA е налична в Интернет и в папката /Library/OpenSC/doc/ след инсталация.

На страница Работа с OpenSC можете да намерите кратка инстрикция за извършване на чай-често използваните опрации с OpenSC.