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

В инструкции описана подготовка macOS к работе с устройствами Рутокен, а также сама работа с ними:

• проверка подключения устройства;
• проверка работоспособности;
• просмотр объектов, хранящихся на устройстве;
• изменение PIN-кода Пользователя.

Подключение устройства

Для работы с USB-токеном подключите его к USB-порту компьютера.

Для работы со смарт-картой подключите считыватель к USB-порту компьютера и приложите к нему или вставьте в него смарт-карту.

Подготовка к работе

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

Установите пакет OpenSC и библиотеку rtPKCS11ecp для macOS и определите путь к файлу librtpkcs11ecp.dylib чтобы:

• проверить подключение смарт-карты;
• проверить наличие ГОСТ-сертификатов и ключевых пар на USB-токене или смарт-карте;
• изменить PIN-код Пользователя на USB-токене или смарт-карте.

Установите приложение Рутокен для macOS чтобы:

• проверить наличие RSA- и ECDSA-сертификатов и ключевых пар на USB-токене или смарт-карте;

• подключить двухфакторную аутентификацию с помощью USB-токена или смарт-карты.
  

  Подключение двухфакторной аутентификации описано в инструкции Настройка двухфакторной аутентификации в macOS Big Sur и новее.

Установка OpenSC

Чтобы установить OpenSC:

1. Загрузите установочный пакет OpenSC-<версия>.dmg.

2. Откройте загруженный файл и следуйте инструкциям установщика.

   Если политики безопасности macOS не дают установить приложение от неизвестного разработчика, воспользуйтесь этой инструкцией.

   В инструкции с помощью выпадающего списка в левом верхнем углу выберите установленную версию macOS.

   

Установка библиотеки rtPKCS11ecp

Чтобы установить библиотеку rtPKCS11ecp:

1. Перейдите в Центр загрузки.

2. Нажмите на заголовок Пользователям macOS и перейдите по ссылке Установщик библиотеки rtPKCS11ecp для macOS.

3. Ознакомьтесь с лицензионным соглашением и нажмите Условия приняты. Начнется загрузка установочного файла RutokenInstaller.pkg.

4. Откройте загруженный файл и выполните инструкции установщика.

Определение пути к файлу librtpkcs11ecp.dylib

Чтобы определить путь к файлу librtpkcs11ecp.dylib:

1. Откройте Launchpad и запустите Терминал .

2. Введите команду:

   sudo find /usr -name librtpkcs11ecp.dylib

3. Нажмите Enter и подтвердите выполнение команды паролем. В результате в окне программы отобразится путь к файлу librtpkcs11ecp.dylib.

   
4. Сохраните этот путь. Он понадобится для выполнения команд утилиты pkcs11-tool.

Приложение для работы с RSA- и ECDSA-сертификатами

Чтобы установить приложение:

1. Перейдите в Центр загрузки.
2. Перейдите по ссылке Рутокен для macOS.

3. Ознакомьтесь с лицензионным соглашением и нажмите Условия приняты. Начнется загрузка архива rtmacos.zip.

4. Распакуйте архив и откройте файл Рутокен для macOS.dmg. На экране отобразится окно Рутокен для macOS.
5. В этом окне с помощью мыши перенесите значок приложения Рутокен для macOS в папку Applications.
   
6. В окне Рутокен для macOS два раза щелкните по папке Applications. Откроется папка Программы.
7. В этой папке найдите приложение Рутокен для macOS и два раза щелкните по нему.
8. Чтобы подтвердить открытие приложения, нажмите Открыть.
   В результате на экране отобразится уведомление о том, что система настроена.
   
9. Закройте окно с этим уведомлением и окно Рутокен для macOS.

Проверка подключения устройства

Для токенов и считывателей смарт-карт

Чтобы проверить подключение токена или считывателя смарт-карт:

1. Подключите устройство к компьютеру.
2. Откройте Launchpad и запустите программу Информация о системе .
3. На боковой панели окна программы выберите пункт USB.
   Если устройство подключено корректно и распознается системой, в окне программы отобразится название модели устройства и информация о нем.
   

Для смарт-карт

Чтобы проверить подключение смарт-карты:

1. Подключите смарт-карту к считывателю.
2. Откройте Launchpad и запустите Терминал .
   

3. Введите команду:

   pkcs11-tool --module {A} -T

   A — путь к файлу librtpkcs11ecp.dylib.

4. Нажмите Enter.
   Если смарт-карта подключена корректно и распознается системой, в разделе token model отобразится название модели смарт-карты.

Проверка работы устройств Рутокен в системе

Чтобы проверить работу токена, смарт-карты или считывателя, воспользуйтесь встроенной утилитой pcsctest:

1. Подключите устройство к компьютеру.
2. Откройте Launchpad и запустите Терминал .

3. Введите команду:

   pcsctest

4. Нажмите Enter и введите цифру «1».

5. Нажмите Enter и введите цифру «1».
6. Нажмите Enter.
   Если отобразилось сообщение "PC/SC Test Completed Successfully !", значит, устройство работает. 
   
   Если на этапе "Please insert a working reader" проверка остановилась, значит, устройство не удалось определить в системе.
   Убедитесь, что устройство подключено и распознается системой.
    

Просмотр RSA- и ECDSA-сертификатов и ключевых пар на устройствах Рутокен

Чтобы посмотреть информацию о RSA- и ECDSA-сертификатах и ключевых парах:

1. Подключите устройство к компьютеру.
2. Откройте Launchpad и запустите Терминал .

3. Введите команду:

   sc_auth identities

4. Нажмите Enter.

   В результате в окне программы отобразится информация обо всех RSA- и ECDSA-сертификатах и ключевых парах, которые хранятся на устройстве Рутокен.
   

Просмотр ГОСТ-сертификатов и ключевых пар на устройствах Рутокен

Чтобы посмотреть информацию о ГОСТ-сертификатах и ключевых парах:

1. Подключите устройство к компьютеру.
2. Откройте Launchpad и запустите Терминал .

3. Введите команду:

   pkcs11-tool --module {A} -O

   A — путь к файлу librtpkcs11ecp.dylib.

4. Нажмите Enter.
   В результате в окне программы отобразится информация об объектах, хранящихся на устройстве.
   

5. Чтобы посмотреть подробную информацию о сертификате или ключевой паре, введите команду:

   pkcs11-tool --module {A} -r -y cert --id {B} | openssl x509 -inform der -text

   A — путь к файлу librtpkcs11ecp.dylib.

   B — ID объекта.
   

6. Нажмите Enter.
   В результате в окне программы отобразится полная информация об указанном объекте.
   

Изменение PIN-кода Пользователя

Чтобы изменить PIN-код Пользователя:

1. Отключите все токены, кроме того, на котором нужно изменить PIN-код Пользователя.
2. Откройте Launchpad и запустите Терминал .

3. Введите команду:

   pkcs11-tool --module {A} --login --pin {B} --change-pin --new-pin {C}

   A — путь к файлу librtpkcs11ecp.dylib.
   B — текущий PIN-код.
   C — новый PIN-код.

4. Нажмите Enter. 
   Отобразится сообщение об успешной смене PIN-кода.

   

В результате PIN-код Пользователя будет изменен.