UniKey Enveloper Tool

About UniKey Enveloper

The UniKey Enveloper is a powerful anti-piracy protection tool that can protect your software from unauthorized copy and usage. Usage of the tool can be likened to securing your application by wrapping it in a protective shell.

UniKey Enveloper provides the fastest and easiest automatic software protection solution to safeguard your executables, DLLs and data used in and by your application. The greatest advantage of using the UniKey Enveloper is that access to the source code of the application is not needed.

With this tool, protection parameters can be configured, and after wrapping software in a 'secure shield', no one else without your permission can use this protected software anti-debug mechanism will automatically be added to you application, rendering pirates who want to use reverse engineering method to hack your software impossible.

The Enveloper tool for UniKey STD, PRO and Time can be located in the UniKey SDK under the directory

UniKey SDK\Utilities\Enveloper\Envelop Tool\

The Enveloper tool for UniKey Drive can be located in the UniKey Drive SDK under the directory

UniKey Drive SDK\Utilities\EnveloperEnvelop Tool\

What Can Be Protected?

Enveloper protection can be directly applied to

• Executables - Almost all application executables, including both PE and DotNet (2.0, 3.0, 3.5, 4.0) files.
• DLLs - DotNet DLLs currently are not supported.
• Data files.

Protection Procedure In a Nutshell

Note: The UniKey Enveloper Tool should be run under a 32-bit system, whereas enveloped software and applications can be either for use on 32-bit or 64-bit systems.

Users can perform protection of software with UniKey Enveloper by following the procedure described below:

1. Launch the UniKey Enveloper tool (Please note the Enveloper tool for UniKey Drive is different to UniKey STD, PRO and Time)
2. Specify the application which to protect.
3. Set protection parameters for the program.
4. Execute.

After the envelope procedure, the end user can only access the protected software with the corresponding UniKey device; you may send your protected software together with the corresponding UniKey to your customer.

Enveloper Interface Structure

To launch Enveloper, double-click on the Enveloper executable and the Enveloper Control Panel will appear; no installation is required.

The UniKey Enveloper provides two different interface modes, Guide mode and Professional mode, to accommodate different user requirements and/or preferences. Users can switch between the two modes by clicking on the button in the upper-right corner of the main panel or selecting the interface mode from the [View] menu in the menu bar.

Guide mode is specifically designed for beginner users to allow uncomplicated use. In this mode, the tool will guide the user step by step in configuring desired settings.

Professional mode is suitable for advanced users who are familiar with the UniKey system. A greater variety of options is available to the user's disposal, and settings can be modified by selecting the specific parameters from the Solution window.

Upon launching the Enveloper, the interface will default to Professional mode. After creating a solution, the interface automatically switches to Guide mode.

Guide Mode Interface and Layout

The Guide mode interface consists of:

1. Menu bar.
2. Input window. In Guide mode, the Input window lets you specify options step by step, guided by tool.
3. Progress navigation bar. The progress navigation bar visually communicates the user's current progress during configuration process, highlighting the current stage in yellow.
4. Output window. The output window displays information including the Enveloper's running status and arisen errors.

Menu bar

• New Solution: Create a new software protection solution.
• Close Solution: Close the current open solution.
• Add a Project: Add a project to the current open solution.
• Open: Open a previous solution.
• Save: Save all configurations of the current open solution, to the current working directory.
• Save as: Save the current solution to a specified location.
• Import: Open the configuration file created by a previous version of Enveloper.
• Exit: Close the Enveloper program.

Protect menu

• Protect Project: Execute Enveloper to protect the selected project.
• Protect All Projects: Execute Enveloper to protect all the projects in the current solution.

View menu

• Guide Mode: Switch the Enveloper interface to Guide mode layout, suitable for beginner users.
• Professional Mode: Switch the Enveloper interface to Professional mode layout, suitable for experienced users.
• Solution Window: Display or hide the Solution window.
• Output Window: Display or hide the the Output window.

About menu

• About: Displays information about the Enveloper tool, such as version number.

Project drop-down list

• Project drop-down list: Displays the current project, and Helps you select the project which you are going to edit from the same solution

Protect button

• Protect: Execute protection parameters of the project Enveloper.

Interface layout button

• Guide/Professional Mode: Toggle between Guide mode and Professional mode.

Professional Mode Interface and Layout

The Professional mode interface consists of the components:

1. Menu bar.
2. Solution window. The solution window displays every project in the solution, and all the steps for setting each project in a tree view. By click on the settings in the solution window, you can easily access every setting.
3. Input window. For every setting, the input window provides an interface for users to specify the setting desired. Users can use the solution window to configure the content in the input window.
4. Output window. The output window displays information including the Enveloper's running status and arisen errors.

For interface component descriptions, see Guide Mode above.

Enveloper Settings

Source File

The executable file or .DLL file to be protected

Data File

Data file associated with the source file

Output Location

The destination folder where the protected file will be saved

Password

UniKey has two-level security permissions by using four passwords. Users can login as user by providing the first two passwords or as a vendor by providing all four passwords. To use the enveloper to protect software, you must input the four passwords.

Module settings

Lets you assign a module number for your protected software. When the specified module number in the UniKey device is enabled, the protected software can be started/accessed

Time settings

The UniKey time model has 16 time modules. You can bind you software to a specific time module, and indicate the expiration date or duration time

HID settings

The UniKey’s unique identity number. You can bind your software to this number to ensure that only when the corresponding UniKey is presented, the protected software can run.

Background settings

When the protected software starts working, the software will start checking the UniKey device every Loop Time (defined by you). This function can ensure that the UniKey device must be connected to the computer while the protected software is been used.

Debugger settings

This function lets you protect your software from been cracked by using debugger techniques.

• Basic
• Advanced
• Kernel
• IDE
• Virtual PC

Network settings

UniKey PRO, Time and Drive provide software protection in a Local network environment. When this function is enabled the UniKey device will search through the network. The software will work properly if the right device is detected.

To use the Network function, the following parameters need to be configured:

Working Mode

• Network Only: The protected software will only search for the UniKey through the network
• Local->Network: The protected software will search for the UniKey from the local computer firstly, and if it is not found, the software will search the network
• Network->Local: The protected software will search for the UniKey from network first, and if it is not found, the software will search the local computer

Access Mode

• Per Thread: Protected software can logon to the UniKey many times
• Per Process: Protected software can logon to the UniKey only once
• Per IP: For each IP address, only one instance of the protected software can be launched

Searching Mode

• Direct Only: The protected software will search for the UniKey from the specified IP address only
• Direct->Broadcast: The protected software will search for the UniKey from the specified IP address, and if the UniKey cannot be found, the software will search for the UniKey from the entire network automatically
• Broadcast->Direct: The protected software will search for the UniKey from the entire network, and if the UniKey cannot be found, the software will find the UniKey from the specified IP address

Server IP The Server IP address where the UniKey is connected

Server Port: The port number used for the connection between server and client

Time Out: Defines the timeout value of the communication between the server and clients

DotNet Settings

This function lets you protect your .Net application according to the operating system in which the .Net application works. It can generate protected applications for both X86 and X64 platforms.

Start Dialog Settings

Enable or disable the start screen display function

Warning Message

Define the warning and error output message

Protect Software using Enveloper

Enveloper protects software without changing the source code. At any time you can start enveloper to adjust settings and perform upgrades to your protected software.

Guide Mode

Double click on the Enveloper icon to start Enveloper and the enveloper main panel will appear.

File:UniKey Envelop Tool Pic08.jpg

New Solution

Create a solution by selecting the "File?New Solution" from the menu bar, and the following window will appear.

Select the UniKey Type which you are going to use to protect your software. Enter the name and description for your new created solution, and select the destination folder where the new solution file will be stored. Click on the OK button to confirm your settings. The window will close and the Enveloper main panel will switch to Guide mode automatically, as shown in the following picture.

The system will create a new project called [your solution name]_1 automatically.

Select Files

Click on the Add button to add your software which you want to protect to the current project. A File Editor window will pop up.

This button next to the Source File input box allows you to locate the software you want to protect, or input the software location directly. If there is some data files associated with your software, you can protect these data files by clicking on the "Add" button to add them into data files box.

The similar button next to the Output Location input box allows you specify where the protected software will be stored or input the destination folder directly. Click on the "OK" button to finish setting the protected software file settings.

You can add one or more executable or DLL files to each project. To add another program, please repeat the operation described above, you can add zero or more data files associated with one executable or DLL file.

Device Settings

Device settings consist of:

• Password
• Bind mode
• Bind time
• Bind HID
• Bind SID
• Background check

To use a UniKey device to protect your software, you must input the correct password to the UniKey device. Click on the password setting button, and the interface will switch to the password setting interface. To enable an option, just check the option box following the option. When the colour of a check mark changes to green, the option is enabled. For more settings, click on the Setting button to switch to the setting interface.

The options with a shaded check mark means that the corresponding settings are not enabled.

Use this icon in the progress navigation bar to switch to Device Settings

Password Settings

Enter the correct four passwords, and then click the guide mode button to switch back to guide mode.

To simplify user operations the system provides some default settings, therefore if you want to use the default settings, you can check the option box to enable the function directly.

For example, the system will automatically enable background checks by default.

System Settings

After you have finished with the device settings, click on this icon to get into the system settings interface.

System settings

System settings consists of:

• Start Dialog
• Network
• Anti-Debugger
• Warning Message

You can choose to enable and configure any protection function by checking the corresponding tick box and clicking on the setting button.

If you enable the network function, you must click on the corresponding setting button to set the server address, please note that only UniKey Pro, Time and Drive support this function.

Click on this icon to go to the next step.

Build Project

The input window displays all the details about your solution. You can check your configuration from this window, and click on the Protect button to execute your software protection with the Enveloper tool.

Professional Mode

Professional mode provides an interface to set the UniKey hardware and system configuration for advanced users. To switch to the professional mode, after creating a new solution, click on the Professional mode button.

After the encryption operation has completed, the "Encryption successful" will show in the output window.

Solution

By clicking on the parameters in the solution window, you can start to configure the parameters in the input window directly.

After finishing all configurations, click on the protect button to execute protection.

Protect without dongle (Remote Update)

Consider the situation that UniKey devices have been distributed to end users and the users want to renew the software, such as update the latest version, the traditional way is that users need to send back their dongle back to software vendors, which cost shipping fees and waste time.

Our Enveloper provides application protection without dongle connection, to reduce logistic cost.

To start protect application without dongle, switch Unikey Enveloper to professional mode.

Uncheck the Insert Device Mode operation, for the rest configurations please follow the Protect Software using Enveloper instruction.

As there is no UniKey device connect to enveloper, if you want bind your application to a specified HID, the only way to do that is to select bind HID with Selected HID, and then select the specified HID value from the database where you saved the value before you sent the UniKey to the end users.(Later version will be added HID management part)

UniKey Enveloper is a tool to provide application protection, if you want to a update license remotely, please use the "Update Generator Tool", the general procedure is:

1. Double click on the Generator Icon

a. In "Basic Settings", set the correct password for the client's dongleb. In "Basic Settings", check the "Bind Update Tag", and enter the current tag of our client's dongle.c. In "Basic Settings", also check the "New Update Tag" and enter a new Tag, so that after your client runs the updater, his dongle´s tag will change (and because the update is bound to the old tag - item b - he will only be able to update his dongle once).d. In "Module Settings", set the value of Module 0 to the count limit (if desired), and check the "Auto decrement" box

2. In "UPT File", click "Generate" and choose the destination for the upt2 file.

3. Send the upt2 file and the "Updater" tool to your client, and ask him to run the Updater tool with the upt2 file with the dongle connected.

4. Send the enveloped software to your client, together with the dlls.

For further UniKey Generator instructions please refer to UniKey Generator part in the UniKey tools manual.