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

От Infonotary
Направо към навигацията Направо към търсенето
Редакция без резюме
 
(Не са показани 189 междинни версии от 5 потребители)
Ред 1: Ред 1:
== Обща информация ==
== Какво е необходимо за работа с електронен подпис ==
На няколко места в това ръководство пише че трябва да пуснете дадена команда от Terminal. Можете да стартирате Terminal от Applications/Utilities или като напишете Terminal в Spotlight.
За да използвате вашият квалифициран електронен подпис (КЕП), е необходимо да имате инсталиран драйвер за четеца, middleware за картата (OpenSC или Bit4id Universal Middleware) и услугата за работа с четци (pcscd) да работи. услугата за работа с четци би трябвало да се стартира автоматично при включване на четеца.


Текстът написан с ''наклонен шрифт'' е обяснение на някои специфични настройки или възможности. Освен ако не използвате много необичаен софтуер или хардуер няма нужда да ги четете.
<!--== Системни изисквания ==
Софтуерът, нужен за работа на удостоверението за квалифициран електронен подпис на Mac, поддържа само Mac OS X 10.5 или по-нова версия.


Текстът {{Шаблон:Console|изписан по този начин}} са команди които трябва да въведете от Terminal. Не се налага да ги пишете, можете просто да ги копирате и поставяте директно чрез клипборд-а. За да работят коректно командите които започват със '''sudo''' е необходимо да имате парола за достъп до компютъра. Ако нямате такава може да зададете временна докато правите настройките, след което да я махнете. След като пуснете такава команда системата може да ви пита за паролата ви. При въвеждането на паролата няма да се покажат звездичики или някакви други символи. След като я въведете трябва да натиснете клавиша return.
Поддръжката за 10.5 е само частична. Всички необходими драйвери работят на тази версия, но не и софтуера на Инфонотари за подписване на документи и управление на смарт картата.
-->
== Драйвери за четци ==
=== ACR ===
[[Картинка:ACR_38T.png]]
 
Ако вашият четец е означен с '''ACR38C-SPC-R''', '''mLector-S''' или '''ACR39T''' от долната си страна, то той работи с вградените в macOS драйвери за четци и не се налага инсталация на допълнителен драйвер.
 
=== Circle CIR115 ===


Текстът написан с '''удебелен шрифт''' указва неща на които трябва да се обърне внимание.
За да можете да ползвате четците Circle, ще трябва да инсталирате драйвер на производителя за вашата версия на macOS:
* За [http://repository.infonotary.com/ra/Circle_Mac_Installer_v2.1.2.zip macOS 11 и по-нови].


Използвани съкращения и тяхното значение:
=== Omnikey (HID Global) ===


* УЕП (универсален електронен подпис).
[[Картинка:CardMan6121.gif]]<!--[[Картинка:CardMan3021.png]]-->
* SCA (Smart card for Apple) – това е името на версията на OpenSC за Mac OS X.
* pcscd (PCSC smart card service) – това е софтуера чрез който програмите осъществяват достъп до четеца и съответно смарт картата.


{{Шаблон:Недовършено ръководство|left|Mac OS X|Ръководство%20за%20Mac%20OS%20X}}
За да можете да ползвате четците OmniKey CardMan, ще трябва да инсталирате драйвер на производителя за вашата версия на macOS:
* За [https://repository.infonotary.com/ra/install/omnikey-macos-installer.dmg '''macOS 10.14 - 10.15'''].
* За [https://repository.infonotary.com/ra/install/omnikey-macos-installer.pkg '''macOS 11 и по-нови'''].


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


== Драйвери за четци ==
В зависимост от това, каква е Вашата смарт карта се използва различен драйвер. Моделът на картата Ви е изписан на персоналните права за достъп, които сте получили заедно с картата. Може да разберете модела на Вашата смарт карта и чрез нашата  [http://repository.infonotary.com/install/sysinfo/SystemInfo.dmg програма за диагностика]
=== Omnikey ===


[[Картинка:CardMan6121.gif]][[Картинка:CardMan3021.png]]


За да можете да ползвате четците на OmniKey CardMan ще трябва да инсталирате драйвера на производителя. В зависимост от версията на Mac OS X, която ползвате се инсталира следното:
<!--В зависимост от това, каква е вашата карта се използва различен софтуер. Моделът на картата ви е изписан на персоналните права за достъп, които сте получили заедно с картата. В случай че за модел пише „'''T&S DS/2048 (L)'''“, трябва да инсталирате [[#Инсталиране на Bit4id Universal Middleware|Bit4id Universal Middleware]]. Ако моделът на картата е „'''CardOS V4.3B (C)'''“, ще трябва да инсталирате [[#Изтегляне и инсталация на OpenSC|OpenSC]].
* [http://www.hidglobal.com/drivers/omnikey/ifdokccid_mac_10.5_i386-3.0.2.dmg PC/SC драйвер за Mac OS X 10.5]
* [http://www.hidglobal.com/drivers/omnikey/ifdokccid_mac_10.6_i386-3.0.2.dmg PC/SC драйвер за Mac OS X 10.6]


Ако ползвате OMNIKEY 6121 е препоръчително да инсталирате и тази добавка към драйвера:
В случай че не разполагате с персоналните права за достъп, може да разберете какъв е модела на картата с командата {{Шаблон:Console|pcsctest}} от терминал. Тя ще ви пита два пъти за номер на четец, трябва да въведете 1, за първият. Ако няма сериозен проблем с инсталацията на драйверите за четец, в изхода на командата ще има ред започващ с „Current Reader ATR Value“. Срещу този текст трябва да има дълъг 16-тичен номер, това е идентификатора на модела на картата.
* [http://www.hidglobal.com/drivers/omnikey/ifdhpe6121_mac_intel-1.0.0.dmg OMNIKEY 6121 Hotplug-Enabler за Mac OS X 10.5]
* За картите T&S DS/2048 идентификатора е „3B FF 18 00 FF 81 31 FE 55 00 6B 02 09 03 03 01 11 01 43 4E 53 11 31 80 8C“.
* [http://www.hidglobal.com/drivers/omnikey/ifdhpe6121_mac_intel_x64-1.0.0.dmg OMNIKEY 6121 Hotplug-Enabler за Mac OS X 10.6]
* За картите CardOS V4.3 идентификатора е „3B F2 18 00 02 C1 0A 31 FE 58 C8 08 74“.
-->


=== ACS ===
=== За смарт карта IDPrime ===
Може да изтеглите последната версия за Вашата операционна система от тук:
* За [https://repository.infonotary.com/ra/Middleware/SafeNet/macOS/SafeNetAuthenticationClient.10.8.267.0_Core.dmg '''macOS 11 и по-нови''']


[[Картинка:ACR_38U.png]][[Картинка:ACR_38T.png]]
След инсталацията може да преминете към конфигурирането на [[Използване на квалифициран електронен подпис в Mozilla Firefox за Mac OS X|'''Firefox''']] или [[Инсталиране на удостоверителната верига на Инфонотари в Mac OS X|'''Safari''']].


==== ACR 38 ====


Четците на смарт карти ACR 38 не са съвместими със вграденият в Mac OS X драйвер за четци, така че ако използвате такъв четец ще трябва да си инсталирате драйвер от [http://www.acs.com.hk/drivers-manual.php?driver=ACR38 сайта на производителя].
=== За смарт карта Bit4ID/Idemia ===
Може да изтеглите последната версия за Вашата операционна система от тук:
* За [http://repository.infonotary.com/ra/bit4id-middleware-pinpad-1.4.10.707.dmg '''macOS 11 и по-нови''']
<!--* За [http://repository.infonotary.com/ra/bit4id-MAC_OS-middleware-pinpad-1.4.9.395.dmg '''macOS 10.9 - 10.14'''].-->


==== ACR 38C ====
След инсталацията може да преминете към конфигурирането на [[Използване на квалифициран електронен подпис в Mozilla Firefox за Mac OS X|'''Firefox''']] или [[Инсталиране на удостоверителната верига на Инфонотари в Mac OS X|'''Safari''']].


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


== Изтегляне и инсталация на OpenSC ==
За да можете да използвате вашият електронен подпис под OSX трябва да инсталирате OpenSC, който съдържа драйвер за смарт картата. '''С OpenSC не се инсталират програми с графичен интерфейс, така че след като го инсталирате няма да видите нови икони в папката Applications'''. Последната стабилна версия на инсталационният пакет (0.2.7) можете да изтеглите от [http://www.opensc-project.org/files/sca/sca-0.2.7.dmg сайта на проекта]. '''В случай че ползвате Mac OS X 10.5 ще трябва да направите няколко настройки по време на инсталацията:'''


За да не се налага да стартирате ръчно pcscd (софтуера за работа с четци) трябва по време на инсталацията, на стъпка „Instalation Type“, да изберете „Customize“ както е показано на тази снимка:<br/><br/> [[Картинка:Install_MacOSX_OpenSC.png]] <br/><br/> След което да изберете „Smartcard reader autostart fix“, и да натиснете бутона „Install“: <br/><br/> [[Картинка:Install_MacOSX_OpenSC_Customize.png]]
=== За смарт карта Siemens CardOS ===
За смарт карти Siemens, трябва да инсталирате OpenSC. '''С OpenSC не се инсталират програми с графичен интерфейс, така че след като го инсталирате, няма да видите нови икони в папката Applications'''.  


След инсталацията да зададете коректните права на файла за автоматично стартиране на pcscd като изпълните следната команда:<br/> {{Template:Console|sudo chmod 644 /Library/LaunchDaemons/org.opensc.pcscd.autostart}} . След това трябва да рестартирате компютъра за да се стартира pcscd.
Може да изтеглите последната версия за Вашата операционна система от тук:
* За [https://github.com/OpenSC/OpenSC/releases/download/0.21.0/OpenSC-0.21.0.dmg '''macOS 11 и по-нови''']
<!--* За [https://repository.infonotary.com/install/mac/OpenSC-0.16.0.dmg '''macOS 10.9 - 10.14'''].-->


=== Ръчно стартиране на pcscd ===
След инсталацията на OpenSC може да преминете директно към конфигурирането на [[Използване на квалифициран електронен подпис в Mozilla Firefox за Mac OS X|Firefox]] или [[Инсталиране на удостоверителната верига на Инфонотари в Mac OS X|Safari]].


В случай че не искате pcscd да работи посточнно можете да го стартирате ръчно pcscd със следната команда {{Template:Console|sudo /usr/sbin/pcscd -f}} и след приключване на работата да го спирате с клавишната комбинация Control+C.
<!--=== Едновременно използване на OpenSC и Bit4id Universal Middleware ===
В случай че искате да използвате и двата модела смарт карти на един компютър ще трябва да забраните на OpenSC да достъпва T&S DS/2048 картата. Това най-лесно може да стане чрез тази програма:
:[https://repository.infonotary.com/install/mac/FixOpenSC.app.tar.gz Забраняване на Bit4id картите в OpenSC].


=== Конфигуриране на OpenSC ===
Ако предпочитате да го направите ръчно, на [[Работа с OpenSC#.D0.97.D0.B0.D0.B1.D1.80.D0.B0.D0.BD.D1.8F.D0.B2.D0.B0.D0.BD.D0.B5_.D0.BD.D0.B0_OpenSC_.D0.B4.D0.B0_.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D0.B8_.D1.81_.D0.BE.D0.BF.D1.80.D0.B5.D0.B4.D0.B5.D0.BB.D0.B5.D0.BD.D0.B0_.D1.81.D0.BC.D0.B0.D1.80.D1.82_.D0.BA.D0.B0.D1.80.D1.82.D0.B0 | страницата за OpenSC]] е описано как се прави.
За да не ви пита Firefox и другите програми използващи pkcs#11 за Secondary Authentication PIN, какъвто няма зададен на картата ( точното съобщение на Firefox e „Please enter master password for InfoNotary (Secondary Authentica“ ) трябва да редактирате конфигурационният файл на SCA. За целта със следната команда можете да го отворите в TextEdit:<br/>
Това най-лесно може да стане като замените конфигурационният файл на OpenSC (/Library/OpenSC/etc/opensc.conf) с [https://repository.infonotary.com/install/mac/opensc.conf този].-->
{{Шаблон:Console|sudo /Applications/TextEdit.app/Contents/MacOS/TextEdit /Library/OpenSC/etc/opensc.conf}}<br/>
В него трябва да добавите „num_slots = 1;“ на следващият ред след този текст:<pre>app "opensc-pkcs11" {
pkcs11  {
</pre>
Би трябвало да се получи следното:<pre>app "opensc-pkcs11" {
pkcs11  {
num_slots = 1;</pre>
След това трябва да запишете файла.


== Проверка на инсталацията ==
== Проверка на инсталацията ==
След като инсталирате SCA и рестартирате компютъра си може да проверите дали четеца и картата се разпознават със следните команди от Terminal ('''четецът трябва да е включен в компютъра и картата да е поставена в него преди да пускате тестовете'''):<br />
В случай че имате проблем с вашият КЕП, за по-лесно установяване на проблема може да използвате следната програма:
1) {{Шаблон:Console|ps ax &#124; grep pcscd &#124; grep -v "grep pcscd"}} - тази команда проверява дали работи pcscd. Би трябвало да получите изход подобен на този:<pre>2440 ?        Ssl    0:00 /usr/sbin/pcscd -f</pre>
 
В случай че не покаже нищо има проблем при инсталацията. Най-вероятната причина за това е некоректни права върху файла за автоматично стартиране. За да се справите с проблема ще трябва да включите опцията „Smartcard reader autostart fix“ при инсталацията на [[#Изтегляне и инсталация на OpenSC | OpenSC]] и съответно да зададете правилните права за файла чрез следната команда -
* [https://repository.infonotary.com/install/sysinfo/SystemInfo.dmg Тест на инсталацията за Mac]
{{Template:Console|sudo chmod 644 /Library/LaunchDaemons/org.opensc.pcscd.autostart}}<br />
 
2) {{Шаблон:Console|/Library/OpenSC/bin/opensc-tool -l}} - тази команда ще покаже списък с всички включени в компютъра четци. Би трябвало да изведе нещо подобно:<pre>Readers known about:
Програмата поддържа директно изпращане на информацията към Инфонотари. След успешно изпращане, тя ще покаже номер, който ще трябва да предоставите на колегите от поддръжката за да могат да видят резултатите от теста. В случай че пращането е неуспешно или нямате връзка с Интернет, може да запишете резултата от теста във файл и да го изпратите на [mailto:support@infonotary.com?Subject=%D0%9F%D1%80%D0%BE%D0%B1%D0%BB%D0%B5%D0%BC%20%D1%81%20%D0%B8%D0%BD%D1%81%D1%82%D0%B0%D0%BB%D0%B0%D1%86%D0%B8%D1%8F%D1%82%D0%B0%20%D0%BD%D0%B0%20Mac%20OS%20X support@infonotary.com].
Nr.    Driver    Name
 
0      pcsc      OMNIKEY CardMan 6121 0</pre>
Желателно е четецът с картата да са включени в компютъра при пускането на теста.
3) {{Шаблон:Console|/Library/OpenSC/bin/opensc-tool -n}} - с тази команда можете да проверите дали картата ви се разпознава коректно. Ако всичко е наред би трябвало да се изпише „CardOS M4“. Ако получите грешка завършваща на „Failed to connect to card: Unresponsive card (correctly inserted?)“, най-вероятно картата ви е поставена наопаки в четеца.
<!--
При проблеми в работата на електронният подпис може да стартирате следната програма '''с включен четец''' и да изпратите текста, който ще покаже, '''заедно с кратко описание на проблема''' на [mailto:support@infonotary.com?Subject=%D0%9F%D1%80%D0%BE%D0%B1%D0%BB%D0%B5%D0%BC%20%D1%81%20%D0%B8%D0%BD%D1%81%D1%82%D0%B0%D0%BB%D0%B0%D1%86%D0%B8%D1%8F%D1%82%D0%B0%20%D0%BD%D0%B0%20Mac%20OS%20X support@infonotary.com]:
* [https://repository.infonotary.com/install/mac/TestInstallation.app.tar.gz Програма за тестване на инсталацията] за OS X 10.6 и по-нови.
->
 
== Ръчно пускане и спиране на pcscd ==
На Mac OS X pcscd се стартира от securityd при включване на четец за смарт карти. В случай че искате да забраните автоматичното пускане трябва да редактирате файла /System/Library/LaunchDaemons/com.apple.securityd.plist. В него трябва да добавите оцветените редове:
<string>/usr/sbin/securityd</string>
<string>-i</string>
{{Color|<string>-s</string>|black|orange}}
{{Color|<string>off</string>|black|orange}}


== Деинсталиране ==
След това трябва да рестартирате компютъра.
Можете да деинсталирате SCA чрез следната команда - {{Шаблон:Console|sudo /Library/OpenSC/bin/opensc-uninstall}} .


== Документация ==
За да стартирате pcscd ръчно трябва да срартирате следната команда от терминал: {{Шаблон:Console|sudo /usr/sbin/pcscd -f}}. Когато демона е стартиран по този начин, за да го спрете трябва да натиснете клавишната комбинация Contorl + C или от друг прозорец на терминала да пуснете командата {{Шаблон:Console|sudo killall pcscd}}.
Документацията на SCA е налична в [http://www.opensc-project.org/sca/ Интернет] и в папката /Library/OpenSC/doc/ след инсталация.


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


[[Категория:Инсталация и използване на удостоверения за електронен подпис]]
[[Категория:Инсталация и използване на удостоверения за електронен подпис]]
[[Категория:Mac OS X]]
[[Категория:macOS]]
[[Категория:Помощ]]
[[Категория:Помощ]]

Текуща версия към 10:28, 7 септември 2023

Какво е необходимо за работа с електронен подпис

За да използвате вашият квалифициран електронен подпис (КЕП), е необходимо да имате инсталиран драйвер за четеца, middleware за картата (OpenSC или Bit4id Universal Middleware) и услугата за работа с четци (pcscd) да работи. услугата за работа с четци би трябвало да се стартира автоматично при включване на четеца.

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

ACR

ACR 38T.png

Ако вашият четец е означен с ACR38C-SPC-R, mLector-S или ACR39T от долната си страна, то той работи с вградените в macOS драйвери за четци и не се налага инсталация на допълнителен драйвер.

Circle CIR115

За да можете да ползвате четците Circle, ще трябва да инсталирате драйвер на производителя за вашата версия на macOS:

Omnikey (HID Global)

CardMan6121.gif

За да можете да ползвате четците OmniKey CardMan, ще трябва да инсталирате драйвер на производителя за вашата версия на macOS:

Инсталиране на драйвер за смарт карта

В зависимост от това, каква е Вашата смарт карта се използва различен драйвер. Моделът на картата Ви е изписан на персоналните права за достъп, които сте получили заедно с картата. Може да разберете модела на Вашата смарт карта и чрез нашата програма за диагностика


За смарт карта IDPrime

Може да изтеглите последната версия за Вашата операционна система от тук:

След инсталацията може да преминете към конфигурирането на Firefox или Safari.


За смарт карта Bit4ID/Idemia

Може да изтеглите последната версия за Вашата операционна система от тук:

След инсталацията може да преминете към конфигурирането на Firefox или Safari.


За смарт карта Siemens CardOS

За смарт карти Siemens, трябва да инсталирате OpenSC. С OpenSC не се инсталират програми с графичен интерфейс, така че след като го инсталирате, няма да видите нови икони в папката Applications.

Може да изтеглите последната версия за Вашата операционна система от тук:

След инсталацията на OpenSC може да преминете директно към конфигурирането на Firefox или Safari.


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

В случай че имате проблем с вашият КЕП, за по-лесно установяване на проблема може да използвате следната програма:

Програмата поддържа директно изпращане на информацията към Инфонотари. След успешно изпращане, тя ще покаже номер, който ще трябва да предоставите на колегите от поддръжката за да могат да видят резултатите от теста. В случай че пращането е неуспешно или нямате връзка с Интернет, може да запишете резултата от теста във файл и да го изпратите на support@infonotary.com.

Желателно е четецът с картата да са включени в компютъра при пускането на теста.

Взето от „http://wiki.infonotary.com/index.php?title=Инсталация_на_драйвери_за_четец_и_смарт_карта_в_macOS&oldid=2614“.