> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.
# License Manager
> Cómo un producto Lerian con licencia valida su clave de licencia, qué permite cada resultado y cómo se comporta cuando el servicio de licencias no responde.
Lerian emite una clave de licencia para cada producto y plugin Enterprise. El producto valida la clave cuando arranca, y de nuevo a un intervalo fijo. Esta página describe qué configuras, a qué host llama el producto y qué permite cada resultado.
Estos comportamientos describen productos construidos sobre la biblioteca de Go. Los productos construidos sobre la biblioteca de TypeScript difieren. El cache dura 24 horas. La verificación se aplica a cada ruta, incluidas las health probes. Una respuesta de rate limit no extiende el número de intentos. El producto nunca lee el header `X-Organization-Id`, y envía los identificadores de organización configurados al servicio de licencias en cada verificación.
## Qué es una clave de licencia
***
Una clave de licencia cubre un producto y los identificadores de organización que declaras para él. Un producto acepta la clave solo para esas organizaciones, y solo para sí mismo. Almacena la clave como un secreto y mantenla fuera del control de versiones.
## Qué lee el producto del entorno
***
| Variable | Contenido |
| :----------------- | :----------------------------------------------------------------------------------------------------------------------------------------------- |
| `LICENSE_KEY` | La clave que Lerian emitió para este producto. |
| `ORGANIZATION_IDS` | Los identificadores de organización que cubre la clave, separados por comas. Usa `global` cuando Lerian otorga la licencia a todo el despliegue. |
| `IS_DEVELOPMENT` | Opcional. Defínelo en `true` para validar contra `https://license.dev.lerian.io` en lugar del host de producción. |
Un producto que no tiene identificador de organización no arranca.
## Cómo se ejecuta la verificación
***
El producto envía su propio nombre, la clave de licencia y un identificador de organización a `https://license.lerian.io`. Lerian opera ese servicio. Abre HTTPS de salida hacia ese host desde cada carga de trabajo que ejecuta un producto con licencia, o cada verificación falla. Una carga de trabajo que define `IS_DEVELOPMENT` en `true` necesita la misma regla para `https://license.dev.lerian.io`.
El producto valida al arrancar y luego repite la verificación cada siete días en segundo plano. Guarda cada resultado en memoria durante ocho días. Un intento espera hasta cinco segundos por una respuesta. La actualización en segundo plano hace tres intentos, o cinco intentos cuando el servicio reporta demasiadas solicitudes. La verificación de arranque hace un intento.
Cada solicitud debe llevar el identificador de organización en el header `X-Organization-Id`, a menos que definas `ORGANIZATION_IDS` en `global`. El producto compara el header contra `ORGANIZATION_IDS` y luego responde desde el resultado en cache o repite la verificación. Las solicitudes a `/health`, `/version` y `/swagger/` omiten la verificación.
## Qué permite cada resultado
***
| Resultado | Qué hace el producto |
| :--------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------- |
| Activa | El producto se ejecuta. Registra una advertencia 30 días antes del vencimiento, y una advertencia más fuerte en los últimos 7 días. |
| Prueba | El producto se ejecuta y registra los días que quedan. Registra una advertencia en los últimos 2 días. |
| Vencida, período de gracia abierto | El servicio otorga 14 días de gracia desde el día en que registra el vencimiento. El producto se ejecuta y registra una advertencia. |
| Período de gracia cerrado | El servicio suspende la clave. El producto se detiene. |
| Sin licencia válida al arrancar | El producto se detiene y escribe la razón en el log. |
## Cuando el servicio de licencias no responde
***
El producto prefiere un resultado que ya tiene. Si el servicio devuelve un error de servidor, un producto que declara una organización o `global` usa el último resultado en cache para esa organización. Si no tiene ningún resultado en cache, el producto continúa siete días más y repite la verificación después. Un producto que declara varias organizaciones no lee el cache ante un error de servidor. Continúa siete días más.
Si la red falla, un producto que declara una organización o `global` usa de nuevo el resultado en cache. Si no tiene ningún resultado en cache, la solicitud falla con el código `LCS-0012`. Si cada organización configurada falla por una razón distinta a demasiadas solicitudes, el producto se detiene. Esto se aplica al arrancar y en cada verificación posterior.
El producto se detiene si el servicio de licencias sigue inalcanzable más allá de los ocho días del resultado en cache. También se detiene si reinicia sin resultado en cache durante una interrupción. Monitorea la regla de salida y los logs de validación.
## Códigos de error
***
Cada falla lleva un código estable. La [lista de errores de License Manager](/es/platform/licensing/license-manager-error-list) da cada código y el mensaje que lo acompaña.