Installer le module Magento
- Magento Open Source et Adobe Commerce 2.4.4 à 2.4.9
- PHP 8.1 à 8.5
- Module 1.0.8
- Mis à jour le 26 octobre 2026
- 15 minutes
Le module Tocsin24 Connector lit l’état de votre boutique (versions, correctifs, comptes, fichiers de code, logs) et le transmet à Tocsin24, en lecture seule : il ne modifie rien dans la boutique et ne transmet aucun secret. Comptez un quart d’heure : installer le module, créer l’intégration Magento, puis appairer la boutique.
Sur cette page
Tocsin24 vous guide dans l’étape « Installation et appairage du module Magento 2 » de votre instance (vous la retrouvez ensuite dans Réglages › Module). Ce guide détaille chaque étape et les messages que vous pourriez rencontrer.
1. Installer le module
Deux méthodes, au choix : par Composer (recommandé, les mises à jour se font en une commande) ou par une archive à décompresser dans app/code. N’utilisez pas les deux à la fois.
Avec Composer
- Dans Tocsin24, bloc « Installer le module », gardez l’onglet « Avec Composer » et cliquez sur « Copier les commandes » : elles contiennent l’identifiant et le jeton propres à votre instance.
- Collez-les dans un terminal, depuis le dossier racine de la boutique (celui qui contient
bin/magento). Elles ont cette forme :
L’identifiant et le jeton sont enregistrés dans le fichier auth.json de la boutique : ne l’ajoutez pas au dépôt Git de la boutique.
Sans Composer : archive dans app/code
- Dans Tocsin24, onglet « Sans Composer », cliquez sur « Télécharger le module Magento ».
- Envoyez l’archive sur le serveur, puis décompressez-la dans
app/code: elle crée le dossierapp/code/Tocsin24/Connector.
Si le module était déjà dans app/code et que vous passez à Composer, supprimez d’abord ce dossier : sinon Magento trouve le module deux fois.
Activer le module
Dans les deux cas, terminez par ces commandes (adaptez les langues du contenu statique à celles de votre boutique) :
En mode production, setup:upgrade vide le contenu statique : c’est pourquoi il est redéployé avant de vider le cache.
Conserver var/tocsin24 lors des déploiements
Le module garde son relevé des fichiers de code dans var/tocsin24. Si vos déploiements recréent un dossier var/ vide, partagez ce sous-dossier d’une version à l’autre, comme var/log, avec le propriétaire de PHP. Sans cela, chaque déploiement oblige le module à refaire un relevé complet, et la surveillance du code est aveugle jusqu’au relevé suivant.
2. Créer l’intégration Magento
L’intégration donne à Tocsin24 un accès en lecture seule au module, et à rien d’autre.
- Dans l’administration Magento, ouvrez Système › Extensions › Intégrations, puis « Ajouter une nouvelle intégration ».
- Nom : Tocsin24. Dans « Votre mot de passe », saisissez le mot de passe de votre compte administrateur (Magento le demande pour confirmer).
- Onglet API : choisissez un accès aux ressources « Personnalisé » et ne cochez que Tocsin24 Connector — lecture de l’état.
- Enregistrez. Dans la liste, cliquez sur « Activer » sur la ligne Tocsin24, puis sur « Autoriser » : Magento affiche quatre valeurs, Consumer Key, Consumer Secret, Access Token et Access Token Secret.
- Dans Tocsin24, saisissez l’URL de base de l’API (en général l’adresse de la boutique) et collez les quatre valeurs, puis « Enregistrer ».
3. Appairer la boutique
L’appairage prouve que vous administrez la boutique. Le code ne sert qu’une fois.
- Dans Tocsin24, cliquez sur « Générer un code d’appairage ». Il vaut une heure.
- Dans l’administration Magento, ouvrez Magasins › Configuration › Tocsin24 › Connecteur, groupe « Appairage et sécurité ».
- Collez le code dans « Code d’appairage ». Dans « Adresses IP autorisées », saisissez les adresses de la plateforme indiquées par Tocsin24, une par ligne. Cliquez sur « Enregistrer la configuration ». Une fois enregistré, le code s’affiche sous la forme
******: il est chiffré, c’est normal. - Videz le cache de configuration :
- Dans Tocsin24, cliquez sur « Vérifier l’appairage ». L’instance devient active et les premiers relevés commencent.
Si votre hébergeur filtre l’accès aux adresses en /rest/ (pare-feu, protection anti-robots), ajoutez-y aussi les adresses IP de la plateforme.
Vérifier la version et mettre à jour
- La version installée s’affiche en tête de Magasins › Configuration › Tocsin24 › Connecteur, bloc « Module ». Tocsin24 l’affiche aussi dans Réglages › Module, avec la dernière version publiée et la mention « mise à jour disponible » quand il y en a une.
- Mise à jour par Composer :
composer update tocsin24/module-connector, puis les commandes de Activer le module. - Mise à jour par archive : téléchargez la nouvelle archive dans Réglages › Module, remplacez le contenu de
app/code/Tocsin24/Connector, puis les mêmes commandes.
La mise à jour garde l’intégration et l’appairage : rien n’est à refaire dans Tocsin24.
Problèmes fréquents
Composer répond 401 ou 403 sur app.tocsin24.com
L’identifiant ou le jeton ne correspond pas : recopiez les deux premières commandes depuis Tocsin24 (bouton « Copier les commandes »), elles sont propres à cette instance. L’accès Composer ne vaut que pour une instance en configuration, active ou en pause : une instance supprimée n’y a plus droit.
« Module 'Tocsin24_Connector' … has been already defined »
Le module est installé deux fois, par Composer et dans app/code. Gardez une seule méthode : pour passer à Composer, supprimez le dossier app/code/Tocsin24/Connector, puis relancez bin/magento setup:upgrade.
« Endpoint introuvable : le module Tocsin24 Connector (Tocsin24_Connector) n’est pas installé ou pas activé »
Vérifiez avec bin/magento module:status Tocsin24_Connector que le module est activé, relancez bin/magento setup:upgrade puis bin/magento cache:flush. Vérifiez aussi l’URL de base de l’API saisie dans Tocsin24 : c’est en général l’adresse de la boutique, sans /rest ni code de magasin.
« Token d’intégration refusé par Magento »
L’intégration a été réautorisée, recréée ou supprimée : ses quatre valeurs ont changé. Dans Tocsin24, Réglages › Module, ouvrez « Mettre à jour le jeton refusé », collez les quatre nouvelles valeurs, puis « Enregistrer et vérifier ».
« Accès refusé : ressource ACL manquante sur l’intégration, ou adresse IP non autorisée par le module »
Vérifiez dans l’onglet API de l’intégration que « Tocsin24 Connector — lecture de l’état » est cochée, et que le champ « Adresses IP autorisées » du module contient toutes les adresses indiquées par Tocsin24. Depuis la version 1.0.7, le module ne répond qu’à l’intégration appairée : si une autre intégration a été retenue à sa place (message « Seule l’intégration appairée à Tocsin24 peut appeler ce module » dans var/log/tocsin24.log), désactivez cette autre intégration ; celle de Tocsin24 est retenue au premier appel suivant.
« Aucun code d’appairage n’est saisi dans la configuration du module »
Le code est enregistré mais Magento sert encore l’ancienne configuration : videz le cache de configuration (bin/magento cache:clean config), puis cliquez de nouveau sur « Vérifier l’appairage ». Le code se saisit dans la portée par défaut (« Configuration par défaut »), pas dans celle d’un site ou d’une vue.
« Le code d’appairage a expiré » ou « Trop de tentatives avec ce code »
Un code vaut une heure et dix essais. Cliquez sur « Générer un nouveau code », saisissez-le dans Magento à la place de l’ancien, videz le cache de configuration, puis vérifiez de nouveau.
« L’URL déclarée ne figure pas parmi les URLs de base configurées dans Magento »
L’URL de base de l’API saisie dans Tocsin24 doit être l’une des URL de base de la boutique (Magasins › Configuration › Général › Web), avec le même schéma (https) et le même nom de domaine, www compris.
« Trop d’appels : le serveur web de l’hébergeur limite le débit »
Une protection placée devant Magento (pare-feu applicatif, anti-robots de l’hébergeur, Cloudflare…) bloque les appels de Tocsin24 avant qu’ils n’atteignent la boutique. Demandez à votre hébergeur d’exclure de cette protection les adresses IP de la plateforme, listées dans Tocsin24 (Réglages › Module, « Adresses IP de la plateforme »), au moins pour les adresses en /rest/.
« Instance injoignable (DNS, pare-feu ou délai dépassé) »
Tocsin24 n’arrive pas à joindre la boutique : vérifiez que l’adresse répond depuis l’extérieur et qu’aucun pare-feu ne bloque les adresses IP de la plateforme. L’URL doit être publique et en https.
La surveillance du code repart de zéro après chaque déploiement
Votre déploiement vide ou recrée le dossier var/tocsin24. Partagez-le d’une version à l’autre, comme var/log, avec le propriétaire de PHP : voir plus haut « Conserver var/tocsin24 lors des déploiements ».
Besoin d’aide ?
Nous écrire