Skip to content

Generate license keys for given company details

License

Notifications You must be signed in to change notification settings

rouftom/license-keygen-next

 
 

Repository files navigation

🔑 license-keygen-next

MIT license GitHub release (latest by date) npm GitHub code size in bytes


This project is a fork of license-key-gen

The particularity of this library compared to license-key-gen is that the latter incorporates the concept of validity which allows the license to have an expiration date without being checked by a remote server.

license-keygen-next

  • Generate license keys for given company details

Source

This project has been imported from license-keygen-next in npm.org.

Docs

Generate a License Key and validate the license. This is typically used for software licensing (serial number).

Installation

npm install license-keygen-next

Data Structure

To create a license key - Enter the users information that your are able to recieve

This object can be any data you wish to tie the license to - format Object

var userInfo = {
  name: '3MLogics',
  country: 'Cameroon',
  town: 'Douala',
  poBox: '8388',
  address: 'Akwa,
  // other infos
}

Must include:

  1. userInfo.name (string) - entity name

  2. userInfo.country (string) - entity country

  3. userInfo.town (string) - entity town

  4. userInfo.zip (string) - entity zip

  5. userInfo.address (string) - entity address

  6. ProductCode (string) - product abbr name, can be any size

  7. AppVersion (string) - optional if you want to tie the license to a version number

  8. osType (string) - lock the license to a specific operating system supported: Windows: WIN, WIN7, WIN8,WIN10 Macintosh: OSX, OSX1, OSX2, OSX3, OSX4, OSX5, OSX6, OSX7, OSX8, OSX9, OSX10, OSX11, OSX12 Apple Mobile: IOS, IOS5, IOS6, IOS7, IOS8, IOS9,IOS10 Google Mobile: ANDROID, ANDROID2, ANDROID3, ANDROID4, ANDROID43, ANDROID44, ANDROID5, ANDROID6, ANDROID7 OTHER

  9. validity (string) - license expiration date

var userLicense = {
  info: userInfo, 
  validity: '2027-01-01',
  prodCode:"LEN100120", 
  appVersion:"1.5", 
  osType:'IOS8'
} 

Init

const licenseKey = require('license-keygen-next')

Create a License Key

Then run the following code to recieve the License for the client This function to be run ONLY for you to generate the license code for the client

const licenseKey = require('license-keygen-next')

var userInfo = {
  name: '3MLogics',
  country: 'Cameroon',
  town: 'Douala',
  poBox: '8388',
  address: 'Akwa',
  // other infos
}

var licenseData = {
  info: userInfo, 
  validity: '2027-01-01',
  prodCode:"LEN100120", 
  appVersion:"1.5", 
  osType:'IOS8'
}

try{
    const license = licenseKey.createLicense(licenseData)
    console.log(license)
}catch(err){
    console.log(err)
}

if success returns

{ errorCode: 0,  message: 'ok',  license: '312220-0A0YW1-RBRCCX-20WDY4-XB1A71' }

if error, returns

{ errorCode: 1002, message: 'product code missing' }

Validate a License Key

On client side your application will pass the user information (Data Structure) and License Key:

⚠️ Specifying the validity of the license is no longer necessary during validation

const licenseKey = require('license-keygen-next')

var userInfo = {
  name: '3MLogics',
  country: 'Cameroon',
  town: 'Douala',
  poBox: '8388',
  address: 'Akwa',
  // other infos
}

var licenseData = {
  info: userInfo, 
  prodCode: "LEN100120", 
  appVersion: "1.5", 
  osType: 'IOS8'
}

try{

    const license = licenseKey.validateLicense(licenseData, "312220-0A0YW1-RBRCCX-20WDY4-XB1A71")
    console.log(license)
    
}catch(err){
    console.log(err)
}

if success returns

{ errorCode: 0, message: 'ok' }

if error, returns

{ errorCode: 1006, message: 'license not valid' }

TODO

  • maintain (save, delete, update, read) licenses and user registration information

Support

Tested in Chrome 53-54, Firefox 48-49, IE 11, Edge 14, Safari 9-10, Node.js 6-7, & PhantomJS 2.1.1.
Automated test runs are available.

About

Generate license keys for given company details

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 100.0%