Licencias

Vision funciona solo con una licencia de Cesbo. Una instalación nueva queda bloqueada hasta que un administrador la activa. La licencia no está vinculada a una dirección IP, nombre de host, ID de máquina ni hardware: un número de serie cubre un dispositivo activado.

Cómo obtener una licencia

Vision necesita dos cosas: una licencia de Cesbo y un servidor Cesbo Alta que gestionar. Las licencias se gestionan en tu perfil de Cesbo en app.cesbo.com, por los miembros de la empresa propietaria de la licencia. Para usar una, abre Settings → License → Activate en Vision y elígela en la página de Cesbo (consulta Activación).

Qué cubre una licencia

Un número de serie cubre un dispositivo activado: un host de Vision. No está vinculado a una dirección IP, nombre de host, ID de máquina ni hardware.
Los miembros de la empresa propietaria de la licencia activan, reemplazan y eliminan dispositivos en el perfil de Cesbo.
Mover Vision a otro hardware significa activar el nuevo host y reemplazar el dispositivo anterior en la página de Cesbo. Consulta Eliminar o reemplazar un dispositivo.
No copies un license.txt a un segundo host: ambos ocuparían la misma plaza de dispositivo.

Qué significa “bloqueado”

Mientras la licencia no lo permita:

cada llamada a la API responde 403 LICENSE_REQUIRED, excepto el inicio de sesión y los endpoints de licencia;
los usuarios que pueden leer los parámetros son enviados a Settings → License; todos los demás ven una página License required;
la interfaz web, /healthz, /readyz y /metrics siguen disponibles, y los workers en segundo plano siguen ejecutándose;
las sesiones de video abiertas agotan sus tokens.

Vision se desbloquea por sí solo después de la siguiente comprobación exitosa.

Los 30 minutos de gracia tras un arranque (consulta Operación sin conexión) cubren únicamente un servidor de licencias inalcanzable, no una licencia ausente.

Activación

Solo un usuario que puede cambiar los parámetros puede activar.

Abre Settings → License y haz clic en Activate.
Abre el enlace e inicia sesión en tu perfil de Cesbo como miembro de la empresa propietaria de la licencia.
Comprueba que el nombre de host de la página sea el de este dispositivo y luego elige la licencia. Si la licencia no tiene un espacio libre, elige el dispositivo que se reemplazará. Se elimina solo cuando este dispositivo recibe la licencia, y deja de funcionar en su siguiente comprobación posterior.
Vision recibe la licencia por sí solo, escribe license.txt y la comprueba de inmediato.

El enlace caduca a los 10 minutos. Una activación fallida o caducada puede iniciarse de nuevo con Start again o eliminarse con Dismiss; Cancel descarta una pendiente. Una activación cancelada, fallida o caducada no elimina ningún dispositivo, incluso si ya se había elegido un dispositivo para reemplazar en la página de Cesbo.

Vía manual: colocar `license.txt` en su sitio

Cuando la activación no puede alcanzar app.cesbo.com, o el soporte te envía el archivo, descarga license.txt del dispositivo desde tu perfil de Cesbo y escríbelo en el archivo existente, conservando su propietario y modo (vision:vision, 0600):

sudo tee /etc/vision/license.txt < license.txt >/dev/null
sudo ls -l /etc/vision/license.txt     # -rw------- vision vision

Luego haz clic en Settings → License → Re-check now.

tee conserva el archivo en el que el servicio puede escribir. No lo reemplaces con mv ni cp como root: un archivo propiedad de root bloquea la siguiente activación (vision doctor indica la solución: sudo chown vision:vision /etc/vision/license.txt).

Eliminar o reemplazar un dispositivo

Cualquier miembro de la empresa propietaria puede:

eliminar un dispositivo: en el perfil de Cesbo, abre la licencia y usa Manage device;
reemplazar un dispositivo: activa el nuevo host desde su Settings → License y elige el dispositivo anterior en la página de Cesbo. El dispositivo anterior se elimina cuando el nuevo recibe la licencia.

Un dispositivo eliminado muestra License not found or revoked después de su siguiente comprobación y se bloquea. Vision no tiene un botón de eliminar propio. Activar un host que ya tiene una licencia reemplaza su número de serie local; la activación anterior sigue vigente en tu perfil de Cesbo hasta que la elimines allí.

El archivo de licencia

El número de serie se guarda en /etc/vision/license.txt, junto a config.yaml, propietario vision, modo 0600. vision install lo crea vacío ({}) y nunca lo sobrescribe; la unidad del servicio permite que el servicio escriba en ese único archivo mientras el resto de /etc/vision permanece de solo lectura. La activación reescribe l y conserva todas las demás claves:

{
  "l": "<serial>",
  "s": "https://ls.example/"
}

l es el número de serie, 40 caracteres hexadecimales en minúscula. Es un secreto: Vision muestra y registra únicamente sus primeros 14 caracteres, el ID público.
s es opcional: un único servidor de licencias que reemplaza a los de Cesbo (bancos de pruebas, casos de soporte). Una s vacía o que no sea una cadena se ignora.

vision backup incluye el archivo junto con los secretos.

Comprobaciones

Cada comprobación consulta a los servidores de licencias (ls1–ls3.cesbo.com) en orden aleatorio hasta que uno concede la licencia. Un rechazo, o una respuesta que no supera la verificación, cuenta solo cuando ningún servidor la concede.

Tras una concesión, Vision vuelve a comprobar en 24 horas, o en la fecha de caducidad de la licencia si esta es anterior, de modo que una renovación se detecta de inmediato.
Tras un rechazo (caducada, eliminada o reemplazada) o una respuesta que no supera la verificación, comprueba cada hora.
Re-check now comprueba de inmediato (como máximo una vez cada 10 segundos).

Los servidores de licencias rechazan una solicitud cuya hora difiere de la suya en más de 5 minutos. La página License muestra entonces el código 40003. Habilita NTP en el host (timedatectl set-ntp true) y luego haz clic en Re-check now.

Código	Significado
`40000`	Licencia no encontrada, revocada, o este dispositivo fue eliminado o reemplazado: activa de nuevo
`40002`	Licencia caducada: renuévala en tu perfil de Cesbo
`40003`	El reloj del host está desfasado más de 5 minutos: habilita NTP
`40004`	El servidor de licencias no pudo leer la solicitud: se reintenta cada minuto; contacta con el soporte de Cesbo si persiste
`40006`	El servidor de licencias no puede responder en este momento: se reintenta cada minuto
`40100`	No hay archivo de licencia, o no contiene ningún número de serie: activa
`40110`	`s` en `license.txt` no es una URL utilizable: corrígela o elimínala
`40111`	No se puede conectar con los servidores de licencias (red, TLS, proxy, tiempo de espera)
`40112`	La respuesta no provino de un servidor de licencias (un proxy, un portal cautivo o una `s` incorrecta): se reintenta cada minuto
`40120`–`40135`	La respuesta de un servidor de licencias no superó la verificación: se reintenta cada minuto; comprueba el reloj del host y cualquier proxy que reescriba HTTPS
`40140`	La respuesta de un servidor de licencias no superó la verificación de firma: bloqueado; busca un proxy que reescriba HTTPS

Qué ocurre cuando caduca la licencia

Cuando la licencia caduca, o cuando su dispositivo se elimina o se reemplaza, los servidores de licencias rechazan la comprobación (40002 caducada, 40000 eliminada o reemplazada) y Vision se bloquea, como se describe en Qué significa “bloqueado”. Después comprueba cada hora, así que se desbloquea solo cuando la licencia se renueva en tu perfil de Cesbo; Re-check now lo hace al instante. En los últimos 7 días antes de la caducidad, un aviso sobre todas las páginas informa a los usuarios que pueden leer los ajustes.

Operación sin conexión

Vision reintenta cada minuto cuando no se puede llegar a los servidores de licencias.

Dentro de los 30 minutos posteriores a un arranque, sigue funcionando sin ninguna respuesta.
Tras una comprobación exitosa, sigue funcionando hasta 30 días sin recibir ninguna. Durante los últimos 7 días, la página License y un banner sobre cada página muestran hasta cuándo.
La ventana de 30 días vive solo en memoria: reiniciar el servicio empieza de nuevo con la gracia de 30 minutos.

Red

Vision necesita HTTPS saliente (443) hacia:

ls1.cesbo.com, ls2.cesbo.com, ls3.cesbo.com: las comprobaciones (al menos uno);
app.cesbo.com: solo para la activación.

Detrás de un proxy, define HTTPS_PROXY en /etc/vision/vision.env y ejecuta sudo vision restart. El proxy no debe interceptar TLS: una respuesta reescrita no supera la verificación.

Tus datos

Las grabaciones permanecen en tus servidores Alta. Vision guarda su propia base de datos y los datos de la aplicación en su host, en /var/lib/vision/.
El licenciamiento solo necesita HTTPS saliente hacia los hosts indicados en Red.
Durante la activación, la página de Cesbo muestra el nombre de host del dispositivo que se activa.

Comprobación desde la shell

vision status muestra el ID público del archivo de licencia, o not activated. El estado en vivo y la caducidad están en Settings → License.
vision doctor comprueba el archivo (existe, propietario vision, modo 0600, concedido al servicio por la unidad) y si los servidores de licencias y app.cesbo.com responden. Un servidor inalcanzable es una advertencia, no un fallo.
journalctl -u vision y Registros (componente license) registran cada cambio de estado.