Documentation — Connecteurs

Intégrations de données entrantes : types de connecteurs, modèle de données, gestion des secrets et planification des synchronisations.

Types de connecteurs

  • API REST — interrogation HTTP(S) paginée d'une API métier (ERP, CRM). Authentification par jeton ou compte de service ; idéal pour des synchros fréquentes (horaires) et incrémentales.
  • SFTP — récupération de fichiers déposés par un tiers (relevés bancaires, exports paie). Le connecteur liste un répertoire, importe les nouveaux fichiers et les archive ; rythme typiquement quotidien.
  • PostgreSQL — lecture directe d'une base (datawarehouse, réplique analytique) via un compte en lecture seule, avec curseur incrémental sur une colonne de mise à jour.
  • MySQL — même principe que PostgreSQL pour les applications historiques adossées à MySQL/MariaDB.

Modèle de données

Un connecteur associe une source (type + hôte/URL + identifiant) à une planification et à un état de santé observable : statut, dernière synchronisation, volumétrie importée sur 24 h. Le secret n'est jamais stocké dans cet enregistrement — seul un pointeur vers le coffre y figure.

{
  "nom": "ERP Sage — API REST",
  "type": "API REST",                    // API REST | SFTP | PostgreSQL | MySQL
  "hote": "https://api.sage.acme.fr/v3",
  "identifiant": "svc-bpm-sage",         // compte de service (lecture seule)
  "secretRef": "vault://connecteurs/sage-api-token",
  "statut": "connected",                 // connected | error | paused
  "planification": "0 * * * *",          // cron — toutes les heures
  "derniereSynchro": "2026-06-12T09:00:00Z",
  "lignes24h": 12400
}

Gestion des secrets

  • Les jetons, mots de passe et clés SSH sont stockés dans un coffre (Vault, AWS Secrets Manager…) et référencés par secretRef ; jamais en base ni dans les journaux.
  • Utilisez des comptes de service dédiés en lecture seule, un par connecteur, pour pouvoir révoquer sans effet de bord.
  • Une authentification refusée passe le connecteur en statut error : la correction de l'identifiant suivie d'un test de connexion (flux « Corriger » puis « Tester » du simulateur) rétablit le statut connected.

Planification des synchros

Chaque connecteur porte une expression cron exécutée par un worker : toutes les heures pour un ERP, quotidien à 06:00 pour des relevés bancaires, toutes les 6 h pour un datawarehouse. Une synchronisation manuelle (« Synchroniser ») reste possible à tout moment sans modifier la planification. Chaque exécution — réussie ou non — est journalisée avec sa volumétrie : c'est l'équivalent du panneau « Journal de synchronisation » du simulateur. Un connecteur paused conserve sa planification mais n'est plus déclenché.

Ouvrir le simulateur