Dolibarr + Sendinblue : contrôle interne avec une approche sécurité

Un guide pratique pour les PME/ETI qui souhaitent optimiser leurs processus tout en protégeant leurs données sensibles.

1. Pourquoi coupler Dolibarr et Sendinblue ?

Dolibarr Sendinblue
ERP / CRM open‑source léger, idéal pour la gestion des devis, factures, stocks, contacts, etc. Plateforme d’e‑mailing et d’automatisation marketing très puissante (envoi de newsletters, campagnes transactionnelles, suivi des campagnes).
Architecture modulaire → extensions spécifiques (ex. Facturation, Gestion des contacts, Gestion des campagnes) API riche + UI intuitive pour créer des workflows d’envoi conditionnels.
Accès direct aux données clients/commerciales → possibilité d’être utilisé comme source d’évènements (ex. « facture payée → envoyer un mail de suivi »). Fonctionnalités avancées de segmentation, d’A/B testing et de reporting de performances.

Le point fort : l’intégration de ces deux outils permet d’automatiser les communications transactionnelles (confirmations de paiement, relances, factures en attente) tout en gardant une visibilité complète sur le processus interne. Cela crée un contrôle interne robuste – traçabilité, vérification et conformité –, mais uniquement si l’on aborde la sécurité dès le départ.

2. Modèle de Sécurité « Privacy‑by‑Design » pour l’Intégration

Étape Action Outils/Paramètres
2.1. Gouvernance des accès Définir des rôles (ex. Read‑only Customer Service, Invoice Editor, Marketing Campaign Manager) et les assigner dans Dolibarr via le module “Gestion des utilisateurs”. À chaque rôle, définir un droit minimal (principe du moindre privilège).
2.2. Authentification forte Activer l’authentification à deux facteurs (2FA) pour tous les comptes administratifs. Utiliser un SSO (ex. Azure AD, Auth0) si possible. Plugins 2FA pour Dolibarr + API de Sendinblue sécurisée par token (OAuth 2.0).
2.3. Chiffrement des données en transit Utiliser HTTPS avec certificats valides (Let’s Encrypt) pour tous les endpoints (Dolibarr et Sendinblue). Vérifier que les URL d’API des deux solutions commencent par https://.
2.4. Chiffrement des données au repos Activer le chiffrement des volumes où sont stockées les factures et contacts (ex. MySQL InnoDB, volumes Docker). Docker‑compose volumes: avec encrypted:true (ou LUKS sur serveur).
2.5. Masquage / pseudonymisation Pour les tests ou le reporting marketing, ne transmettre qu’un identifiant anonyme du contact (ex. hash du customer_id). Fonction PHP hash('sha256', $id) ou filtre Sendinblue avant l’envoi.
2.6. Logs d’audit Centraliser les logs d’accès (Dolibarr → Syslog, Sendinblue → Audit Trail). Conserver 12 mois. rsyslog, ELK stack, ou plateforme SIEM interne.
2.7. Suivi de conformité Mettre en place un plan de conformité RGPD : registre des traitements, demande d’accès, droit à l’oubli, etc. Tableau de bord Dolibarr “RGPD” (module dédié) + checklist Sendinblue (entreprise conforme au RGPD).

3. Architecture Technique Typique

+---------------------+          +-----------------------+

|   Dolibarr Server   |  HTTP    |  Sendinblue API/APIS  |

|  (PHP + MySQL)      +--------->+  (REST, OAuth2)       |

+---------------------+          +-----------------------+

          ^   |                                 |

          |   | 8) Envoi de factures/Confirmation   |

          |   | 7) Retour de statut (delivered, etc.)|

          |   +-----------------------------------+

          |

          |  (Webhooks)   (ex: on_facture_payee)

          |

+---------------------+          +-----------------------+

|   Monitoring /      |  TCP/443 |  Service de logs       |

|  SIEM               +--------->+  (ELK, Graylog)        |

+---------------------+          +-----------------------+

  • Flux d’exemple : « Facture payée → email de bienvenue »

    1. Le paiement est enregistré dans Dolibarr → déclenche un webhook (ou cron job) qui appelle l’API v3/contacts de Sendinblue pour récupérer le contact (ou créer s’il n’existe pas).

    2. Un appel à v3/send crée un mail transactionnel (template HTML).

    3. Sendinblue renvoie un statut (delivered, opened, bounced) que Dolibarr stocke dans une table email_log pour l’audit.

    4. Tous les échanges sont journalisés et signés (ex. SHA‑256 du payload + timestamp).

4. Bonnes Pratiques de Contrôle Interne

Domaine Contrôle Fréquence Exemple de procédure
Gestion des changements Revue de chaque modification du code (plugins, scripts API). À chaque release Ticket JIRA avec approbation du Security Officer.
Séparation des environnements Production ↔️ Tests ↔️ Recette. Continu Environnements isolés avec bases de données distinctes et comptes API différents.
Gestion des secrets Variables d’environnement (SENDINBLUE_API_KEY) non stockées en clair dans le repo. Continu Utiliser Vault ou Docker secrets.
Backup & Disaster Recovery Sauvegarde chiffrée des bases (MySQL dump + Sendinblue export) 24 h/24. Quotidien Test de restauration tous les mois.
Monitoring des its Alertes sur >5 % de rebonds ou taux de spam >2 %. En temps réel Rule dans Grafana → déclenche email à l’équipe marketing.
Vérification des droits Audit trimestriel des listes de diffusion (qui a accès à quelles listes?). Trimestriel Export de la matrice des droits depuis Dolibarr + tableau de suivi.
Tests d’intrusion Scan de vulnérabilités (OWASP ZAP) sur l’API d’échange. Annuel ou après changement majeur. Rapport CVSS partagé avec le DSI.
Formation du personnel Session de sensibilisation au phishing et à la manipulation des données clients. 2× par an Simulations de mail fraud, quiz de conformité.

5. Exemple de Processus de Validation « Facturation → Mail »

  1. Création de la facture

    • Invoice_ID généré, statut = en attente.

    • Le champ customer_email est renseigné.

  2. Vérification

    • Contrôle de cohérence : le champ customer_email doit correspondre à un contact existant dans la base contacts de Dolibarr et contenir le domaine de l’entreprise cliente.

    • Si l’utilisateur modifie manuellement le mail, il doit passer par le workflow d’approbation (2 clics de validation).

  3. Déclenchement

    • Le cron @hourly lance dolibarr_sendinblue_sync.php.

    • Le script récupère les factures payées avec le champ email_sent = 0.

  4. Envoi

    • Via l’API v3/send on crée un email avec le template Facture‑Payée contenant : 
      <p>Dear {$customer_name},</p>
      
<p>Votre facture <strong>#{$invoice_number}</strong> a bien été payée.</p>
      
<p>Vous pouvez la télécharger ici : <a href="{$invoice_url}">Facture</a></p>
      
<p>Bonne journée !</p>

    • Le script stocke le email_id retourné par Sendinblue dans la table email_log.

  5. Suivi & Reporting

    • Les statuts (delivered, opened, bounced) sont récupérés quotidiennement via webhook.

    • Un tableau de bord BI (Power BI / Metabase) agrège le taux d’ouverture et les rebonds, générant une alerte si le taux dépasse 5 %.

  6. Audit

    • Un journal d’audit email_audit.log est écrit avec :

      • Timestamp, invoice_id, customer_id, api_response, signature.

    • Le log est signé (ex. HMAC-SHA256(secret_key, payload)).

    • Le fichier est archivé et intégré au SIEM pour les contrôles d’accès.

6. Checklist de Sécurité « Avant Mise en Production »

✅ Action
1 [ ] Toutes les API keys sont stockées dans un store sécurisé (ex. HashiCorp Vault) et accessibles uniquement via un service account à privilèges limités.
2 [ ] Les certificats SSL/TLS sont à jour et configurés en TLS 1.3.
3 [ ] Les logs d’accès sont immutables (ex. append‑only via syslog-ng avec file mode appendonly).
4 [ ] Le plan de reprise (DR) a été testé – restauration d’un backup complet en moins de 30 min.
5 [ ] Les comptes de test n’utilisent pas de données de production (anonymisation des contacts).
6 [ ] Un test de pénétration interne a révélé aucune vulnérabilité critique (CVSS ≥ 7).
7 [ ] Une revue de conformité RGPD est signée par le DPO (Data Protection Officer).
8 [ ] La communication interne (Slack/Teams) contenant le token API est désactivée (policy “No secrets in chat”).
9 [ ] Les alertes de dépassement de quota ou de taux de bounce sont routées vers l’équipe Security Ops.
10 [ ] Un audit de configuration (CIS Benchmark) est appliqué à l’infrastructure (OS, Docker, Nginx).

7. Outils de Suivi & Reporting

Outil Fonction Pourquoi c’est utile
Grafana Dashboard temps réel des appels API Sendinblue (latence, erreurs 4xx/5xx). Détecte rapidement une dégradation du service.
ELK Stack Centralisation & recherche de logs (Dolibarr, Sendinblue, Docker). Permet des requêtes de type “Affiche tous les envois dont le statut est bounced”.
Fail2Ban Bloque IPs après plusieurs tentatives d’accès non autorisées. Renforce la couche réseau contre les brute‑force.
OpenVAS / Nessus Scans de vulnérabilités périodiques. Garantit que les dernières CVE ne touchent pas le serveur.
Metabase / Power BI Reporting métier (taux de factures envoyées, revenu récurrent). Décision basée sur des données fiables et sécurisées.
Docker Compose / Swarm Gestion orchestrale des conteneurs. Permet de déployer séparément chaque service avec limites de ressources.

8. Exemple de Script de Synchronisation (PHP)

<?php

// ---------------------------------------------------

// sync_dolibarr_sendinblue.php

// ---------------------------------------------------

require __DIR__.'/vendor/autoload.php';
use Dolibarr\DolibarrSystem;
// Chargement du framework Dolibarr

 dolibarr_init('prod');
// ---------------------------------------------------

// 1️⃣  Récupération des factures payées non mailées

// ---------------------------------------------------

$pdo = new PDO(

    $conf->dbhost, $conf->dbname, $conf->dbuser,

    $conf->dbpass, [PDO::ATTR_ERRMODE=>PDO::ERRMODE_EXCEPTION]

);
$stmt = $pdo->prepare("

    SELECT i.rowid as invoice_id,

           i.failed_payment as paid,

           c.email as customer_email,

           c.label as customer_name

    FROM llx_facture f

    JOIN llx_categorie c ON f.fk_categorie = c.id_categorie

    WHERE f.fk_status = 3               -- statut "payée"

      AND f.email_sent = 0

");
$stmt->execute();

$results = $stmt->fetchAll(PDO::FETCH_ASSOC);
foreach ($results as $row) {

    // -------------------------------------------------

    // 2️⃣  Appel API Sendinblue pour créer le mail

    // -------------------------------------------------

    $apiKey = getenv('SENDINBLUE_API_KEY');

    $url    = 'https://api.sendinblue.com/v3/sendTransactional';
$templateId = 1; // ID du template Transactional préparé dans Sendinblue

    $subject    = "Votre facture n°{$row['invoice_id']} a été payée";
$payload = [

        "templateId" => $templateId,

        "to"         => [$row['customer_email']],

        "params"     => [

            "firstName" => trim($row['customer_name']),

            "invoiceUrl"=> "https://yourdomain.com/facture/{$row['invoice_id']}"

        ],

        "subject"    => $subject,

        "replyTo"    => ["address"=>"no-reply@yourdomain.com","name"=>"Service Comptabilité"]

    ];
$ch = curl_init($url);

    curl_setopt_array($ch, [

        CURLOPT_POST           => true,

        CURLOPT_HTTPHEADER     => [

            'Content-Type: application/json',

            'Authorization: Bearer '.$apiKey

        ],

        CURLOPT_RETURNTRANSFER => true,

        CURLOPT_POSTFIELDS     => json_encode($payload)

    ]);
$response = curl_exec($ch);

    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);

    $err      = curl_error($ch);

    curl_close($ch);
// -------------------------------------------------

    // 3️⃣  Persistance du résultat

    // -------------------------------------------------

    if ($httpCode===200) {

        $resp = json_decode($response, true);

        $emailId = $resp['id'];

        // Mise à jour de la table email_log

        $upd = $pdo->prepare("UPDATE llx_email_log SET email_id = ?, status = 'sent' WHERE invoice_id = ?");

        $upd->execute([$emailId, $row['invoice_id']]);

    } else {

        // Log d’erreur + alerte

        error_log("[".date('c')."] Sendinblue error ({$httpCode}) : $err");

        // Optionnel : envoyer une alerte Slack / Teams

    }

}

?>

Le script respecte les principes de sécurité :

  • Les secrets (SENDINBLUE_API_KEY) sont hors du code.

  • Utilisation de cURL avec vérification TLS par défaut.

  • Gestion des erreurs via journalisation chiffrée.

  • Idempotence : le même invoice_id n’est jamais ré‑envoyé (champ email_sent).

9. Points d’Intérêt pour le Contrôle Interne

Aspect Bénéfice Exemple concret
Traçabilité Toute action d’envoi est enregistrée avec client, ID facture, datetime, réponse API. En cas d’audit, on peut reconstituer le flux complet via les logs email_audit.log.
Séparation des fonctions La saisie/comptabilité (Dolibarr) est distincte de l’envoi marketing (Sendinblue). Le développeur qui modifie la facturation n’a pas de droits d’accès à l’API Sendinblue.
Limitation des privilèges Les comptes utilisateurs sont assignés à des rôles CRUD limités. Un comptable ne peut pas modifier les templates d’e‑mail.
Gestion des incidents Les webhook + alertes permettent de réagir immédiatement aux rebonds ou aux tentatives de spam. Si >10 % des envois rebondissent, le workflow suspend les envois et alerte le responsable sécurité.
Conformité Le registre des traitements inclut la catégorie “envoi de factures transactionnelles”. Le DPO signale que ces envois participent au traitement de données au titre de la comptabilité.

10. Scénario de Gestion d’Incident (ex. fuite d’e‑mail)

  1. Détection : Alertes du SIEM sur un pic de bounce rate (> 8 %).

  2. Isolation : Le script de synchronisation est désactivé (systemctl stop dolibarr_sendinblue).

  3. Analyse : Recherche dans les logs email_audit.log pour identifier les factures concernées.

  4. Notification : Envoi d’un ticket d’incident à l’équipe sécurité + au DPO.

  5. Remédiation :

    • Réinitialisation du token d’API (rotation de clé).

    • Vérification de la whitelist des adresses (liste noire temporaire).

    • Communication externe (si les adresses clients sont exposées).

  6. Leçon apprise : Mise à jour du plan de reprise et du document de sécurité (ex. ajout d’une règle de validation d’adresse).

11. Conclusion : Vers une Sécurité Opérationnelle Intégrée

  • Dolibarr fournit le socle de gestion des processus métiers, Sendinblue se charge de la communication.

  • En les combinant, on obtient un contrôle interne riche : visibilité, audits, séparation des fonctions, journalisation.

  • Mais tout cela ne vaut rien si la sécurité n’est pas pensée dès le départ : authentification forte, chiffrement, gestion des secrets, audit continu.

  • En suivant le modèle “Privacy‑by‑Design” presented above, vous créez un système où chaque changement, chaque spécification et chaque opération sont vérifiables, traçables et conformes aux exigences légales (RGPD, ISO 27001, etc.).

Message clé : L’efficacité du contrôle interne ne se mesure pas seulement au nombre de check‑lists cochées, mais à la capacité de garantir que chaque donnée circulant entre Dolibarr et Sendinblue reste protégée, intègres‑e et auditable en toute circonstance.

📚 Ressources complémentaires

Ressource Description
Documentation officielle Dolibarr https://www.dolibarr.org/documentation/ – Modules “Factures”, “Contacts”.
API Sendinblue v3 https://developers.sendinblue.com/docs – Exemples d’appels transactional + webhooks.
Guide RGPD sur Sendinblue PDF publié par Sendinblue (2024) – “Data Protection & Email Marketing”.
Open Web Application Security Project (OWASP) – E‑mail Security https://owasp.org/www-project-top-ten/ – Bonnes pratiques anti‑phishing.
CIS Benchmarks – Docker & Nginx https://www.cisecurity.org/benchmarks/ – Configurations sécurisées à appliquer.
HashiCorp Vault – Securing Secrets https://www.vaultproject.io/docs/secrets – Gestion centralisée des clés API.

Prêt à mettre en place cette intégration avec la certitude que la sécurité est au cœur du processus ?
Bonne implémentation ! 🚀

Publications similaires