Create or Update LicenseID

Parent Previous Next

Create or Update LicenseID.

SCRAMBLECODE must be used with a license identification file (LicenseID) as stated by the End User License Agreement (EULA). This is important with regards to the Single Target Compilation technique.


This page describes how to create and update a LicenseID using the wizard included in the IDE.


IMPORTANT: Before reading this page, please read How to Buy and Register which explains in detail the additional steps involved before and after using this wizard. Using this wizard is only the second step out of a 3-step process. It must be followed by another step for registration.


License Management Wizard.

The IDE contains a wizard located in the License Menu to create or update LicenseID files.


The wizard can generate two files in plain text:


When the wizard is used to create a new LicenseID, it will also create a certain number of private keys saved to the file PrivateKey.txt.


When the wizard is used to update a LicenseID, additional private keys may be generated until you reach the limit for the license type.


The files produced by the wizard are written as text files (UTF8) for transparency reasons and can be inspected using a simple text editor. Please be careful not to change the content in any unintentional way. Each file contains a header with information about this.


It is not necessary to have access to the Internet in order to use the wizard. To provide maximum protection for the private keys, you can use SCRAMBLECODE in a completely secured environment - not connected to the Internet.


However, once a LicenseID file has been created or updated by the wizard, it must take part in an online registration before it is ready for use, but this can be done from any other machine. Simply move the file LicenseID.txt to another machine and follow the guideline set forth on the web page.


TIP: Please use a separate directory for each LicenseID. The fixed naming scheme for the files strongly promotes using a dedicated directory for each LicenseID, and it can potentially make it easier to define the targets and handle the DLL files later on.


The Purchased Numbers.

In order to create a new LicenseID you must first purchase a serial number, which could look like this: S3AAAA-BBBBBB-CCCCCC-DDDDDD.

This is done as described here: How to Buy and Register.


If you instead want to renew an existing LicenseID you purchase an update number e.g. like this one: U3AAAA-BBBBBB-CCCCCC-DDDDDD.


The different license types use this number structure:


License Type

Serial Number Format

Update Number Format

Single-User Standard

S1AAAA-BBBBBB-CCCCCC-DDDDDD

U1AAAA-BBBBBB-CCCCCC-DDDDDD

Single-User Professional

S2AAAA-BBBBBB-CCCCCC-DDDDDD

U2AAAA-BBBBBB-CCCCCC-DDDDDD

Multi-User Site

S3AAAA-BBBBBB-CCCCCC-DDDDDD

U3AAAA-BBBBBB-CCCCCC-DDDDDD

Multi-User Country

S4AAAA-BBBBBB-CCCCCC-DDDDDD

U4AAAA-BBBBBB-CCCCCC-DDDDDD

Multi-User Global

S5AAAA-BBBBBB-CCCCCC-DDDDDD

U5AAAA-BBBBBB-CCCCCC-DDDDDD

Please notice how the serial numbers for a given license type horizontally matches the update numbers: S1~U1, S2~U2, ... S5~U5.


The purchased serial or update numbers will end up in the LicenseID file - but in an anonymous format like this:  S3AAAA-BBBBBB-******-******. By providing this form of anonymity for each number, we ensure the LicenseID does not contain any vital or secret information.


However, in order to prevent anyone from stealing your LicenseID and perform illegal updates, the original numbers are used to create a signature of the file content, which will eventually be verified as part of the registration process.


Bottom line: Only the person with the original serial number (in full) can create or update a LicenseID.


TIP: Please store the purchased serial number in a safe and secure manner. You will need it every time you want to renew the LicenseID.


Create New LicenseID.

Once you have purchased a serial number from the online shop you're ready to use the wizard to create a new LicenseID.


Please notice: The wizard has the possibility of using a "demo" serial number (using a built-in button named "Try Demo") to test the wizard and get acquainted with the key generator and overall functionality.


These are the steps of the wizard:

Wizard step

Description

1. Enter Purchased Number

Here you write the purchased serial number. It is important to write the number exactly as it was received.

Otherwise press the button "Try Demo".

2. Edit Name Information

This page allows you to enter the name, address and other kinds of information related to the legal entity acquiring the LicenseID in accordance with the EULA. The information must be specified in English, but you may add a translation of the information in your local language, which will be included in a locked manner as a registered part of the license.

3. Specify New Keys

Here you specify the number and type of key pairs, that shall be generated for the LicenseID. The keys are generated1 using the built-in Key Generator and are stored in memory, until you are ready to create the files.

4. Create LicenseID File

Now you create the LicenseID and PrivateKey files. Once the files are saved to disk, the keys in memory are deleted. You will have created these two files:


LicenseID.txt

This file is a text file containing your purchased serial number, name, address AND your public keys.

PrivateKey.txt

This file contains your private keys + a copy of your public keys and the serial number for convenience.
Please keep this file secret and safe at all times.


For this step it is advisable to create a new directory dedicated to this LicenseID.

5. Finish

This is the last step which specify how to register the created LicenseID.


Note 1: When creating the keys, a test is made to ensure the keys can sign and authenticate some random data correctly. Creating and testing the keys may take a while.


Update Existing LicenseID.

When you need to renew the LicenseID for a new UpdatePeriod in accordance with the EULA, you must first purchase an update number from the online shop. Then you're ready to use the wizard to update your LicenseID.


These are the steps of the wizard:

Wizard step

Description

1. Import LicenseID File

You start by importing an existing registered LicenseID file.

2. Enter Purchased Number

Then you enter the purchased update number exactly as received.


The serial number is presented as well, but it contains some ****** characters. Please edit this field and enter the original serial number in full. This serves as a proof, that you are the rightful owner of the LicenseID.

3. Edit Name Information

It is possible to update the information for the legal entity.

4. Specify New Keys

In case your LicenseID does not contain all the public keys allowed for your license type, you may add extra key pairs.

5. Export LicenseID File

When the LicenseID file is exported, it contains both the original current fields and the new updated fields which have not been registered yet. If the LicenseID is exported to its original directory any existing LicenseID file will be copied and renamed for backup before overwriting takes place.


If extra keys have been generated, the PrivateKey file is updated accordingly.

6. Finish

This is the last step which specify how to register the updated LicenseID.