@themaximalist/keygen.js

A Node.js library for Keygen.sh, a license management server.

Keygen.js is a library for interacting with Keygen.sh, a service for managing license keys in software.

If you're an app developer, and you sell software with a license, Keygen.sh is an easy API to manage that. They provide a self-hosted option, so you can run it on your own servers.

Keygen.js is a Node.js library that's a convenient wrapper around the API.

It offers two primary use cases:

• Used for validating keys on the frontend (like in your Electron or Express.js based app)
• Used for managing products, licenses and policies by an admin

Install Keygen.js from NPM:

npm install @themaximalist/keygen.js

Setting up Keygen is straight forward—check out their self hosted documentation.

You'll need your KEYGEN_ACCOUNT_ID to use Keygen.js, which the docs above show you how you retrieve.

Here's how to use Keygen.js to:

• Create an API token
• Create a new product
• Create a new license type (policy)
• Create a new license

const Keygen = require("@themaximalist/keygen.js");

// set these from the install step, or load them through the environment
const account_id = process.env.KEYGEN_ACCOUNT_ID;
const account_email = process.env.KEYGEN_ACCOUNT_EMAIL;
const account_password = process.env.KEYGEN_ACCOUNT_PASSWORD;

// create keygen for this account
const keygen = new Keygen({ account_id });

// generate a token..can be saved and reused
const token = await keygen.createToken(account_email, account_password);
const api_key = token.attributes.token;

// create a new product
const product = await keygen.createProduct(api_key, {
    "name": "AppName"
});

// create a new policy for the product
const policy = await keygen.createPolicy(api_key, product.id, {
    "name": "Paid License",
    "duration": null,
    "maxMachines": 5,
    "floating": true,
    "machineUniquenessStrategy": "UNIQUE_PER_POLICY"
});

// create a new license
const license = await keygen.createLicense(api_key, paid_policy.id, {
    email: "email@example.com"
});

// this is what the user will use to register the software
const license_key = license.attributes.key;

This shows how an admin can initialize Keygen to create licenses for a new product type with a specific license type.

Keygen can also be used on the frontend—without specifying your admin email and password. All you need is an account ID to get started.

const keygen = new Keygen({ account_id });
const { valid } = await keygen.validateLicense(license_key);

// valid will be true or false, depending on whether the license key is valid

This let's you check license keys client side, like in an Electron app, without worrying about leaking your admin credentials.

The Keygen.js API provides a simple to manage your Keygen service.

new Keygen({
  account_id: "...",
  base_url: "https://api.keygen.localhost",
  ignore_ssl: false,
  machine_id: "...",
});

Config

The account_id config is required, everything else is optional.

• account_id <string>: Keygen account ID (required)
• base_url <string>: Endpoint for Keygen server. Defaults to https://api.keygen.localhost
• ignore_ssl <bool>: Ignore SSL errors. Useful in development, don't use in production! Defaults to false.
• machine_id <string>: Unique ID to use for identifying the machine. Defaults to internally generated value.

const token = await keygen.creatToken(email, password);
const api_key = token.attributes.token;

const product = await keygen.createProduct(api_key, {
    "name": "HyperTyper"
});

const products = await keygen.getProducts(api_key);

const product = await keygen.getProduct(api_key, product_id);

const product = await keygen.createPolicy(api_key, product_id, {
    "name": "Paid Policy",
    "duration": null,
    "maxMachines": 5,
    "floating": true,
    "machineUniquenessStrategy": "UNIQUE_PER_POLICY"
});

const policies = await keygen.getPolicies(api_key, product_id);

const license = await keygen.createLicense(api_key, policy_id, {
	email: "email@example.com",
});
const key = license.attributes.key;

const licenses = await keygen.getLicenses(api_key, product_id);

const license = await keygen.getLicense(api_key, license_id);

const { valid } = await keygen.validateLicense(key);

• PAID_POLICY <object>: { "name": "Paid Policy", "duration": null, "maxMachines": 5, "floating": true, "machineUniquenessStrategy": "UNIQUE_PER_POLICY" }

Keygen.js is a great way to manage software licenses programatically, but to manage them with a UI, check out Keygen Admin. It's an admin dashboard on top if Keygen.js for managing your software licenses.

If you'd rather skip the headache of running your own server, check out of the official Keygen.sh hosted service.

Keygen.js is currently used in the following projects:

• HyperTyper — multidimensional mind mapping

MIT

Created by The Maximalist, see our open-source projects.