========= ls11cloud_tests README Windows ===========

Установка в Linux x64 необходимых библиотек и утилит производится инсталлятором:
ls11cloud-3.0.0-install-linux-x86_64.sh
Аналогичный инсталлятор применяются для установки 32-хразрядных библиотек и утилит:
ls11cloud-3.0.0-install-linux-x86.sh

Инсталляторы не прописывают путь к установленным выполняемым файлам в переменную среды PATH,
поэтому это придется сделать вручную.

Далее нужно выполнить регистрацию на сервере pkcs11.ru и подготовить токен к работе,
как это описано в Руководстве пользователя в папке docs.

В тестовой версии сервера учетная запись предоставляется пользователю на 30 дней 
с момента регистрации.
По истечении 30 дней токен станет недоступным.
Узнать конечную дату можно командой
>ls11cloud_config status

Просроченную учетную запись и токен можно уничтожить командой
>ls11cloud_config unregister
После этого регистрацию и подготовку токена можно выполнить заново на 30 дней.

Генерация файлов тестового проекта ls11cloud_tests в Linux 
выполняется из папки build командой
>cmake ..

После выполнения данной команды в папке build создадутся проектные файлы.
Продолжить сборку можно командой
>make

Следует иметь в виду, что некоторые конструкции PKCS#11 пока еще окончательно
не согласованы в ТК 26, поэтому при тестировании собственных программ следует 
использовать включаемые файлы из папки pkcs11_tests/include. 

Вопросы, замечания и предложения высылайте Блажнову В.Ю. по почте (vblazhnov@lissi-crypto.ru).

Перечень изменений
------------------
17.04.17 
На сервере исправлена обработка неверного PIN.
В библиотеке ls11cloud исправлены механизмы CKM_MAGMA_ACPKM_CTR и CKM_MAGMA_ACPKM_OMAC.

18.04.17
В библиотеке ls11cloud исправлены механизмы CKM_KUZNYECHIK_ACPKM_CTR и CKM_KUZNYECHIK_ACPKM_OMAC.

19.04.17
На сервере исправлена обработка операции recreate.
На сервере исправлена обработка подключения при отсутствии учетной записи.
В утилите ls11cloud_config добавлена операция duplicate для подключения 
к существующей учетной записи с другого компьютера.
В утилите ls11cloud_config добавлены параметры для ввода пароля в командной строке.
Обновлено Руководство пользователя.
 
21.04.17
В файл pkcs11t_gost.h добавлена структура параметров CK_TC26_KDF_GOSTR3411_2012_256_PARAMS
для механизма CKM_KDF_GOSTR3411_2012_256.
Соответственно изменены интерфейс и реализация механизма CKM_KDF_GOSTR3411_2012_256 
в библиотеке ls11cloud.
В тесте ckm_kdf_gostr3411_2012_256.c теперь используется новая структура параметров. 

24.04.17
На сервере после аутентификации в лог-файл пользователя теперь записываются сообщения 
о выполнении команд утилиты ls11cloud_config.
Обновлено Руководство пользователя. 

27.04.17
В файл pkcs11t_gost.h добавлены определения констант CKK_MAGMA и CKM_MAGMA_KEY_GEN.
Механизмы Магмы теперь работают с ключами CKK_GOST28147 и CKK_MAGMA.
Соответственно обновлены тесты механизмов Магмы.
Обновлены инсталляторы ls11cloud и pkcs11conf.

28.04.17
Улучшена диагностика ошибок при взаимодействии утилиты ls11cloud_config с сервером.

3.05.17
Ликвидированы обнаруженные утечки памяти в библиотеке ls11cloud.
Исправлена обработка кода возврата в функции init() в файле test_common.c. 

10.05.17
Реализованы механизмы CKM_KDF_TREE_GOSTR3411_2012_256 и CKM_EXTRACT_KEY_FROM_KEY.
Добавлена структура параметров механизма CK_TC26_KDF_TREE_GOSTR3411_2012_256_PARAMS в файле pkcs11t_gost.h.
Добавлен тест ckm_kdf_tree_gostr3411_2012_256, проверяющий работу добавленных механизмов.
Обновлен инсталлятор ls11cloud.

15.05.17
Реализованы механизмы CKM_GOSTR3410_2012_VKO_256, CKM_GOSTR3410_2012_VKO_512.
Добавлена структура параметров этих механизмов CK_TC26_GOSTR3410_2012_VKO_PARAMS в файле pkcs11t_gost.h.
Добавлены тесты для новых механизмов.
Изменена версия библиотеки ls11cloud с 2.0 на 2.1.
Изменена версия утилиты p11conf с 5.3 на 5.4.
Обновлены все инсталляторы.
Обновленный сервер отрабатывает добавленные алгоритмы.

22.05.17
Реализован механизм CKM_GOST_GENERIC_SECRET_KEY_GEN.
Реализованы унифицированные механизмы блочных шифров:
CKM_GOST_CIPHER_KEY_GEN,
CKM_GOST_CIPHER_ECB,
CKM_GOST_CIPHER_CBC,
CKM_GOST_CIPHER_CTR,
CKM_GOST_CIPHER_OFB,
CKM_GOST_CIPHER_CFB,
CKM_GOST_CIPHER_OMAC,
CKM_GOST_CIPHER_ACPKM_CTR,
CKM_GOST_CIPHER_ACPKM_OMAC,
CKM_GOST_CIPHER_KEY_WRAP.
Механизмы CKM_KUZNYECHIK_MAC и CKM_MAGMA_MAC переименованы 
соответственно в CKM_KUZNYECHIK_OMAC и CKM_MAGMA_OMAC.
Обновлены и добавлены соответствующие тесты.
Обновлены все инсталляторы.

24.05.17
Параметр механизма CKM_EXTRACT_KEY_FROM_KEY выражается теперь в битах.
Атрибуты извлекаемости комбинируются из атрибутов базового и 
результирующего ключей без возможности ослабления.
Добавлен контроль диапазона вырезки.
Добавлен отдельный тест механизма CKM_EXTRACT_KEY_FROM_KEY.
 
25.05.17
Скорректирована установка атрибутов открытого ключа в механизме CKM_GOSTR3410_PUBLIC_KEY_DERIVE.
Подправлены соответствующие тесты.
Добавлен отдельный тест механизма CKM_GOSTR3410_PUBLIC_KEY_DERIVE.
 
2.06.17
Скорректирован вывод открытого ключа по неизвлекаемому закрытому с длиной 512 бит.
Добавлен соответствующий тест.
 
14.06.17
Реализован экспорт/импорт зашифрованного на пароле неизвлекаемого закрытого ключа токена 
нестандартным механизмом CKM_GOST28147_PKCS8_KEY_WRAP с шифрованием/расшифрованием в облаке.
Изменена версия библиотеки ls11cloud с 2.1 на 2.2.
Инсталляторы обновлены.
Обновленный сервер отрабатывает добавленные алгоритмы.

20.06.17
В ls11cloud добавлен консольный ввод пароля и других параметров подключения к серверу
на случай отсутствия графической поддержки для диалогов wxWidgets.
 
27.06.17
Реализован экспорт/импорт зашифрованного на пароле неизвлекаемого закрытого ключа токена 
нестандартным механизмом CKM_GOST_CIPHER_PKCS8_KEY_WRAP с шифрованием/расшифрованием в облаке
алгоритмами Магма и Кузнечик.
Изменена версия библиотеки ls11cloud с 2.2 на 2.3.
Инсталляторы обновлены.
Обновленный сервер отрабатывает добавленные алгоритмы.
 
29.06.17
Отключено использование wxWidgets в библиотеке ls11cloud. 
Вследствие этого, библиотека больше не зависит от графических библиотек. 
При необходимости, диалог запроса пароля создается динамически
имеющимися средствами операционной системы.
 
7.07.17
В библиотеке исправлена обработка ввода из диалога.
Изменена версия библиотеки ls11cloud с 2.3 на 2.4.
Инсталляторы обновлены.
 
25.07.17
В утилите p11conf добавлена функция выборочного удаления объектов 
с флагами -e -r.
Изменена версия утилиты p11conf с 5.4 на 5.5.
Инсталляторы обновлены.
 
26.07.17
В утилите p11conf добавлена функция выборочного сохранения сертификатов в файлах 
с флагом -f.
Изменена версия утилиты p11conf с 5.5 на 5.6.
Инсталляторы обновлены.
 
11.09.17
В связи с изменениями в алгоритме ТК 26 для режима шифрования CTR-ACPKM, 
соответственно обновлены программы шифрования в прикладном протоколе 
передачи данных между клиентом и сервером.
Изменена версия библиотеки ls11cloud с 2.4 на 2.5.
Инсталляторы обновлены.
Сервер на pkcs11.ru обновлен и перезапущен.
  
25.10.18
Исправлен алгоритм PKCS#8 key wrap при нулевом выходном буфере.
Некоторые тесты расширены.
Изменена версия библиотеки ls11cloud с 2.5 на 2.6.
Инсталляторы обновлены. 
 
11.12.18
Внесены изменения в утилиту ls11cloud_config по результатам тестирования.
Инсталляторы обновлены.
 
14.12.18
Утилита p11conf включена в инсталлятор.
Обновлена документация.
 
24.12.18
Пароль учетной записи в открытом виде теперь не сохраняется и по сети не передается.
Для аутентификации используется хэш от пароля.
Для локального сохранения хэша от пароля используется команда save_pswd_hash утилиты ls11cloud_config.
Документация обновлена.
Изменена версия библиотеки ls11cloud с 2.6 на 3.0.
Инсталляторы обновлены для версии 3.0.0.
Предыдущие версии не поддерживаются, нужна установка обновленным инсталлятором.
Действующие учетные записи на сервере конвертированы для версии 3.0 и остаются действующими.
Токены пользователей не изменились.
Обновленный сервер перезапущен. 
 
OOO "ЛИССИ-Софт"
24.12.18




