Lerian's License

Lerian licenses authorize access to paid products and plugins with organization-scoped and global license types, plus activation and validation rules.

A license is a key that authorizes access to Lerian features or services under specific contractual conditions, typically aligned with billing cycles (e.g., monthly, annual). This mechanism is similar to how software products like Microsoft Office or GitHub Enterprise manage access through activation keys.

In Lerian’s ecosystem, licenses:

• Confirm that customers remain in good standing before they access paid features, such as products, plugins or enterprise features.
• Manage which features are available per client.
• Let Lerian scale support and sales operations.

Only clients with valid licenses, as defined in their contracts, can access specific software components.

The organization that makes the request must have a valid license. Otherwise, access will be denied.

License types

---

In Lerian’s ecosystem, licenses can have two different scopes, depending on the plugin:

Organization-specific licenses (non-global)

Applies to a single organization.

Example: Fees Engine, Reporter.

You can use the license with any number of ledgers inside that organization.

Global licenses

Valid for multiple organizations.

Example: Access Manager.

License usage workflow

---

The steps below apply to both license types:

1. Submit a license request to Lerian.

   • For organization-specific plugins: provide the organization_id that will use the license.
   • For global plugins: inform Lerian that you need a global license. You do not need an organization_id.
2. License generation and activation by Lerian

   Lerian’s team follows the internal process to create and activate the license using the provided details.

3. License key delivery

   Lerian sends the License Key (LICENSE_KEY) to the client.

4. Environment configuration

   Once you receive your license key, you must configure your .env file so the system knows which license to validate and which organizations it applies to.

Always configure the correct environment variables before using a plugin. Incorrect or missing values will result in license validation errors.

Organization-specific licenses (non-global)

These licenses apply to one organization only.

Bash

# LICENSE
LICENSE_KEY=<license key>
ORGANIZATION_IDS=<organization-id1>,<organization-id2>

• LICENSE_KEY: The key provided by Lerian.
• ORGANIZATION_IDS: The ID of the organization linked to the license.

Global licenses

These licenses have a global scope and must always use the value global in the ORGANIZATION_IDS variable.

Bash

# LICENSE
LICENSE_KEY=<license key>
ORGANIZATION_IDS=global

• LICENSE_KEY: The key provided by Lerian.
• ORGANIZATION_IDS: Use the value global for global licenses.

License-related errors

---

For an invalid or expired license, API responses or plugin behaviors may return one of these error messages:

Code	Title	Message
LCS-0001	Internal server error	An internal server error occurred. Please try again later or contact support if the problem persists.
LCS-0002	No organization IDs configured	The application is not configured with any organization IDs.
LCS-0003	No valid licenses found for any organization	No valid licenses were found for any of the configured organizations. Please check your license keys and ensure at least one organization has a valid license.
LCS-0010	Organization ID header is missing	The X-Organization-ID header is missing. Please ensure the header is included in the request.
LCS-0011	Organization ID header is unknown	The organization ID ‘12345’ was not found in the list of configured organizations. Please verify you are using a valid organization ID.
LCS-0012	Failed to validate organization license	License validation failed for organization ID 12345. This could be due to network issues, invalid license keys, or server-side problems. Please verify your license key is correct and that you have network connectivity to the license server.
LCS-0013	Organization license is invalid	The license for organization ID ‘12345’ is not valid and has no grace period active. Please renew your license or contact support for assistance.
LCS-1001	Validation error	Could not validate license key. Please try again later or contact your system administrator.
LCS-1002	License not found	There is no license for this license key. Please ensure the license key is correct and try again.
LCS-1003	License expired	The license key has expired. Please contact your system administrator to renew your license.
LCS-1004	License suspended	The license key has been suspended due to payment issues or administrative action. Please contact your system administrator.
LCS-1005	Fingerprint mismatch	The license key or organization IDs are not valid for this license. Please ensure the license key and organization IDs are correct and try again.
LCS-1006	Product mismatch	There is no license for this product. Please ensure the license key is correct and try again.

For more information about your license or to request an upgrade, please contact the Lerian commercial team.