El agente de impresión

Aplica a: BarcoderX Basic y Ultimate

Estado: Planificado. Todavía no hay nada publicado y no hay nada que descargar. Esta página describe cómo se diseñó el agente.

Para qué sirve el agente

El agente de impresión es un programa pequeño que usted instala en un equipo de la misma red que sus impresoras. Es el vínculo entre la web y esas impresoras. Hace falta cuando un trabajo de impresión nace en la API web o en el editor de etiquetas. No hace falta cuando su propia aplicación .NET imprime directamente con el SDK.

El agente recibe los bytes que se van a imprimir y los envía a la impresora. No sabe nada de lenguajes de impresora, por lo que un lenguaje de impresora nuevo no requiere actualizar el agente. El estado de la impresora se lee de la misma manera: el agente transmite la pregunta y la respuesta, y el servidor las interpreta.

Dónde se ejecuta

• Windows: como un servicio de Windows. Windows 10, Windows 11 y Windows Server 2019 o posterior.
• Linux: como un demonio de systemd, en x64 y arm64.
• macOS: previsto para más adelante.

Es un solo programa para todos, publicado como un único archivo autónomo. No tiene ventana. Usted lo configura y lo administra mediante la API de su servidor.

Cómo se instala

• Windows: usted ejecuta una vez el programa firmado y este se instala solo como un servicio.
• Linux: usted descomprime un archivo firmado y ejecuta su script de instalación, que configura la unidad de systemd.

BarcoderX no crea de forma predeterminada paquetes MSI, deb ni rpm.

Para conectar el agente con su servidor, un administrador crea mediante la API del servidor un código de emparejamiento de un solo uso. El código funciona una sola vez y vence a los 10 minutos. Usted lo ingresa en el agente. El agente crea entonces su propio par de claves en ese equipo y registra la mitad pública. La clave privada se queda en el equipo: está protegida por la función de protección de datos de Windows, o se guarda en un archivo que en Linux solo puede leer la cuenta de administrador.

El agente también puede listar las colas de impresión y los puertos de su equipo, para que usted los registre como impresoras.

Cómo se conecta

• El agente solo se conecta hacia afuera. Usa HTTPS y un WebSocket hacia BarcoderX. No abre ningún puerto, por lo que no hace falta ninguna regla de firewall para el tráfico entrante.
• Funciona a través de proxies. Sigue el proxy del sistema y cualquier proxy que usted configure.
• Se reconecta solo después de una caída de red, con pausas cada vez más largas, y luego continúa los trabajos que estaban esperando.

Cómo protege sus impresoras

• El agente demuestra quién es con una aserción firmada de corta duración. Luego recibe un token de acceso que dura 15 minutos y sirve solo para ese agente.
• Un agente solo puede recoger los trabajos dirigidos a sus propias impresoras.
• El servidor firma cada trabajo. El agente verifica la firma antes de imprimir y rechaza un trabajo que fue modificado o que venció.
• El agente imprime solo en las impresoras de su propia lista. La web no puede agregar una impresora de red a esa lista, a menos que lo permita una política local de ese equipo, y entonces solo para direcciones privadas y los puertos de impresión habituales.
• Un trabajo que llega dos veces, por ejemplo después de una reconexión, se imprime una sola vez. Para eso, y para recuperarse tras una falla, el agente guarda localmente una lista breve de números de trabajo. No conserva datos de etiquetas después de que termina el trabajo.
• Un administrador puede revocar un agente en cualquier momento. La conexión se cierra de inmediato y sus tokens dejan de funcionar.
• El registro de auditoría guarda el alta, la conexión, la desconexión y la revocación.
• Los registros del agente nunca contienen el contenido de una etiqueta.

Actualizaciones

El agente se actualiza solo a partir de paquetes firmados. Verifica la firma con una clave que ya tiene, y si la nueva versión no logra iniciar, vuelve a la anterior.

Cómo revisar un problema

El agente tiene un comando de diagnóstico. Informa si puede conectarse, qué proxy usa, cuánto difiere su reloj del del servidor, si está registrado y si puede llegar a cada impresora. El informe sale en inglés o en español.

Lo que el agente no hace

• No verifica ninguna licencia. La marca de evaluación, cuando corresponde, ya está en los datos que envía el servidor, y ninguna condición de licencia puede impedir que el agente imprima.
• No tiene interfaz de usuario.
• No acepta conexiones entrantes.

BarcoderX es un producto de P4 Software.