advanced-key-generator v1.0.5

advanced-key-generator

advanced-key-generator is a library for generating random API (Application Programming Interface) keys or access tokens. By using this library, a Node.js backend service can generate API keys or access tokens, and then issue them to users and/or other services that require access to the capabilities and resources provided by the API service.

Table of contents

• Installation
• Usage
  • Generation Methods
• Options
  • string Method
  • bytes Method
  • base32 Method
  • base62 Method
  • uuidv4 Method
  • uuidv5 Method
  • sha256 Method
  • sha512 Method
  • jwt Method
  • md5 Method
• Security
• Change Log
• License

Installation

Using NPM:

$ npm install advanced-key-generator

Using Yarn:

$ yarn add advanced-key-generator

Usage

The advanced-key-generator library can generate API key/access tokens by utilizing several generation methods, such as string, bytes, base32, base62, uuidv4, uuidv5, sha256, sha512, jwt, and md5. Additionally, it provides functions to verify the validity of API keys and check if they have expired.

Importing:

// CommonJS Import
const { generateApiKey, verifyKey, isExpired } = require('advanced-key-generator');
// OR
const { default: generateApiKey, verifyKey, isExpired } = require('advanced-key-generator');

// ES6 Import
import { generateApiKey, verifyKey, isExpired } from 'advanced-key-generator';

Generation Methods

Options

See the Options section for detailed descriptions of available options for each generation method.

Example Usage

Generate an API Key

import { generateApiKey } from 'advanced-key-generator';

// Generate the API key using default method 'string'.
console.log(generateApiKey()); // ⇨ 'q_EaTiX+xbBXLyO05.+zDXjI+Qi_X0v'

// Generate an API key with expiration time.
const apiKey = generateApiKey({ method: 'string', length: 20, expiration: 3600 }); // 1 hour
console.log(`Generated API Key: ${apiKey}`);

Verify an API Key

import { verifyKey } from 'advanced-key-generator';

// Verify the generated API key.
const isValid = verifyKey(apiKey, 'string');
console.log(`Is API Key Valid? ${isValid}`);

Check if an API Key is Expired

You can check if an API key has expired using the isExpired function. Ensure that the object you pass to the function contains both the API key and its expiration timestamp (expiresAt).

Here's an example of how to use the isExpired function:

import { isExpired } from 'advanced-key-generator';

// Example API key with expiration timestamp
const apiKeyObject = {
  apiKey: 'your-api-key',
  expiresAt: 1724564930854 // Example expiration timestamp in milliseconds
};

// Check if the API key has expired
const expired = isExpired(apiKeyObject);
console.log(`Is API Key Expired? ${expired}`);

New Functions

verifyKey(apiKey, method)

Verifies if the provided API key matches the expected format for the given generation method.

Returns true if the API key matches the expected format, otherwise false.

isExpired(apiKeyObject)

Check if the provided API key has expired based on its stored expiration date.

Returns true if the API key has expired, otherwise false.

Options

string Method

Creates an API key/access token using random string generation.

Examples:

import generateApiKey from 'advanced-key-generator';

// Generate the API key using default method 'string'.
console.log(generateApiKey()); // ⇨ 'q_EaTiX+xbBXLyO05.+zDXjI+Qi_X0v'

// Provide the generation method.
console.log(generateApiKey({ method: 'string' })); // ⇨ 'Zt1HbMcLKxk6~nnW'

// Create an API key with a certain length.
console.log(generateApiKey({ method: 'string', length: 8 })); // ⇨ 'TNJ6-Lo4'

// Create an API key with a length between a certain range.
console.log(generateApiKey({ method: 'string', min: 10, max: 20 })); // ⇨ 'ENwiOFdP8cWj'

// Create an API key with a certain pool of characters.
console.log(generateApiKey({
  method: 'string',
  pool: 'ABCDEFGHIJKLMNOPQRSTUVWXYZ'
})); // ⇨ 'QFLSGIDLOUAELQZTQXMHQNJ'

// Create an API key with a prefix.
console.log(generateApiKey({ method: 'string', prefix: 'test_app' })); // ⇨ 'test_app.aTd34Rli0nir70/8'

// Create a batch (certain amount) of API keys.
console.log(generateApiKey({ method: 'string', batch: 5 })); 
// [
//   'w05KkI9AWhKxzvPFtXotUva-',
//   'YFL0ICl4PtLD8Y/oQ20iyAE',
//   'vJFbfeP_cpMYsH9l5BVHY23Ss',
//   '29~LIlSjDYFr5OrhU3f',
//   'UQc8Tp1d9elWAh7KDIMkjz2moFs'
// ]

jwt Method

Creates a JSON Web Token (JWT) using a specified payload and secret.

Examples:

import generateApiKey from 'advanced-key-generator';

// Provide the generation method.
console.log(generateApiKey({ method: 'jwt', payload: { userId: 1 }, secret: 'mySecret' })); 
// ⇨ 'eyJ

hbGciOiAiSFMyNTYiLCAiaWF0IjoxNjE4MjU2OTU5LCAiZXhwIjoxNjE4MjcwNTU5fQ.eyJ1c2VySWQiOiAxfQ.qMc7aSVE_9xwbjLxnhecMxkXetZYq3Fphs4sdjQkMk'

md5 Method

Creates an API key/access token using MD5 hash generation.

Examples:

import generateApiKey from 'advanced-key-generator';

// Generate the API key using MD5 hash generation.
console.log(generateApiKey({ method: 'md5', input: 'exampleString' })); 
// ⇨ '6c569aabb98f037b92c0e5f1d0f600d8'

Security

Ensure that you keep your API keys secure and do not expose them publicly. Use secure storage solutions such as environment variables or dedicated secrets management services to store and manage your keys.

Change Log

See the CHANGELOG.md file for details about the latest updates and changes.

License

This project is licensed under the MIT License - see the LICENSE file for details.

This README provides detailed examples for each method, ensuring that users can easily understand how to use each feature of the `advanced-key-generator` library. Make sure to replace placeholder links and

images with actual URLs relevant to your project. If you need more help or have other questions, feel free to ask!