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

Утилита Диагностики Рутокен (УДР) предназначена для проверки работы устройств Рутокен. Она позволяет получить полную информацию о работе устройства и его параметрах. На некоторых устройствах также можно выгрузить журнал событий безопасности с информацией об операциях, совершенных на Рутокене.

...

Количество проверок зависит от модели устройства Рутокен и версии микропрограммы (МП). Все проверки и их наличие для разных моделей Рутокенов описаны в Приложении 1.

Поддерживаемые ОС

Утилита работает в следующих операционных системах (ОС):

• Windows 7 и выше;
• macOS 10.15 и выше;
• DEB-based дистрибутивы Linux:
  • Ubuntu 18 и выше;
  • Debian 10 и выше;
  • Astra Linux 1.7, 1.8.
• RPM-based дистрибутивы Linux:
  
  • Centos 7, 8;
  • ROSA Linux 7.3 и выше;
  • РЕД ОС 7.3, 8;
  • Alter OS.
• ALT Linux 8, 9, 10.

Поддерживаемые устройства

При помощи утилиты можно проверить работу следующих устройств:

...

Журнал событий безопасности доступен на следующих устройствах:

• Рутокен ЭЦП 3.0 3120.

Работа с утилитой

1. Загрузите утилиту на компьютер и сохраните ее в отдельной папке.

2. Подключите Рутокен к компьютеру.

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

   
   

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

   • 
     

     Expand
     title На ОС Windows:
     Дважды щелкните по файлу rutoken-diagnostic-tool.exe.  Откроется консоль и запустится проверка подключенного устройства. Дождитесь окончания диагностики.

     
     

   • 
     

     Expand
     title На ОС Linux:
     Откройте папку с утилитой. Щелкните правой кнопкой мыши в окне папки и выберите пункт Открыть в терминале. Введите команду: ./rutoken-diagnostic-tool и нажмите Enter. Дождитесь окончания диагностики.

     
     

   • 
     

     Expand
     title На macOS:
     Откройте папку с утилитой. Щелкните правой кнопкой мыши по названию файла rutoken-diagnostic-tool. Выберите пункт Свойства. В разделе Открывать в приложении выберите Терминал (по умолчанию). Дважды щелкните по названию файла rutoken-diagnostic-tool. Дождитесь окончания диагностики.

     
     

4. Если работа утилиты завершилась с ошибкой, найдите текст ошибки в таблице ниже, устраните проблему и снова запустите утилиту.
5. Если в консоли отобразилось сообщение «Процесс завершен», то диагностика прошла успешно. Чтобы ознакомиться с ее результатами, откройте сохраненный лог-файл.

Ошибки диагностики

Лог-файл диагностики

Лог-файл диагностики — это файл, в котором содержатся базовые сведения об устройстве и его состоянии, а также информация о проведенных в ходе диагностики проверках и их результатах. Данные из лог-файла диагностики используются для оценки работоспособности устройства. 

Параметры лог-файла диагностики

• Сохраняется в папке logs в той же директории, где находится утилита rutoken-diagnostic-tool.
• Сохраняется в формате TXT, кодировка UTF-8.
• В конце каждой строки лог-файла используется символ LF (Line Feed).
• Название лог-файла состоит из: префикса log, ID Рутокена, даты и времени его диагностики.

Содержание лог-файла диагностики

Интерпретация результатов диагностики

Уровни критичности

В результате проверки рядом с каждым перечисленным ниже параметром отображается уровень критичности. Этот уровень помогает оценить работоспособность Рутокена.

...

Названия проверок и критичность их влияния на работоспособность Рутокена представлены в таблице ниже. 

Статусы

В лог-файле после каждого параметра диагностики отображаются статусы. Описания значений этих статусов представлены в таблице.

-> Успешно

-> ОБЪЕКТЫ НЕ ОБНАРУЖЕНЫ

-> !ОШИБКА [код ошибки] - <текст ошибки>

[критичность ошибки] -> !ОШИБКА [код ошибки] - <текст ошибки>

Запрошенная функция не поддерживается 

Все проверки прошли успешно

При диагностике были выявлены ошибки

 Anchor
Лог выгрузки журнала событий безопасности
Лог выгрузки журнала событий безопасности
Лог выгрузки журнала событий безопасности 
Процесс выгрузки журнала СБ поэтапно записывается в лог-файле диагностики. Если устройство не поддерживает журналирование или в ходе выгрузки журнала СБ возникнет ошибка, запись об этом отобразится в лог-файле.
Этап выгрузки 
Результат
Проверка поддержки журнала СБ



!ОШИБКА [<SW-код>] - <текст ошибки>
Не удалось проверить, поддерживается ли журналирование на устройстве.
Процесс выгрузки прерывается

-> Успешно 
Журнал СБ не поддерживается
Устройство не поддерживает журналирование. Список устройств, которые поддерживают журналирование, находится в разделе Поддерживаемые устройства.
Процесс выгрузки прерывается

-> Успешно
Журнал СБ поддерживается
Устройство поддерживает журналирование. 
Утилита переходит к следующему этапу выгрузки
Чтение журнала СБ

!ОШИБКА [<SW-код>] - <текст ошибки>
Не удалось прочесть журнал или журналирование не поддерживается.
Процесс выгрузки прерывается

-> Успешно
Журнал удалось прочитать.
Утилита переходит к следующему этапу выгрузки
Декодирование журнала СБ

!ОШИБКА Возникли ошибки при декодировании журнала.
В журнале нашлись поврежденные TLV-структуры.
Журнал СБ выгружается в бинарном формате

!ОШИБКА Возникли ошибки при декодировании некоторых записей.
В журнале встретились неизвестные теги или возникли проблемы при преобразовании известных тегов.
Журнал СБ выгружается, операции в нем записываются последовательно два раза:
Записи, которые удалось преобразовать из бинарного формата в человекочитаемый, записываются в человекочитаемом формате. Остальные остаются в бинарном формате.
Все теги записываются в бинарном формате. Раздел имеет заголовок: «Журнал СБ в бинарном формате»

-> Успешно
Журнал был полностью декодирован.
Утилита переходит к следующему этапу выгрузки
Запись журнала СБ в файл

!ОШИБКА
Не удалось создать файл / Не удалось записать в файл
Чтение и декодирование журнала прошло успешно, но возникла ошибка при выгрузке журнала в файл.
Журнал СБ не выгружается

-> Успешно
Файл security_log-<ID>-<дата>-<время>.txt создан
Журнал успешно выгрузился в файл.
Утилита переходит к следующему этапу выгрузки
Расчет SHA256 файла журнала СБ

-> Успешно
SHA256 файла журнала СБ: <хеш-код>
Утилита успешно вычислила хеш-код файла журнала по алгоритму SHA256.
Выгрузка журнала завершена
Журнал событий безопасности
 Info
Журнал событий безопасности поддерживается только на устройствах Рутокен ЭЦП 3.0 3120.
...
События в журнале не удаляются в результате форматирования.
Параметры лог-файла журнала СБ
Сохраняется в папке logs в той же директории, где находится утилита rutoken-diagnostic-tool. 
Создается одновременно с лог-файлом диагностики, но сохраняется в отдельный лог-файл.
Сохраняется в формате TXT, кодировка UTF-8.
В конце каждой строки журнала используется символ LF (Line Feed).
Название лог-файла журнала состоит из: префикса security_log, ID Рутокена, даты и времени его диагностики.
 Info
title
Пример лог-файла журнала событий безопасности
Содержание лог-файла журнала СБ
 Info
Если после окончания диагностики лог-файл журнала СБ не появился в папке logs, выгрузился в бинарном формате или в нем не хватает информации, проверьте, есть ли в лог-файле диагностики ошибки, связанные с обработкой журнала. Подробнее об этих ошибках можно почитать в соответствующем разделе.
...
Каждая запись об операции, кроме записи с версией журнала, сопровождается кодом возврата (SW-кодом), который состоит из двух частей. Код SW1 задает класс ошибки, а код SW2 позволяет конкретизировать данную ошибку в пределах класса. Возможные значения SW-кодов приведены в Приложении 2.
№
Операция
Отображение 
1
Версия журнала
Номер версии журнала
2
Импорт закрытого ключа
Название операции,
SW-код операции,
ID объекта, 
4 первых байта от хеша открытого ключа (при наличии),
«Операция не была завершена» (при необходимости)
3
Генерация ключевой пары
Название операции,
SW-код операции,
ID объекта (при наличии),
4 первых байта от хеша открытого ключа (при наличии),
«Операция не была завершена» (при необходимости)
4
Удаление закрытого ключа
Название операции, 
SW-код операции,
ID объекта,
4 первых байта от хеша открытого ключа (при наличии),
«Операция не была завершена» (при необходимости)
5
Генерация ключевой пары ФКН2
Название операции,
SW-код операции,
4 первых байта от хеша имени контейнера (при наличии),
4 первых байта от хеша первого открытого ключа (при наличии),
4 первых байта от хеша второго открытого ключа (при наличии),
«Операция не была завершена» (при необходимости)
6
Удаление контейнера ФКН2
Название операции, 
SW-код операции,
4 первых байта от хеша имени контейнера (при наличии),
4 первых байта от хеша первого открытого ключа (при наличии),
4 первых байта от хеша второго открытого ключа (при наличии),
«Операция не была завершена» (при необходимости)
7
Смена PIN Пользователя
Название операции,
SW-код операции,
«Операция не была завершена» (при необходимости)
8
Импорт локального PIN
Название операции, 
SW-код операции,
ID объекта,
«Операция не была завершена» (при необходимости)
9
Разблокировка PIN-кода
Название операции, 
SW-код операции,
Тип аутентификации (при наличии),
ID объекта (при наличии)
10
Неуспешная аутентификация
Название операции, 
SW-код операции,
Тип аутентификации,
ID объекта (при наличии),
Количество оставшихся попыток аутентификации (при наличии)
11
Форматирование
Название операции,
SW-код операции
Проверка целостности данных лог-файла журнала СБ
На устройстве Рутокен журнал СБ хранится в режиме «только для чтения» (read only), однако после выгрузки полученный TXT-файл можно изменять. Проверить, вносились ли в лог-файл журнала изменения, можно с помощью сравнения хешей — хеш меняется, если изменяется содержимое файла. Для этого:
...
 Anchor
Приложение 1
Приложение 1
Приложение 1. Список проверок на устройствах с разными микропрограммами
Лог-файл содержит краткие сведения об устройстве, включая модель устройства и версию микропрограммы.  Предпоследнее число в этой версии необходимо для поиска проверки, актуальной для устройства с определенной микропрограммой.
...
 Expand
title
Таблица 3. Проверки для устройства Рутокен ЭЦП 3.0

№
Проверка
МП 28-30
МП 32
1
Проверка целостности ОС Рутокен
+
+
2
Получение кратких сведений об устройстве
+
+
3
Проверка работы криптоалгоритмов
+
+
3.1
Тестирование алгоритма ГОСТ 28147-89
+
+
3.2
Тестирование алгоритма ГОСТ 34.10-2001
+
+
3.3
Тестирование алгоритма ГОСТ 34.11-1994
+
+
3.4
Тестирование алгоритма ВКО 2001
+
+
3.5
Тестирование алгоритма ГОСТ 34.10-2012
+
+
3.6
Тестирование алгоритма ГОСТ 34.11-2012
+
+
3.7
Тестирование алгоритма ВКО 2012
+
+
3.8
Тестирование алгоритма ГОСТ Р 34.12-2015 Магма
+
+
3.9
Тестирование алгоритма ГОСТ Р 34.12-2015 Кузнечик
+
+
3.10
Тестирование алгоритма ECDH
+
+
4
Проверка целостности КИ


4.1
Проверка системной ключевой информации
+
+
4.2
Проверка Глобальных PIN-кодов
+
+
4.3
Проверка RSF файлов
+
+
5
Получение журнала ошибочных операций


5.1
Количество ошибок ввода глобальных PIN-кодов
+
+
5.2
Количество ошибок работы ГСЧ
+
+
5.3
Количество ошибок работы алгоритма VKO
+
+
5.4
Количество ошибок работы алгоритмов ГОСТ 34.10
+
+
5.5
Количество ошибок работы алгоритмов ГОСТ 28147
+
+
6
Получение статуса секторов памяти
+
+
7
Проверка работоспособности ГСЧ
+
+
8
Проверка поддержки журнала СБ
+
+
8.1
Чтение журнала СБ
-
+
8.2
Декодирование журнала СБ
-
+
8.3
Запись журнала СБ в файл
- 
+
8.4
Расчет SHA256 файла журнала СБ
-
+

Приложение 2. Значения SW-кодов 
 Anchor
Значения SW-кодов
Значения SW-кодов
Рутокен может возвращать следующие сочетания кодов SW1-SW2:
...