Saltar al contenido principal
Una licencia es una clave que autoriza el acceso a características o servicios de Lerian bajo condiciones contractuales específicas, típicamente alineadas con ciclos de facturación (por ejemplo, mensual, anual). Este mecanismo es similar a cómo los productos de software como Microsoft Office o GitHub Enterprise gestionan el acceso a través de claves de activación. En el ecosistema de Lerian, las licencias juegan un papel crítico en:
  • Asegurar que los clientes estén al día antes de acceder a características de pago, como productos, plugins o características empresariales.
  • Gestionar qué características están disponibles por cliente.
  • Permitir que Lerian escale las operaciones de soporte y ventas de manera segura y eficiente.
En resumen, solo los clientes con licencias válidas, según lo definido en sus contratos, pueden acceder a componentes de software específicos.
Una licencia válida debe estar asociada con la organización que realiza la solicitud. De lo contrario, el acceso será denegado.

​
Tipos de licencia

En el ecosistema de Lerian, las licencias pueden tener dos alcances diferentes, dependiendo del plugin:

​
Licencias específicas de organización (no globales)

Se aplica a una única organización. Ejemplo: Fees Engine, CRM, Reporter.
Puedes usar la licencia con cualquier número de ledgers dentro de esa organización.

​
Licencias globales

Válidas para múltiples organizaciones. Ejemplo: Access Manager.

​
Flujo de uso de licencias

Los pasos a continuación se aplican a ambos tipos de licencia:
1

Enviar una solicitud de licencia a Lerian.

  • Para plugins específicos de organización: proporciona el organization_id que utilizará la licencia.
  • Para plugins globales: informa a Lerian que necesitas una licencia global; no se requiere organization_id.
2

Generación y activación de licencia por Lerian

El equipo de Lerian sigue el proceso interno para crear y activar la licencia utilizando los detalles proporcionados.
3

Entrega de clave de licencia

Lerian envía la Clave de Licencia (LICENSE_KEY) al cliente.
4

Configuración del entorno

Una vez que recibas tu clave de licencia, debes configurar tu archivo .env para que el sistema sepa qué licencia validar y a qué organizaciones se aplica.
Siempre configura las variables de entorno correctas antes de usar un plugin. Valores incorrectos o faltantes resultarán en errores de validación de licencia.
Licencias específicas de organización (no globales) Estas licencias se aplican solo a una organización. 
# LICENSE
LICENSE_KEY=<license key>
ORGANIZATION_IDS=<organization-id1>,<organization-id2>
  • LICENSE_KEY: La clave proporcionada por Lerian.
  • ORGANIZATION_IDS: El ID de la organización vinculada a la licencia.
Licencias globales Estas licencias tienen un alcance global y deben usar siempre el valor global en la variable ORGANIZATION_IDS. 
# LICENSE
LICENSE_KEY=<license key>
ORGANIZATION_IDS=global
  • LICENSE_KEY: La clave proporcionada por Lerian.
  • ORGANIZATION_IDS: Debe establecerse como global para licencias globales.

​
Errores relacionados con licencias

Cuando una licencia es inválida o ha expirado, las respuestas de la API o comportamientos de plugins pueden devolver uno de los siguientes mensajes de error específicos:
CódigoTítuloMensaje
LCS-0001Internal server errorAn internal server error occurred. Please try again later or contact support if the problem persists.
LCS-0002No organization IDs configuredThe application is not configured with any organization IDs.
LCS-0003No valid licenses found for any organizationNo 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-0010Organization ID header is missingThe X-Organization-ID header is missing. Please ensure the header is included in the request.
LCS-0011Organization ID header is unknownThe organization ID ‘12345’ was not found in the list of configured organizations. Please verify you are using a valid organization ID.
LCS-0012Failed to validate organization licenseLicense 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-0013Organization license is invalidThe license for organization ID ‘12345’ is not valid and has no grace period active. Please renew your license or contact support for assistance.
LCS-1001Validation errorCould not validate license key. Please try again later or contact your system administrator.
LCS-1002License not foundThere is no license for this license key.
LCS-1003License expiredThe license key has expired.
LCS-1004License suspendedThe license key has been suspended due to payment issues or administrative action.
LCS-1005Fingerprint mismatchThe license key or organization ID are not valid for this license.
LCS-1006Product mismatchThere is no license for this product.
Para más información sobre tu licencia o para solicitar una actualización, por favor contacta al equipo comercial de Lerian.