Provisionnement d'hébergement & synchronisation Plesk

Transformez les évènements de contrat en actions d'hébergement

Chaque fois qu'une ligne de service d'un contrat Dolibarr change de statut, ce module agit : l'activation d'une ligne de service crée le compte d'hébergement ou le domaine dans votre panneau ; sa clôture suspend l'accès ; sa suppression supprime le compte. Votre flux de facturation reste dans Dolibarr — le panneau reste synchronisé automatiquement.

Toutes les actions de provisionnement sont en soft-fail : si le panneau est injoignable ou renvoie une erreur, le flux de contrat dans Dolibarr n'est jamais bloqué. Vous obtenez une erreur consignée, pas un processus de facturation figé.

Architecture multi-panneaux

La couche d'adaptateurs utilise un modèle Registry/Factory afin que les intégrations de panneaux soient indépendantes et interchangeables. Adaptateurs pris en charge dans la v1.0.0 :

• Plesk (Obsidian REST v2) — testé en direct sur un système de production
• cPanel / WHM — implémenté ; alignez les URL des points de terminaison sur votre version de cPanel avant la mise en production
• ISPConfig (Remote API) — implémenté ; vérifiez par rapport à votre version d'ISPConfig
• KeyHelp (REST v2) — implémenté ; vérifiez par rapport à votre version de KeyHelp
• CloudPanel (pont clpctl) — implémenté ; vérifiez par rapport à votre version de CloudPanel
• Webhook générique — envoyez une requête HTTP signée vers n'importe quel panneau ou point de terminaison d'automatisation

Les API des panneaux dépendent de la version. L'adaptateur Plesk est vérifié en production. Tous les autres adaptateurs sont proprement implémentés et peuvent nécessiter des ajustements mineurs des points de terminaison pour votre version spécifique de panneau — ils ne sont pas plug-and-play pour chaque version sans test.

Synchronisation de l'inventaire Plesk

Une page d'administration intégrée lit les données en direct de votre serveur Plesk et les replace dans le contexte Dolibarr :

• Liste tous les clients, domaines, plans de service et abonnements Plesk
• Met en correspondance les clients Plesk avec les tiers Dolibarr existants par adresse e-mail
• Importe un client Plesk non apparié comme nouveau tiers Dolibarr en un clic
• Affiche la correspondance domaine-contrat pour voir ce qui est provisionné et ce qui ne l'est pas

Contenu du module

• Champ complémentaire personnalisé domain sur les lignes de service de contrat — créé automatiquement à l'activation du module
• Stockage chiffré des identifiants d'API des panneaux
• Bouton « Tester la connexion » par configuration de panneau — vérifiez les identifiants avant d'activer l'automatisation
• Interrupteur d'automatisation — désactivez le provisionnement globalement sans toucher aux flux de contrat
• Prise en charge du proxy sortant (forward proxy) pour les serveurs Dolibarr sans accès Internet direct
• 100 % auto-hébergé — aucune donnée ne quitte votre serveur, aucune dépendance SaaS externe

Prérequis

• Dolibarr 18 – 23 (testé en direct sur 23.0.3)
• PHP 7.4 – 8.3
• Module Contrats activé dans Dolibarr
• Accès réseau depuis le serveur Dolibarr vers l'API du panneau cible (ou un proxy sortant configuré)

Licence : GNU GPL v3