Confidentialité des données et télémétrie

Les documents sont traités localement et ne sont jamais transmis à ABBYY ni à quiconque. Cette page décrit les informations qui sortent effectivement du conteneur, le contenu exact de chaque champ, ainsi que la manière dont vous pouvez inspecter ou copier vous-même ce flux.

​

Ce que FineParser envoie à ABBYY

• Validation de la licence. Lorsqu’un document est traité, FineParser vérifie le solde de pages restant sur votre compte et débite le nombre de pages analysées. Il s’agit de l’enregistrement de facturation. Si le débit n’aboutit pas, le résultat n’est pas restitué.
• Télémétrie. FineParser émet un span de trace et un ensemble de relevés de métriques pour chaque job, afin qu’ABBYY puisse rattacher l’utilisation à votre compte et comprendre comment le produit est utilisé. La télémétrie est un signal d’utilisation, et non un mécanisme de facturation ; elle est toujours active dans les builds de release.

Si le collecteur de télémétrie est injoignable, que la configuration est incorrecte ou qu’aucun réseau n’est disponible, FineParser inscrit une seule ligne dans les logs et poursuit son exécution avec la télémétrie désactivée pour ce process.

​

Contenu de la télémétrie

FineParser s’appuie sur OpenTelemetry et émet deux types de signaux : les métriques, qui sont des comptages agrégés et des histograms, et les traces, qui contiennent un span par job. Les deux reposent sur le même petit ensemble d’attributs.

​

Attributs présents sur chaque signal

Ces valeurs sont définies au démarrage du conteneur et associées à tout ce qu’il émet.

​

Attributs par job

Chaque attribut par job provient d’un ensemble fermé de valeurs autorisées. Toute valeur n’appartenant pas à cet ensemble est écartée plutôt qu’émise : un bogue dans le code appelant ne peut donc pas placer une chaîne arbitraire sur un signal. Un outcome égal à rejected signifie que la requête a été refusée avant tout traitement, par exemple parce qu’aucun fichier n’était joint, que le format de sortie n’était pas pris en charge ou que le téléversement était mal formé. Cette valeur est distinguée de error afin qu’un client faisant un mauvais usage de l’API n’apparaisse pas comme une défaillance de FineParser. Une decision égale à unknown signifie que le Licensing Server a renvoyé un statut que le conteneur ne reconnaît pas. FineParser refuse alors le job, car le refus par défaut est la posture du produit, et la décision est signalée plutôt qu’écartée.

​

Métriques

La clé de licence est jointe à chaque relevé de métrique ainsi qu’aux attributs au niveau du conteneur : l’utilisation peut donc être regroupée par licence, quelle que soit la manière dont un backend en aval met en correspondance les attributs de ressource.

​

Traces

Le status du span job n’est défini sur error que lorsque le résultat est error.

​

Ce que FineParser ne collecte jamais

FineParser ne collecte ni le contenu des documents, ni le texte reconnu, ni les noms de fichiers, ni les chemins de fichiers, ni les tailles de fichiers, ni les noms de clients, ni les adresses e-mail, ni les identifiants de compte, ni les identités des utilisateurs, ni les adresses IP. Un nom de fichier ne peut parvenir au module de télémétrie que par une seule fonction, qui lit l’extension, renvoie le groupe doc_type et rejette tout le reste. Un test à entrées hostiles de la suite de tests de FineParser transmet au module des noms de personnes, des chaînes au format SSN, des adresses e-mail et des chemins temporaires, puis vérifie qu’aucune de ces données n’atteint un point de collecte. La clé de licence est la seule valeur délibérément liée à un compte. L’attribut languages est un paramètre de déploiement et non une donnée client : il est fixé au démarrage et reste identique pour tous les jobs traités par le conteneur. Le module ne peut émettre que les onze clés d’attributs répertoriées sur cette page. Aucune fonction exportée n’accepte une table d’attributs arbitraire ; l’ajout d’un champ nécessite donc une modification du code de la liste d’autorisation.

​

Inspection et copie du flux

Vous n’êtes pas obligé de croire cette page sur parole. Deux variables d’environnement vous permettent de visualiser le flux, et trois autres d’en envoyer une copie où bon vous semble. Vous pouvez ajouter une destination, mais jamais en supprimer une. Votre point de terminaison et celui d’ABBYY reçoivent un flux identique, ce que garantit la structure même du code et non une simple politique : il n’existe aucun attribut réservé à ABBYY ni aucun second chemin d’exécution dans le module de télémétrie. Ce que vous voyez sur la sortie standard ou dans votre propre collecteur est exactement ce que voit ABBYY. FineParser n’expose pas de point de terminaison de scrape Prometheus et n’émet pas le signal logs d’OpenTelemetry. Les événements par job sont véhiculés sous forme d’attributs de span.

​

Pages non facturées

Le compteur fineparser.pages.unbilled recense les pages qui vous ont été livrées sans facturation réglée. Cela ne se produit que lorsque le Licensing Server renvoie une erreur 5xx ou une 404 après l’exécution du traitement : FineParser délivre alors votre résultat finalisé au lieu de le retenir. En revanche, une expiration de délai ou un échec de certificat bloque le résultat, de sorte que ce compteur ne peut en aucun cas refléter un contournement du paiement. Une valeur supérieure à zéro signifie que le fournisseur de licence a connu une mauvaise journée, pas que vous y êtes pour quelque chose.

​

Limitations connues

Un conteneur arrêté dans la minute qui suit le traitement d’un job perd la télémétrie de ce job, car l’arrêt de l’exporter n’attend pas la réponse HTTP finale. Les conteneurs de longue durée transmettent l’intégralité des données. Le comptage des licences n’est pas affecté et reste la référence pour la facturation : un arrêt rapide ne provoque donc qu’un léger sous-comptage dans les tableaux de bord d’utilisation d’ABBYY.

​

Exigences réseau

Le conteneur doit pouvoir accéder en permanence à l’infrastructure de licence d’ABBYY. Autorisez le trafic sortant vers ces deux plages dans votre pare-feu ou votre proxy de sortie : Seules la validation de licence et la télémétrie transitent par cette connexion, jamais le contenu des documents.