====== Программа KeyMaster ======
Программа **KeyMaster** выполняет следующие задачи:
  * Шифрование контейнера ''.7wz'';
  * Создание **[[ru:7ways:resources:protection:userkey|ключа пользователя]]**;
  * Генерация дополнительного **[[ru:7ways:resources:protection:encryptkey|ключа шифрования]]**.
Программа выполняется в командной строке (консоли), параметры могут быть заданы как в файле конфигурации, так и в командной строке. Параметры, заданные в командной строке имеют более высокий приоритет.\\
Ключи параметров программы:
<code c++>
KeyMaster 1.01.5

Usage:

Encrypt container: // пример запуска с параметрами для защиты контейнера
KeyMaster [config] <providerKey> [encryptKey] <inputContainer> <outputContainer>

Generate user key: // пример запуска с параметрами для генерации ключа пользователя
KeyMaster [config] <providerKey> [encryptKey] [requestFile] [softExpire] [hardExpire] [serialNumber] [log] <userKey>

Generate encrypt key: // пример запуска с параметрами для генерации нового ключа шифрования
KeyMaster [config] <providerKey> <newEncryptKeyId> <newEncryptKey>

Available parameters:
-config                 -cfg    path to config file // путь к файлу конфигурации
-providerKey            -pk     path to provider key // путь к ключу провайдера
-encryptKey             -ek     path to encryption key // путь к ключу шифрования
-inputContainer         -in     path to input 7wz-container // путь к контейнеру который будем защащать
-outputContainer        -out    path to output 7wz-container // путь к итоговому защищенному контейнеру  
-requestFile            -req    path to request file // путь и имя файла с запросом ключа пользователя
-softExpire             -se     user key soft expire (days) // количество дней до мягкого истечения срока годности ключа 
-hardExpire             -he     user key hard expire (days) // количество дней до истечения срока годности ключа 
-serialNumber           -sn     user key serial number // серийный номер ключа
-log                            path to log file // путь к файлу протокола работы программы
-userKey                -uk     path to user key // путь к ключу пользователя
-newEncryptKeyId        -nekid  new encrypt key id // идентификатор нового ключа шифрования
-newEncryptKey          -nek    path to new encrypt key file // путь к новому ключу шифрования
</code>
===== Создание нового ключа защиты =====
Провайдер может создать новый ключ шифрования для своих ресурсов.\\
Это может потребоваться по разным причинам (разделение версий ресурсов для разных ОС или устройств, смена версии ресурса, замена ключа потерявшего доверие и т.п.).
Идентификатор ключа может принимать значения от 2 до 65534 (идентификатор №1 используется для ключа шифрования встроенного в [[ru:7ways:resources:protection:providerKey|ключ провайдера]].
<code>
G:\KeyMaster>KeyMaster.exe -pk=sibreg.key -nekid=2 -nek=newsibregenc.key
KeyMaster 1.01.5

New encryption key has been generated.
</code>
===== Создание ключа пользователя =====
При получении от программы файла ключа или запроса через интернет провайдер может создать ключ для пользователя при помощи следующих манипуляций.
<code>
KeyMaster.exe -cfg=users/config.cfg -req=filerequest.key
</code>

<code file config.cfg>
requestFile=users/request_11_65520.txt
userKey=users/request_11_65520.txt.key
providerKey=users/sibreg.key
encryptKey=users/encrypt.key
softExpire=365
hardExpire=395
serialNumber=
log=users/sibreg.log
</code>

Конфигурационный файл - не обязателен, все параметры могут быть переданы программе в командной строке.
При запросе через интернет - необходимо создать [[ru:7ways:resources:protection:requestfile|файл запроса]] самостоятельно, так как программа принимает в качестве параметров именно файл с запросом.