4.2 Установка клиентских компонентов в ОС MS Windows

USB-токены и смарт-карты JaCartaУстановка и развёртываниеUSB-токены и смарт-карты JaCarta

О чём эта страница — установка ПК “Единый Клиент JaCarta®” в ОС семейства Microsoft Windows — обязательного базового компонента для большинства сценариев. Включает драйверы, PKCS#11-модули и Программу администрирования.

Назначение Единого Клиента

ПК “Единый Клиент JaCarta” — программное обеспечение, предназначенное для поддержки функций строгой двухфакторной аутентификации, настройки и работы с моделями USB-токенов и смарт-карт JaCarta. ПК “Единый Клиент JaCarta” объединяет в себе все необходимые компоненты для настройки и работы с USB-токенами и смарт-картами JaCarta:

Что входит	Зачем
Драйверы устройств	ОС видит JaCarta как устройство
PKCS#11-модули	Криптопровайдеры и приложения могут обращаться к JaCarta
АРМ администрирования	Базовые операции с токеном

Что проверить перед установкой

Перед установкой убедитесь, что выполнены следующие условия:

• Компьютер соответствует системным требованиям (поддерживаемая ОС, аппаратные средства, разрешение экрана).
• Используется ОС Microsoft Windows одной из поддерживаемых версий (полный перечень — в разделе “Поддерживаемые операционные системы”).
• Установка выполняется от имени учётной записи администратора.
• Дистрибутив получен из доверенного источника; при необходимости сверьте контрольные суммы исполняемых файлов с эталонными (см. “Средство многофакторной аутентификации MFA JaCarta-3. Формуляр”).

Осторожно

Меры предосторожности. Извлечение токена или смарт-карты во время записи или считывания информации может привести к выходу устройства из строя. Перед извлечением устройства обязательно дождитесь завершения операции.

Осторожно

Особенности Windows 7 / Server 2008 R2. При установке (начиная с версии 2.13) система запрашивает подтверждение установки драйверов. Чтобы избежать этого, предварительно установите обновления KB3033929 и KB2921916. При установке через групповые политики их предварительная установка строго обязательна.

Описание пакетов установки

Дистрибутив “Единый Клиент JaCarta” для Windows поставляется в виде пакетов установки формата .msi:

Файл	Назначение
JaCartaUnifiedClient_3.x.xxx.хххх_win-x64_ru-Ru.msi	Пакет установки для 64-разрядных ОС
JaCartaUnifiedClient_3.x.xxx.хххх_win-x86_ru-Ru.msi	Пакет установки для 32-разрядных ОС

При приёмке дистрибутива необходимо выполнять контроль (периодический контроль) основных характеристик, таких как контрольная сумма (КС) эталонного дистрибутива и КС неизменяемых файлов.

Установка программы

Установка с помощью мастера установки

1. Запустить файл установки от имени администратора. Откроется стартовое окно.
2. Перейти к окну “Лицензионное соглашение”. При согласии с условиями выбрать “Я принимаю условия Лицензионного соглашения” и нажать “Далее”.
3. В окне “Вид установки” выбрать один из вариантов:
   • Стандартная — устанавливает набор по умолчанию (Единый Клиент JaCarta, Минидрайвер PRO, Управление токеном, Поддержка биометрии) и добавляет программу в автозагрузку.
   • Выборочная — позволяет самостоятельно изменять путь и отмечать нужные компоненты.
4. При выборочной установке — в окне “Выборочная установка” отметить компоненты: “Минидрайвер PRO”, “JaCarta SecurLogon®”, “Управление токеном”, “Поддержка биометрии”, “Драйвер JaCarta Virtual Reader”.
5. В окне “Дополнительные параметры работы” (при выборочной установке) добавить или убрать программу из автозапуска.
6. Нажать кнопку “Установить”. Отобразится индикатор выполнения.
7. По завершении нажать кнопку “Готово” в окне завершения.
8. При предупреждении системы — перезагрузить компьютер.

Главная рекомендация. Устанавливайте Единый Клиент первым, до настройки криптопровайдера и интеграций. Это самый частый источник “ничего не работает”: пропустили клиент — токен не виден ни одному приложению.

Установка в режиме командной строки

Для тихой или автоматизированной установки используется стандартный установщик Windows (msiexec). Базовый формат команды:

msiexec /i C:\JaCartaUnifiedClient_3.x.xxx.хххх_win-x64_ru-Ru.msi

Дополнительные параметры задаются в формате ПАРАМЕТР=ЗНАЧЕНИЕ:

Параметр	Значение	Описание
INSTALL_BIO	1 / 0	Установить поддержку биометрии
INSTALL_PRO_MD	1 / 0	Установить минидрайвер PRO
INSTALL_SECURLOGON	1 / 0	Установить JaCarta SecurLogon
INSTALL_JACARTA_VR_DRIVER	1 / 0	Установить драйвер JaCarta Virtual Reader
IFD_READERS	1 – 10	Количество виртуальных считывателей
INSTALL_TOKEN_MNG	0 / 1	0 — установить “Управление токеном”, 1 — не устанавливать
ADD_JCUC_AUTORUN	1 / ""	1 — добавить в автозапуск, "" — не добавлять
LANGUAGE	RU / EN	Язык интерфейса

Пример команды:

msiexec.exe /i C:\JaCartaUnifiedClient_3.X.ХХХХ_win-x64_ru-Ru.msi INSTALL_JACARTA_VR_DRIVER=1 /qb

Ключ /qb отображает процесс установки без вопросов к пользователю и без кнопки отмены.

Проверка корректности установки

После установки и перезагрузки:

1. Подключите USB-токен JaCarta.
2. ОС должна издать звук подключения и определить устройство.
3. Криптопровайдер (если установлен) должен видеть контейнеры на JaCarta.

Если токен не определяется — обратитесь к разделу “Устранение неисправностей” (в разработке).

Изменение, исправление и удаление программы

Осторожно

Перед любыми действиями с программой убедитесь, что на компьютере есть учётная запись для входа с правами администратора. Вход должен осуществляться при помощи логина и пароля, то есть без использования токенов и смарт-карт.

Изменение программы

Изменение позволяет изменить состав установленных компонентов:

1. Меню “Пуск” → “Параметры” → “Приложения” → “Приложения и возможности”.
2. Найти “Единый Клиент JaCarta”, нажать кнопку “Изменить”. Запустится мастер установки.
3. В окне приветствия нажать “Далее”, в следующем окне выбрать “Изменить”.
4. Нажать “Далее” — отобразится окно выборочной установки компонентов.
5. Завершить процедуру, выполнив шаги 4–9 подраздела “Установка с помощью мастера установки”.

Исправление программы

Исправление восстанавливает повреждённые файлы, ярлыки и записи реестра. Условие: исходный установочный пакет должен находиться по тому же пути, что и при первичной установке.

1. Выполнить шаги 1–2 из процедуры изменения программы (открыть параметры системы, выбрать программу и нажать “Изменить”).
2. Выбрать опцию “Исправить” и нажать “Далее”.
3. В окне “Исправление программы” нажать кнопку “Исправить”. Система начнёт поиск пакета установки по изначальному пути для восстановления файлов.

Удаление программы

Через мастер удаления

1. Меню “Пуск” → “Аладдин Р.Д.” → “Удалить ПО Единый Клиент JaCarta”.
2. В окне сообщения нажать “Да”.
3. Дождаться завершения удаления. Появится окно с предложением перезагрузить компьютер.
4. Нажать “Да” для перезагрузки.

Через командную строку

1. Войти в ОС под учётной записью с правами администратора.

2. Закрыть все запущенные приложения.

3. Запустить командную строку от имени администратора.

4. Выполнить команду (указать имя файла, соответствующее разрядности ОС):

   msiexec /x JaCartaUnifiedClient_3.x.xxx.хххх_win-x64_ru-Ru.msi

   Для тихого удаления без запросов на подтверждение добавьте параметр /q:

   msiexec /x JaCartaUnifiedClient_3.x.xxx.хххх_win-x64_ru-Ru.msi /q

После полного удаления через командную строку рекомендуется перезагрузить компьютер.