User Tools

Site Tools


guanchemos

This is an old revision of the document!


GuancheMOS

GuancheMOS is compatible with applications developed with Xojo and compiled for macOS X (32 bits/64 bits), Windows (32 bits/64 bits), Linux (32 bits/64 bits) and Web executables, both Desktop and Console deployments. (Contact with me if you need a plug-in version able to compile with previous REAL Studio versions of modifications/customized licensing schemes for your products.)

GuancheMOS allows Xojo Macintosh, Windows, Linux and Web developers to include in their applications the ability to generate and validate unique serial numbers or license keys with a minimum effort and a minimum footprint in their final executables.

By using this plug-in, Xojo developers can create their own apps for the automated assignment and control of serial numbers in a per-application basis. Of course the main purpose of GuancheMOS is the integration of the serial validation process in the final apps with the simple call to a function.

Please, note that GuancheMOS is a commercial product. Registered users of GuancheMOS will be able to use this plug-in in all their applications without pay additional fees.

What is included with GuancheMOS?

GuancheMOS

This is the plug-in that you must drop into your Xojo > Plug-ins folder in order to use its features in your own developments.

GuancheMOS Test

This is the source code project of a bare-bones Xojo application that tests the installation, generation and validation of serial number features. Please, note that this application is a test plug-in one, and that was not designed for production use. Probably you will want to create your own creation/validation application with additional features.

In demo mode GuancheMOS only allows 3 serial number/licenses generation per session, and the validation feature is disabled. This demo should give you a good taste about how easy it is to use and implement the solution into your own Xojo projects.

How to use the plug-in

GuancheMOS is integrated in the Xojo development IDE as an additional Module (GuancheMOS) offering a total of four methods. That’s all, very easy and fast to use and implement in your own developments:

  • Create( platform, name, seed1, seed2 ) as string
  • Validate( platform, name, seed1, seed2, license) as boolean
  • CheckWithLicense( platform, name, seed1, seed2, license, nameoflicense, previousGuancheMOS license,mode) as boolean
  • Register( mode, name, license)

Register

This is the method responsible of registering GuancheMOS with the license key provided by AprendeXojo. 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 code 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.

Please, to avoid that other people could extract your personal license data, and abuse it witch may take you in trouble, try to hide the “name” and “license” strings inside your application.

Parameter nameTypeDescription
modeintegerYou can select from four different modes, ranging from 1 to 4. The number used changes the algorithm in charge of the Serial Number generation.
namestringEnter here the name data send to you by AprendeXojo as part of the GuancheMOS license key process.
licensestringEnter here the license key provided by AprendeXojo.

Returned Value: Nothing

Create

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 own “serial number assignment application” for your products.

Note: Use different seed1 and seed2 values for each one of your applications.

Parameter nameTypeDescription
platformbooleanIn the current version you must set always True.
namestringUse 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.
seed1stringUse this argument to enter the first data seed that will be used for GuancheMOS to scramble the main data. You can enter alphanumeric or only numeric value inside.
seed2stringUse 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.

Returned Data: A string with the serial number/license key for the provided data.

Validate

This is the GuancheMOS method responsible of the validation of a supposed valid serial number against the GuancheMOS engine. This is the method that you must use in your released applications, so your users can introduce the data (serial number) provided by you. You're responsible of creating the logic in your apps so the user doesn't need to input the serial number once it is validated. If you need help with this, I can help you to implement robust schemes in your apps as I already have done with several Xojo based products.

Parameter nameTypeDescription
platformbooleanIn the current version you must enter always True.
namestringThe main data to be scrambled. The usual is to enter the name or the e-mail address of the user for which you want to generate a serial number.
seed1stringUse this argument to enter the first seed data that will be used to check the scrambled data.You must enter here the alphanumeric or numeric value used previously in the creation of the serial number to validate.
seed2stringUse 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.
licensestringEnter here the license or serial number data to validate against the seed1, seed2 and name values.

Returned Data: True if the engine validates the provided serial number against the data; otherwise it will return False.

CheckWithLicense

This one is the GuancheMOS method responsible of the validation of a supposed valid serial number generated with a previous version of GuancheMOS against the actual GuancheMOS engine. Please, remember that you need to Register again your GuancheMOS plug-in before use again the Verify method.

Parameter nameTypeDescription
platformbooleanIn the current version you must enter always True.
namestringThe main data to be scrambled. The usual is to enter the name or the e-mail address of the user for which you want to generate a serial number.
seed1stringUse this argument to enter the first seed data that will be used to check the scrambled data.You must enter here the alphanumeric or numeric value used previously in the creation of the serial number to validate.
seed2stringUse 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.
licensestringEnter here the license or serial number data to validate against the seed1, seed2 and name values.
previousnamelicensestringUse this argument to enter the name for registering a previous version of GuancheMOS
previousguanchemoslicensestringUse this argument to enter your previous GuancheMOS license.
modeintegerUse this argument to enter the mode used with the previous GuancehMOS version in the generation of the serial number that you want to check.

Returned Data: True for a valid serial number; otherwise the result returned will be False.

GuancheMOS Release Notes

  • GuancheMOS 1.8 Added compatibility with new Xojo Plug-in format and Xojo 2015r3. Added compatibility for 64 bits compiled applications under OS X, Windows and Linux.
  • GuancheMOS 1.7 Fixes a Windows compilation problem from REALbasic 2008 and later.
  • GuancheMOS 1.6 Adds compatibility for Linux.
  • GuancheMOS 1.5.6 Includes the ability of checking the serial numbers generated from the 1.5.x version of GuancheMOS.
  • GuancheMOS 1.5.5 Includes support to compile with the Mac OS X Universal Binary executables compiled with REALbasic 2006r4, Fixes some glitches and improves some inner works.
  • GuancheMOS 1.5 Includes four new modes for the creation of the Serial Number. Each mode is assignable in the Register method.
guanchemos.1567755722.txt.gz · Last modified: 2019/09/06 09:42 by bloguintosh