Privacidad de datos y telemetría

Los documentos se procesan localmente y nunca se transmiten a ABBYY ni a terceros. En esta página se describe qué información sí sale del contenedor, qué contiene exactamente cada campo y cómo puede inspeccionar o copiar el flujo usted mismo.

​

Qué envía FineParser a ABBYY

• Validación de la License. Cuando se procesa un documento, FineParser comprueba el saldo de páginas restante de su cuenta y descuenta el número de páginas analizadas. Este es el registro de facturación. Si el cargo no se liquida, el resultado no se entrega.
• Telemetría. FineParser emite un span de traza y un conjunto de mediciones de métricas por cada trabajo, de modo que ABBYY pueda atribuir el uso a su cuenta y entender cómo se utiliza el producto. La telemetría es una señal de uso, no un mecanismo de facturación, y siempre está activa en las compilaciones de release.

Si el receptor de telemetría no está accesible, la configuración es incorrecta o no hay conexión de red, FineParser registra una única línea y continúa con la telemetría desactivada para ese proceso.

​

Qué contiene la telemetría

FineParser utiliza OpenTelemetry y emite dos tipos de señales: métricas, que son recuentos agregados e histogramas, y trazas, que incluyen un span por trabajo. Ambas usan el mismo conjunto reducido de atributos.

​

Atributos en cada señal

Estos valores se fijan al iniciarse el contenedor y se adjuntan a todo lo que este emite.

​

Atributos por trabajo

Cada atributo por trabajo procede de un conjunto cerrado de valores permitidos. Todo valor ajeno a ese conjunto se descarta en lugar de emitirse, de modo que un error en el código que realiza la llamada no puede introducir una cadena arbitraria en una señal. Un outcome con valor rejected significa que la request se rechazó antes de efectuar ningún trabajo, por ejemplo porque no se adjuntó ningún archivo, el formato de salida no era compatible o la carga estaba mal formada. Se mantiene separado de error para que un client que use la API de forma incorrecta no se contabilice como un fallo de FineParser. Una decision con valor unknown significa que el Licensing Server devolvió un status que el contenedor no reconoce. En ese caso, FineParser deniega el trabajo, ya que la denegación predeterminada es la postura del producto, y la decisión se informa en lugar de descartarse.

​

Métricas

La clave de licencia se adjunta tanto a cada registro de métrica como a los atributos del contenedor, de modo que el uso puede agruparse por licencia con independencia de cómo asigne los atributos de recurso un backend posterior.

​

Trazas

El status del span del trabajo se establece en error únicamente cuando el resultado es error.

​

Qué no recopila nunca FineParser

FineParser no recopila el contenido de los documentos, el texto reconocido, nombres de archivo, rutas de archivo, tamaños de archivo, nombres de clientes, direcciones de correo electrónico, identificadores de cuenta, identidades de usuario ni direcciones IP. Un nombre de archivo solo puede llegar al módulo de telemetría a través de una única función, que lee la extensión, devuelve la categoría doc_type y descarta todo lo demás. Una prueba de entradas hostiles incluida en el conjunto de pruebas de FineParser envía nombres de personas, cadenas con formato de SSN (Social Security Number), direcciones de correo electrónico y rutas temporales a través del módulo y verifica que nada de ello llegue a un destino de datos. La clave de licencia es el único valor vinculado a la cuenta que se envía de forma deliberada. El atributo languages es un ajuste de implementación, no un dato del cliente: se fija al iniciar y es idéntico para todos los trabajos que procesa el contenedor. El módulo solo puede emitir las once claves de atributo enumeradas en esta página. Ninguna función exportada acepta un mapa de atributos arbitrario, por lo que añadir un campo exige modificar el código de la lista de permitidos.

​

Inspección y copia del flujo

No tiene que creer sin más lo que dice esta página. Dos variables de entorno le permiten ver el flujo y otras tres, enviar una copia adonde desee. Puede añadir un destino, pero nunca eliminar uno. Su endpoint y el de ABBYY reciben exactamente el mismo flujo, y esto lo garantiza la propia estructura del código, no una política: no existe ningún atributo exclusivo de ABBYY ni una segunda ruta de código en ninguna parte del módulo de telemetría. Lo que usted ve en stdout o en su propio recopilador es exactamente lo que ve ABBYY. FineParser no expone un endpoint de scrape de Prometheus ni emite la señal de logs de OpenTelemetry. En su lugar, los eventos por trabajo se transmiten como atributos de span.

​

Páginas no facturadas

El contador fineparser.pages.unbilled registra las páginas que se le entregaron sin un cargo liquidado. Esto solo ocurre cuando el Licensing Server devuelve un error 5xx o un 404 una vez finalizado el trabajo; en ese caso, FineParser entrega el resultado ya procesado en lugar de retenerlo. En cambio, un tiempo de espera agotado o un fallo de certificado sí bloquean el resultado, por lo que este contador no puede reflejar que alguien esté eludiendo el pago. Un valor superior a cero significa que el proveedor de licencias tuvo un mal día, no que lo haya tenido usted.

​

Limitaciones conocidas

Si un contenedor se detiene en el minuto siguiente al procesamiento de un trabajo, se pierde la telemetría de ese trabajo, ya que el apagado del exportador no espera la respuesta HTTP final. Los contenedores de ejecución prolongada envían toda la información. La medición de la License no se ve afectada y sigue siendo el registro de facturación, por lo que el único efecto de una detención rápida es un ligero subconteo en los paneles de uso de ABBYY.

​

Requisitos de red

El contenedor debe poder acceder a la infraestructura de licencias de ABBYY en todo momento. Permita el tráfico de salida hacia estos dos rangos a través de su firewall o proxy de salida: Por esta conexión solo circulan la Validación de la License y la telemetría, nunca el contenido de los documentos.