Le principe
La rubrique Intégrations & connecteurs ouvre la plateforme sur l'extérieur : exposer des données, s'authentifier via un fournisseur externe, et synchroniser avec les outils métier de la formation.
Webservices et API
- Accès aux webservices — Point d'entrée programmatique à la plateforme.
- Configuration de l'accès — Adresses autorisées et paramètres d'accès aux webservices.
- Documentation API (Swagger) — Référence interactive des points d'API disponibles.
S'authentifier auprès des webservices
- Clé d'API — Le webservice SOAP et l'API REST acceptent une clé d'API transmise dans l'en-tête
x-api-key. Elle est définie par votre hébergeur dans la configuration du serveur. C'est la méthode recommandée : une clé valide suffit, sans avoir à autoriser l'adresse de l'appelant. - Identifiant et mot de passe des webservices — Ceux de la *Configuration de l'accès* fonctionnent sur le webservice SOAP et sur l'API REST (authentification HTTP Basic), à condition que les deux soient renseignés.
- Chaque refus est journalisé avec son motif (sans jamais enregistrer la clé ni le mot de passe) : en cas d'échec d'un intégrateur, le journal indique pourquoi.
Authentification et OAuth2
- OAuth2 — Autoriser des applications tierces à se connecter de façon sécurisée.
- Pour la connexion des utilisateurs (SSO Keycloak, SAML, CAS, LDAP), voir *Authentification & SSO*.
Connecteurs TMS
DGTLMS se synchronise avec des logiciels de gestion de la formation externes :
- Yparéo, Cegid, Training Orchestra, Gestibase, Alcuin.
- Piloter — Un tableau de bord des connecteurs, des logs de synchronisation et des mappings (correspondance des champs) permettent de suivre et régler les échanges.
- Migrer depuis Cegid LMS — Une page dédiée reprend une plateforme Cegid LMS (utilisateurs, groupes, formations et leurs fichiers, sessions, résultats) : voir la fiche *Migrer une plateforme Cegid LMS vers DGTLMS*.
Événements
- Configuration des événements — Déclencheurs et notifications liés aux actions de la plateforme.
Étapes typiques
Ouvrir
Administration → Intégrations & connecteurs.Choisir l'intégration
Webservice, OAuth2 ou connecteur TMS.
Renseigner les paramètres
Clés, URL, mappings de champs.
Tester
Vérifiez via les logs que la synchronisation fonctionne.
Bon à savoir
- Les connecteurs TMS demandent un mapping précis des champs : prenez le temps de le vérifier avant une synchronisation massive.
- Les logs sont votre meilleur outil de diagnostic en cas d'échec de synchronisation.
- Pour un reporting externe, Power BI (OData) est souvent plus simple qu'un connecteur (voir sa fiche).