UniKey Console Tool

Introduction

UniKey console version is a powerful tool to help software vendors manage their software development, license software and track their software sales performance. It can be integrated into your ERP, CRM and Financial system seamlessly.

The UniKey console is designed to follow the waterfall software development procedure, which helps software vendors manage their different products along its whole lifecycle. The feature based license management method is an innovative way to protect your software away from intruders and to license efficiently.

To administrate all software, check the sales history and gather information to prepare for the following software development, UniKey console employs a database to record information. It supports almost all database techniques available in today’s market, such as SQL, MySQL and Oracle.

Additionally, this Console supports multiple users to logon the system. Different operators in different roles can logon and operate the console utility within their personal level of permission. For example, employees from product department can logon the Console system, and submit product orders, but they cannot see any other information about the sales department.

Deployment

This section will introduce how to deploy the UniKey console on your system. The console has two parts, the front is a GUI which is a green software and does not need any installation. Users simply copy the folder to their computer.

The next step is to install a database and create tables. In the SDK, we provide a MySQL package. Double click on the mysql-5.5.15 icon, and follow the install wizard to finish the MySQL installation. After installing database, click on “Start”, and open the MySQL command line client.

Logon to the database by entering your password.

<a href="/secuwiki/index.php?title=/secuwiki/index.php%3Ftitle%3D/secuwiki/index.php%3Ftitle%3DSpecial:Upload%26wpDestFile%3DUniKey_Console_Tool_Pic01.jpg%26action%3Dedit%26redlink%3D1&action=edit&redlink=1" class="new" title="/secuwiki/index.php?title=/secuwiki/index.php?title=Special:Upload&wpDestFile=UniKey Console Tool Pic01.jpg&action=edit&redlink=1 (page does not exist)">RTENOTITLE</a>

To create tables, input “<source file directory>\createconsoletables.sql” and press enter. After the database has been successfully built, open the console GUI by double clicking on the Console icon.  

Working Mode

The UniKey Console provides two different modes for users, Manage Mode and Device Mode. The Manage Mode is mainly used to manage the whole lifecycle of your software, and allows multiple operators to logon the system to implement their operations with their own levels of permission. Device mode provides a quick way to configure parameters or generate an update file for a UniKey device.

Manage Mode

The UniKey console Manage Mode is closely follows the software lifecycle, from the beginning of software design to the end of software development. At the design stage, software designers will separate the software into different blocks according to their functions. We highly recommend those medium to large software vendors use the manage mode to manage and license your software.

Logon

This system supports remote login. Users can set up the server’s IP via the GUI, and logon the server remotely to finish their operation.

To start using the Console, double click on the UniKey Console. The logon interface will pop up.

<a href="/secuwiki/index.php?title=/secuwiki/index.php%3Ftitle%3D/secuwiki/index.php%3Ftitle%3DSpecial:Upload%26wpDestFile%3DUniKey_Console_Tool_Pic02.jpg%26action%3Dedit%26redlink%3D1&action=edit&redlink=1" class="new" title="/secuwiki/index.php?title=/secuwiki/index.php?title=Special:Upload&wpDestFile=UniKey Console Tool Pic02.jpg&action=edit&redlink=1 (page does not exist)">RTENOTITLE</a>

Input the user name and password to logon the system.

• If it is the first time you logon the system, the user name is administrator, and password is admin.

• The administrator shall logon the system and change their password first, and then he/she can create other accounts for different operators.

• If you try to logon to a server remotely, click on “Network Setting” and in the pop-up window, input the server IP address and port number.

Product

The product panel provides a series of interfaces for product related operations, including creating license features and generating product license strategies by combining one or more license features together.

Feature Setting

The feature setting is the most basic element to form a license for a product. For example, if the software requires a license based on expiration time, a time module shall be selected and the expiration time shall be set. This will form a license feature. If more license strategies are going to be used, more license features can be created.

<a href="/secuwiki/index.php?title=/secuwiki/index.php%3Ftitle%3D/secuwiki/index.php%3Ftitle%3DSpecial:Upload%26wpDestFile%3DUniKey_Console_Tool_Pic03.jpg%26action%3Dedit%26redlink%3D1&action=edit&redlink=1" class="new" title="/secuwiki/index.php?title=/secuwiki/index.php?title=Special:Upload&wpDestFile=UniKey Console Tool Pic03.jpg&action=edit&redlink=1 (page does not exist)">RTENOTITLE</a>

Click on “Add” to add a license feature in the pop-up window.

<a href="/secuwiki/index.php?title=/secuwiki/index.php%3Ftitle%3D/secuwiki/index.php%3Ftitle%3DSpecial:Upload%26wpDestFile%3DUniKey_Console_Tool_Pic04.jpg%26action%3Dedit%26redlink%3D1&action=edit&redlink=1" class="new" title="/secuwiki/index.php?title=/secuwiki/index.php?title=Special:Upload&wpDestFile=UniKey Console Tool Pic04.jpg&action=edit&redlink=1 (page does not exist)">RTENOTITLE</a>

As you can see from the above picture, lots of license features can be used to build up a single product license, such as license module, memory, arithmetic, SID, max connection, partition information and etc.

License Module

This feature limits access to the software based on rules. When the correct UniKey is connected, the software bound to the UniKey is activated.

<a href="/secuwiki/index.php?title=/secuwiki/index.php%3Ftitle%3D/secuwiki/index.php%3Ftitle%3DSpecial:Upload%26wpDestFile%3DUniKey_Console_Tool_Pic05.jpg%26action%3Dedit%26redlink%3D1&action=edit&redlink=1" class="new" title="/secuwiki/index.php?title=/secuwiki/index.php?title=Special:Upload&wpDestFile=UniKey Console Tool Pic05.jpg&action=edit&redlink=1 (page does not exist)">RTENOTITLE</a>

There are two ways to use the license module. First is to bind a module to the software, once the module is enabled, the software will start working; second is to set the execute count, every time when the software is started, the count will decrement until the value reaches 0.

Memory

UniKey has 4K memory which allows developers to store any information, such as software abstract, version information, buyers or developers’ information, etc.

<a href="/secuwiki/index.php?title=/secuwiki/index.php%3Ftitle%3D/secuwiki/index.php%3Ftitle%3DSpecial:Upload%26wpDestFile%3DUniKey_Console_Tool_Pic06.jpg%26action%3Dedit%26redlink%3D1&action=edit&redlink=1" class="new" title="/secuwiki/index.php?title=/secuwiki/index.php?title=Special:Upload&wpDestFile=UniKey Console Tool Pic06.jpg&action=edit&redlink=1 (page does not exist)">RTENOTITLE</a>

In the feature setting:

• Input the encoding in the left column;

• Input the start address, which refers the start point where the content will be stored;

• Input the length, which refers the length of contents that will be stored in the memory.

Arithmetic

To protect your software safely, it is a good idea to write a block of code inside the UniKey device itself, therefore without the device, the software cannot run. The arithmetic option is designed for this purpose.

<a href="/secuwiki/index.php?title=/secuwiki/index.php%3Ftitle%3D/secuwiki/index.php%3Ftitle%3DSpecial:Upload%26wpDestFile%3DUniKey_Console_Tool_Pic07.jpg%26action%3Dedit%26redlink%3D1&action=edit&redlink=1" class="new" title="/secuwiki/index.php?title=/secuwiki/index.php?title=Special:Upload&wpDestFile=UniKey Console Tool Pic07.jpg&action=edit&redlink=1 (page does not exist)">RTENOTITLE</a>

In the feature setting:

• Input your custom arithmetic.

• Input the start address, to set the start point of the arithmetic;

• Input the length, so that the arithmetic will end at the start address plus the length.

SID Range

SID is another important property in UniKey that can provide effective license management and software protection. Developers can use this feature to set it so that only one key or several keys can launch a specific copy of software.

<a href="/secuwiki/index.php?title=/secuwiki/index.php%3Ftitle%3D/secuwiki/index.php%3Ftitle%3DSpecial:Upload%26wpDestFile%3DUniKey_Console_Tool_Pic08.jpg%26action%3Dedit%26redlink%3D1&action=edit&redlink=1" class="new" title="/secuwiki/index.php?title=/secuwiki/index.php?title=Special:Upload&wpDestFile=UniKey Console Tool Pic08.jpg&action=edit&redlink=1 (page does not exist)">RTENOTITLE</a>

Feature setting:

In the SID generation mode, which will generate a rule for how UniKey SID codes are created, there are 4 different methods of generation:

• All same: all SID burned to UniKey devices will be the same

• Increment: the SID value of every UniKey device will add 1 from the initial value, when been produced

• Decrement: the SID value of every UniKey device will decrease by 1

• Time/date: the SID value will be the producing time/date

The initial value gives a starting SID value/position/number.

Update Tag

The update tag is mainly used to update related issues. It can be used to record the number of times the software has been updated, or protect an update file from being used by other UniKey devices with a different update tag.

<a href="/secuwiki/index.php?title=/secuwiki/index.php%3Ftitle%3D/secuwiki/index.php%3Ftitle%3DSpecial:Upload%26wpDestFile%3DUniKey_Console_Tool_Pic09.jpg%26action%3Dedit%26redlink%3D1&action=edit&redlink=1" class="new" title="/secuwiki/index.php?title=/secuwiki/index.php?title=Special:Upload&wpDestFile=UniKey Console Tool Pic09.jpg&action=edit&redlink=1 (page does not exist)">RTENOTITLE</a>

Max Connection

Some software may employ a floating license strategy, where people on the network will share a license. The maximum number of connections can restrict the total number of users who share the same license simultaneously on the local network.

<a href="/secuwiki/index.php?title=/secuwiki/index.php%3Ftitle%3D/secuwiki/index.php%3Ftitle%3DSpecial:Upload%26wpDestFile%3DUniKey_Console_Tool_Pic10.jpg%26action%3Dedit%26redlink%3D1&action=edit&redlink=1" class="new" title="/secuwiki/index.php?title=/secuwiki/index.php?title=Special:Upload&wpDestFile=UniKey Console Tool Pic10.jpg&action=edit&redlink=1 (page does not exist)">RTENOTITLE</a>

Seed

For every UniKey device, the password cannot be customized, but developers can generate their own password by themselves. The method to generate passwords is by entering a seed value in the seed setting, and when the license is been produced, the password of the device will be changed to the value calculated by the UniKey system based on this seed value.

<a href="/secuwiki/index.php?title=/secuwiki/index.php%3Ftitle%3D/secuwiki/index.php%3Ftitle%3DSpecial:Upload%26wpDestFile%3DUniKey_Console_Tool_Pic11.jpg%26action%3Dedit%26redlink%3D1&action=edit&redlink=1" class="new" title="/secuwiki/index.php?title=/secuwiki/index.php?title=Special:Upload&wpDestFile=UniKey Console Tool Pic11.jpg&action=edit&redlink=1 (page does not exist)">RTENOTITLE</a>

the feature setting, input the seed value.

• Each UniKey dongle can only generate a new password TWICE! It cannot generate new passwords any more.

• When generating a new password, the dongle is formatted.

Partition information

Each UniKey Drive device has four partitions:

• Virtual CD-ROM emulation drive

• Public partition

• Password protected partition

• Hidden partition

Customers will assign space for each partition and this page is used by the customer to set the space for each partition on the UniKey Drive device.

<a href="/secuwiki/index.php?title=/secuwiki/index.php%3Ftitle%3D/secuwiki/index.php%3Ftitle%3DSpecial:Upload%26wpDestFile%3DUniKey_Console_Tool_Pic12.jpg%26action%3Dedit%26redlink%3D1&action=edit&redlink=1" class="new" title="/secuwiki/index.php?title=/secuwiki/index.php?title=Special:Upload&wpDestFile=UniKey Console Tool Pic12.jpg&action=edit&redlink=1 (page does not exist)">RTENOTITLE</a>

Files in hidden partition(UniKey Drive)

UniKey Drive has a unique hidden partition which allows users to store files. Each file stored on the hidden partition is invisible and inaccessible to the end users. Vendors could integrate UniKey Drive APIs with their software and then that software will be able to access the files stored on the UniKey Drive’s hidden partition.

<a href="/secuwiki/index.php?title=/secuwiki/index.php%3Ftitle%3D/secuwiki/index.php%3Ftitle%3DSpecial:Upload%26wpDestFile%3DUniKey_Console_Tool_Pic13.jpg%26action%3Dedit%26redlink%3D1&action=edit&redlink=1" class="new" title="/secuwiki/index.php?title=/secuwiki/index.php?title=Special:Upload&wpDestFile=UniKey Console Tool Pic13.jpg&action=edit&redlink=1 (page does not exist)">RTENOTITLE</a>

The files stored on the hidden partition should have the filename as 8.3 format, for example, 12345678.123

Product setting

Product setting is used to combine the basic license elements in features together to form a product license strategy, to meet the different requirements of customers, businesses and selling strategies. For each software package, decision makers can set several license strategies by selecting different license features which have been set in the feature setting, to maximize their market share and revenue, and for some special requirements for customers, a customized license can be generated quickly.

<a href="/secuwiki/index.php?title=/secuwiki/index.php%3Ftitle%3D/secuwiki/index.php%3Ftitle%3DSpecial:Upload%26wpDestFile%3DUniKey_Console_Tool_Pic14.jpg%26action%3Dedit%26redlink%3D1&action=edit&redlink=1" class="new" title="/secuwiki/index.php?title=/secuwiki/index.php?title=Special:Upload&wpDestFile=UniKey Console Tool Pic14.jpg&action=edit&redlink=1 (page does not exist)">RTENOTITLE</a>

The above picture shows the panel of the product setting, and to add a license for a product click on “Add”.

After clicking on Add, this window is displayed

<a href="/secuwiki/index.php?title=/secuwiki/index.php%3Ftitle%3D/secuwiki/index.php%3Ftitle%3DSpecial:Upload%26wpDestFile%3DUniKey_Console_Tool_Pic15.jpg%26action%3Dedit%26redlink%3D1&action=edit&redlink=1" class="new" title="/secuwiki/index.php?title=/secuwiki/index.php?title=Special:Upload&wpDestFile=UniKey Console Tool Pic15.jpg&action=edit&redlink=1 (page does not exist)">RTENOTITLE</a>

Input the name for the product. A comment can be added in the comment box and please choose a compatible device.

In the feature setting area, you can reset the update tag, max connections, seed, and SID generation mode by checking the option items respectively. This provides a quick interface to modify the license settings.

From the feature list choose the preferred features from the list and click on “>” to move them to the desired features on the product to the right. These features will combine together to form a product license.

<a href="/secuwiki/index.php?title=/secuwiki/index.php%3Ftitle%3D/secuwiki/index.php%3Ftitle%3DSpecial:Upload%26wpDestFile%3DUniKey_Console_Tool_Pic16.jpg%26action%3Dedit%26redlink%3D1&action=edit&redlink=1" class="new" title="/secuwiki/index.php?title=/secuwiki/index.php?title=Special:Upload&wpDestFile=UniKey Console Tool Pic16.jpg&action=edit&redlink=1 (page does not exist)">RTENOTITLE</a>

Based on the current product, you can create a new license quickly by using the “Customize” function, the current license policy of the product will be listed in the product current feature column directly, and you can input a new name and reset values or add more features to create another license.

The product can be changed by clicking on “Edit”, and can be deleted by “Delete”.

Sales

The sale function will help vendors to manage their customers and orders. It contains two configurations: Customer Management and Order Setting.

Customer Management

Customer management will record all information about customers and their order history. If a customer wants to place an order, then this customer must be added to the customer list. Click on the button on the right to execute the corresponding operation.

Order Setting

Order setting contains order related operations, such as place an order, update product, append new order to an existing order, edit, delete, submit and check status.

PIC 17

 

Production

The production is mainly used for the production department, once an order has been submitted, the order will be passed to the production department, and this order will be listed. The producer shall produce the order.

PIC 18

 

Click on “Production”, and follow the instruction to finish production procedure.

 

PIC 19

If there is an error or problem in the order, the producer shall decline the order by clicking on “decline”, and then the order will be sent back to sales.

 

Management

Administrators shall use the management tab to add, edit and delete users, including user name, password, and assign permission levels.

PIC 20

 

Device Mode

Device Mode provides you a direct way to configure all parameters for your UniKey device locally or to generate a remote update file. It is suitable for altering UniKey hardware operations and property configurations directly.

PIC 21

 

When you click on “Check status”, the status of the device connected to the local computer will be displayed in the message box.

By entering the correct password, and then clicking on the “User Logon” or “Vendor Logon”, you can logon to the device as a user or vendor to do the operations within your level of permission.

Configure

Click on “Configure” on the left side of control panel, all configuration options will be displayed in the dropdown menus: General information, Memory, Algorithm, License module, Encrypt/decrypt, and network configuration.

PIC22

 

You can configure any properties according to your own desired licensing strategies. By clicking on the corresponding options, you can enter your parameters.

 

General information

PIC23

 

In this option, the UniKey device’s SID and Update Tag connected to your computer will show in the message box. You can change the SID and Update Tag value, by entering value to the input box and then clicking on “write”.

 

Memory

 

PIC24

 

In memory option, you can read, edit and delete content stored in UniKey memory. By clicking on “Read”, you can read content from UniKey memory, and by clicking on “Write”, you can write all the contents edited by you into the UniKey memory.

To facilitate your editing, UniKey console provides a load from file function. By clicking on “Load from file”, you can load content stored in a file to Console, and then write it to memory by clicking on “Write”. Or you can save the data which is read from UniKey memory to a file by clicking on “Save to file”.

Algorithm

 

PIC 25

 

Using UniKey algorithm is a very powerful method way to protect your software, as this block of code is stored in UniKey, independent from memory storing the software code. Without the right permission, nobody can read or write this block of code.

You can input your algorithms in algorithm input form. You can input more than one statement in your algorithm and each statement is separated by comma. Input the start address to set the starting point for your algorithm, and input a length to set the end point. The end point address will be the start address plus length.

Select the calculation mode, and then click on “Write” to write your configurations into UniKey. If you want to run your algorithm for a test, you can initialize the variable, A, B, C, D, seed/module (depending on the selected calculation mode) and start address, and then click on “run”. The result from A, B, C and D will be displayed directly.

License Module

 

PIC26

 

License Module allows you to enabled/disabled specified modules and set the number of execution times. In the list on the right side of the console, you can see a list and module status. Click on the white triangle to check each corresponding module’s parameters and status.

 

PIC27

 

Click on “Check” to check information and status from a device and click on “Write” to write your configurations.

You can enable/disable the auto-decrement function by toggling the check box next to “Auto-decrement”.

To check the information in all modules, you can click on the “Check All” button; you can also set all modules by clicking on “Write All” to write all settings to device.

Time Module(UniKey Time)

 

PIC28

 

The UniKey Time model has 16 time modules, and you can bind a time module with your software or one of function in your software, to achieve time based license strategy.

Click on “read time” to read the time from the device dongle, and you can set the time by inputting the time in the input box and then click on “write time” or you can synchronize you device clock with your system time.

Click on the white triangle icon on the right to set a time module, by following the procedure below.

Set start time

 

PIC29

You can use the current devices time or system time by clicking on “use device time” or ”use system time”. UniKey provides two different methods, expiration and duration, for you to select (the default method is duration time). Input the duration time, which indicates how long the user can use the software after the start time.

Set expiration time

PIC30

If the module will never be used, you can click on “write” directly, but if the module has been set before, then to reset the module, you should either erase the module first or check the “re-write” option. You can set more than one module at once, click on “write all” to set your modules in batch, please use “check all” to check all module status. Click on “erase all” to remove all settings stored in all time modules. Please note, all modules will be initialized so be careful when using this feature.

<a href="Category:Pages_with_broken_file_links">Pages_with_broken_file_links</a> <a _fcknotitle="true" href="Category:UniKey_Console_Tool">UniKey_Console_Tool</a>