Los usuarios del plugin para impresoras térmicas pueden contratar licencias, y en ocasiones me han preguntado cómo pueden saber si la licencia que tienen es válida, de manera programada usando un lenguaje de programación.
Un caso de uso es revisar si la licencia es válida, y si no lo es, evitar la impresión o enviar una notificación para renovarla. Por ello es que en este artículo voy a mostrarte cómo saber la fecha de inicio y de terminación de tu licencia.
Partes que componen una licencia
Las licencias están codificadas en base64. Una licencia puede lucir así:
NjlmMjExMDhfXzIwMjQtMTItMDVfXzIwMjUtMDEtMDQjIyNlc3RvIGVzIHVuIHRleHRvIHF1ZSBzaW11bGEgbGEgZmlybWEgZGlnaXRhbA==
Si la decodificamos con base64, se ve así:
69f21108__2024-12-05__2025-01-04###esto es un texto que simula la firma digital
La licencia decodificada se compone de dos partes: los detalles de la misma y una firma digital. La firma digital no es relevante para el motivo del post.
El separador de los detalles y la firma es ###
así que si solo tomamos la parte izquierda nos queda:
69f21108__2024-12-05__2025-01-04
Lo que queda ahora es el id del cliente, la fecha de inicio y la fecha de terminación, todos separados con dos guiones bajos (__
). Basta con separar la cadena y comprobar si la fecha actual está dentro del rango.
Esto supone que la licencia no ha sido alterada, y solo sirve como un método de verificación. Si la firma digital no es correcta, la licencia no funcionará, pero si tú no has alterado tu licencia entonces este método cubre perfectamente la necesidad para revisar la validez de la licencia.
Ejemplo con JavaScript
La verificación de la validez de la licencia se puede hacer desde cualquier lenguaje de programación, solo hay que decodificar la cadena usando base64 y después separarla con split.
En JS podemos usar atob
y split
, encerrando todo en una función:
const esLicenciaValida = (licencia) => {
const licenciaDecodificada = atob(licencia);
const detalles = licenciaDecodificada.split("###")[0];
const detallesSeparados = detalles.split("__")
const fechaInicio = detallesSeparados[1];
const fechaFin = detallesSeparados[2];
const fechaActual = new Date(Date.now() - new Date().getTimezoneOffset() * 60000).toISOString().substring(0, 10);
if (fechaActual >= fechaInicio && fechaActual <= fechaFin) {
return true;
}
return false;
}
Después podemos usarla así:
// Licencia como cadena
const licencia = "NjlmMjExMDhfXzIwMjQtMTItMDVfXzIwMjUtMDEtMDQjIyNlc3RvIGVzIHVuIHRleHRvIHF1ZSBzaW11bGEgbGEgZmlybWEgZGlnaXRhbA==";
if (esLicenciaValida(licencia)) {
// La licencia es válida
} else {
// La licencia NO es válida
}
Con esto vas a poder comprobar si la licencia es válida a la fecha de hoy. Incluso puedes calcular cuántos días restan para que venza. En el ejemplo simplemente revisamos si la licencia es válida al día de hoy.
¿Por qué no existe un método que reciba una cadena y te indique si la licencia es válida?
Ya que el plugin es el encargado de revisar la licencia, sería más fácil si existiera un método en la API HTTP ESC POS que recibiera una licencia y devolviera un booleano indicando su validez.
El método expuesto aquí es totalmente confiable, y no he colocado ni colocaré un endpoint en la API porque, aunque es poco factible, se puede hacer un ataque de fuerza bruta para obtener una licencia válida.