Install the Magento module

Tocsin24 walks you through the “Installing and pairing the Magento 2 module” step of your instance (you can find it later under Settings › Module). This guide details each step and the messages you might come across.

1. Install the module

Two methods, your choice: with Composer (recommended, updates take a single command) or with an archive to unzip into app/code. Do not use both at once.

With Composer

1. In Tocsin24, “Install the module” block, keep the “With Composer” tab and click “Copy the commands”: they contain the username and token that belong to your instance.
2. Paste them into a terminal, from the shop’s root folder (the one that contains bin/magento). They look like this:

The username and token are saved in the shop’s auth.json file: do not add it to the shop’s Git repository.

Without Composer: archive in app/code

1. In Tocsin24, “Without Composer” tab, click “Download the Magento module”.
2. Upload the archive to the server, then unzip it into app/code: it creates the app/code/Tocsin24/Connector folder.

If the module was already in app/code and you are moving to Composer, delete that folder first: otherwise Magento finds the module twice.

Enable the module

In both cases, finish with these commands (adjust the static content languages to those of your shop):

In production mode, setup:upgrade empties the static content: that is why it is redeployed before the cache is flushed.

Keep var/tocsin24 across deployments

The module keeps its scan of the code files in var/tocsin24. If your deployments create an empty var/ folder, share this subfolder from one release to the next, like var/log, owned by the PHP user. Otherwise, every deployment forces the module to run a full scan again, and code monitoring is blind until the next scan.

2. Create the Magento integration

The integration gives Tocsin24 read-only access to the module, and to nothing else.

1. In the Magento admin, open System › Extensions › Integrations, then “Add New Integration”.
2. Name: Tocsin24. In “Your Password”, enter the password of your administrator account (Magento asks for it as a confirmation).
3. API tab: set “Resource Access” to “Custom” and tick only Tocsin24 Connector — read state.
4. Save. In the list, click “Activate” on the Tocsin24 row, then “Allow”: Magento shows four values, Consumer Key, Consumer Secret, Access Token and Access Token Secret.
5. In Tocsin24, enter the API base URL (usually the shop’s address) and paste the four values, then “Save”.

3. Pair the shop

Pairing proves that you manage the shop. The code is used only once.

1. In Tocsin24, click “Generate a pairing code”. It lasts one hour.
2. In the Magento admin, open Stores › Configuration › Tocsin24 › Connector, “Pairing and security” group.
3. Paste the code into “Pairing code”. In “Allowed IP addresses”, enter the platform addresses shown by Tocsin24, one per line. Click “Save Config”. Once saved, the code is shown as ******: it is encrypted, this is normal.
4. Clean the configuration cache:

5. In Tocsin24, click “Verify the pairing”. The instance becomes active and the first scans start.

If your hosting provider filters access to addresses under /rest/ (firewall, anti-bot protection), add the platform IP addresses there too.

Check the version and update

• The installed version is shown at the top of Stores › Configuration › Tocsin24 › Connector, “Module” block. Tocsin24 also shows it under Settings › Module, with the latest published version and an “update available” label when there is one.
• Update with Composer: composer update tocsin24/module-connector, then the commands from Enable the module.
• Update with the archive: download the new archive under Settings › Module, replace the contents of app/code/Tocsin24/Connector, then run the same commands.

Updating keeps the integration and the pairing: nothing needs redoing in Tocsin24.