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
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
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.
Códigos de error
Cada falla lleva un código estable. La lista de errores de License Manager da cada código y el mensaje que lo acompaña.