Passerelle configurable pour les déclarations de sécurité

Nous avons conçu une plateforme de déclaration qui fait correspondre les données sources des entreprises à des objets standard, puis au format de message de chaque autorité. Un assistant en neuf étapes gère la configuration, les secrets sont montés en lecture seule, et deux anciens services de déclaration codés en dur disparaissent.

EN BREF : Nous avons remplacé deux services de déclaration codés en dur par une passerelle qui transpose les données d’entreprise en objets standard, puis au format de message de chaque autorité, par configuration plutôt que par code, avec signature, envoi, accusés de réception, nouvelles tentatives et audit intégrés.

Vue d’ensemble

Les entreprises industrielles d’un secteur de sécurité réglementé doivent transmettre aux plateformes publiques les permis de travail, le personnel, les positions en temps réel et les données de maîtrise des risques. Chaque plateforme a ses propres règles de champs, de signature, de chiffrement et d’accusé de réception. Les intégrateurs configurent un nouveau raccordement dans un assistant en neuf étapes, et les secrets sont montés en lecture seule sur l’hôte.

Flux de données de la passerelle de déclaration : les sources de données des entreprises sont sondées et transposées en objets standard, puis en messages de la plateforme cible ; les messages sont signés, chiffrés et envoyés en HTTP, TCP ou messagerie ; les accusés de réception reviennent vers les nouvelles tentatives, les redéclarations et le rapprochement ; un assistant en neuf étapes pilote configuration, approbation et mise en production.

Problème

Chaque nouvelle entreprise, chaque nouvelle version d’un système d’entreprise ou d’une plateforme d’autorité imposait jusqu’ici des modifications de code dans les anciens services. Le sens métier était dispersé entre des scripts et des cas particuliers. Les raccordements dépendaient des développeurs et étaient difficiles à auditer.

Contraintes

  • L’ancien code pouvait servir à repérer les cas particuliers métier, pas à dessiner la nouvelle architecture.
  • Les intégrateurs ne doivent modifier ni SQL, ni YAML, ni JSON, ni scripts. Objectif de conception : au moins 95 % des nouveaux raccordements configurés depuis l’interface, le reste via une interface de plugins stable. Cet objectif reste à démontrer sur des échantillons réels.
  • Déploiement dans les locaux du client, y compris sur des sites hors ligne, avec une architecture d’image figée et des identifiants d’image vérifiables.
  • Jamais d’identifiants dans la configuration. Seules des références logiques y sont stockées.

Architecture

ÉlémentMise en œuvre
Back-endJava 21, Spring Boot 4.1, MySQL 8, migrations Flyway V1 à V14
ConsoleInterface de configuration Vue 3 + TypeScript
CorrespondanceDeux étages : des champs sources vers un objet standard, puis de l’objet standard vers le message cible, exprimés sous forme d’arbre d’expressions fermé et non de langage de script
AssistantNeuf étapes : périmètre, source de données, sondage, correspondance standard, message cible, capacités de la plateforme, test, approbation, mise en production
Moteur d’envoiAuthentification, signature et chiffrement ; transports HTTP, TCP et messagerie ; accusés synchrones et asynchrones ; planification, incréments, idempotence, nouvelles tentatives, redéclaration et rapprochement
SecretsMagasin de secrets en fichiers, en lecture seule, monté dans le conteneur

Décisions clés

  1. Langage de correspondance fermé. Un arbre d’expressions borné peut être validé et audité avant mise en production, ce que des scripts libres ne permettent pas ; un relecteur voit exactement ce qu’une correspondance va envoyer.
  2. Des objets standard au milieu. Sources et cibles ne se rencontrent qu’au niveau de l’objet standard ; ajouter un système d’entreprise ou une nouvelle version d’autorité ne touche qu’un côté de la correspondance.
  3. Exploitation sûre par défaut. Les tests de fumée ne vérifient que l’état de santé, et un envoi réel exige un indicateur explicite. Le rollback refuse de rétrograder l’image dès que la base est passée à une migration plus récente, et renvoie l’exploitant vers la sauvegarde d’avant mise à niveau.

Éléments de preuve

  • 78 classes de test back-end. 14 migrations versionnées. Quatre domaines métier dans le premier périmètre : permis de travail, personnel, localisation en temps réel et maîtrise des risques dite de double prévention.
  • Le référentiel d’exigences, le rapport d’audit, le journal de décisions, la checklist de recette par étapes et le manuel de déploiement font partie de la livraison.

Limites

L’objectif de 95 % de configurabilité est un objectif de conception, non validé sur le terrain. Les noms des autorités, les points d’accès et les données d’entreprise ne sont pas publiés.

Questions fréquentes

Quelqu'un qui ne développe pas peut-il ajouter le raccordement d'une nouvelle entreprise ?

C'est l'objectif de conception. Les intégrateurs suivent l'assistant en neuf étapes. Ce qui sort du périmètre du produit passe par une interface de plugins, sans modifier le cœur.

Comment les identifiants sont-ils protégés ?

La configuration ne stocke qu'une référence logique vers l'identifiant. Les vrais secrets sont lus dans un répertoire monté en lecture seule sur l'hôte.

Fonctionne-t-elle hors ligne ?

Les images peuvent être construites sur une machine connectée, exportées, puis chargées et vérifiées par identifiant d'image sur site.