 | | |
© 2008 Mosquito SW — All Rights Reserved | ||
| | |
"The GuancheMOS plugin definitely achieves its goal of being 'the easy way serial number machine' and is therefore highly recommended for any REALbasic developer looking to add serial number functionality to their deployed applications."
Scott Griebel
GuancheMOS is integrated in the REALbasic development IDE as an additional Module (GuancheMOS) with four methods registered inside.
That’s all, very easy and fast to use and implement in your own developments.
Create( platform, name, seed1, seed2 ) as string
This is the GuancheMOS method responsible of the creation of a unique serial number based on the provided data. Please, note that all of the parameters are mandatory. This is the method that you will use in your serial number assignment application / utility.
Note: Use different seed1 and seed2 values for each one of your applications.
Result: This method will return a string with a unique serial number / license key format.
Parameter name | Value | Description |
platform | boolean | In the current version you must set always `True’. |
name | string | Use this argument to provide the main data to be scrambled. Generally this is used to enter the user’s name or e-mail address for which you want to generate a serial number. |
seed1 | string | Use this argument to enter the first data seed that will be used for GuancheMOS to scramble the main data. You can provide alphanumeric or only numeric values. |
seed2 | string | Use this argument to enter the second data seed that will be used for GuancheMOS to scramble the main data. You must enter a numeric value inside (`dot’ separation allowed; for example “1.0.2.1”. |
Validate( platform, name, seed1, seed2, license) as boolean
This is the GuancheMOS method responsible of the validation of a previously created serial number.
This is the method that you must use for serial number validation during the user registration process of your deployed applications.
Result: the validation method will return the `True’ boolean value for a valid serial number; otherwise the result returned will be the `False ́ boolean value.
Parameter name | Value | Description |
platform | boolean | In the current version you must enter always `True’. |
name | string | The main data to be verified. The usual is to enter the name or the e-mail address of the user for which you want to validate a serial number. This must be the same user data that you used with the Create method. |
seed1 | string | Use this argument to enter the first seed data that will be used to check the scrambled data.You must enter the same alphanumeric or numeric value used previously in the creation of the serial number. |
seed2 | string | Use this argument to enter the second seed data that will be used for GuancheMOS to check the scrambled data. You must enter here the alphanumeric or exclusive numeric value used previously in the creation of the serial number to validate. |
license | String | Enter here the license or serial number data to validate against the seed1, seed2 and name values. |
Register( platform, name, license)
This is the method responsible of registering GuancheMOS with the license key provided by Mosquito SW. Otherwise the plug-in will work in Demo Mode.
Note: Be sure to register the plug-in as soon as possible during the execution of your application or before using the Create or Validate methods. For example, the Open Event of the App class is a good place. Otherwise the GuancheMOS code will run in Demo Mode.
to avoid that other people could extract your personal license data, hide the “name” and “license” strings inside your application.
Result:None.
Parameter name | Value | Description |
platform | integer | You can select from four different modes, ranging from 1 to 4. The number used changes the algorithm in charge of the Serial Number generation. |
name | string | The `name’ data send to you by Mosquito SW as part of the GuancheMOS license key process. |
license | string | Enter here the license key provided by Mosquito SW. |
GuancheNEWS
