MelisLogin2faPrimotexto

Canal d'envoi de SMS pour le système 2FA de Melis via la passerelle Primotexto. Package melisplatform/melis-login-2fa-primotexto.

Présentation

MelisLogin2faPrimotexto est un canal 2FA optionnel qui envoie le code de connexion à usage unique par SMS via l'API Primotexto. Il s'intègre au contrat d'événement du module central MelisLogin2fa (canSend / sendUserCode). Lorsqu'il est placé en tête des canaux actifs et que l'utilisateur possède un numéro de téléphone valide, le code est transmis par SMS ; si aucun numéro valide n'est trouvé mais qu'un canal email est également actif, le système bascule sur l'email et en informe l'utilisateur.

Activation

Ajouter dans config/melis.module.load.php :

php

return [
    'MelisLogin2faPrimotexto',
];

Nécessite melisplatform/melis-login-2fa (^5.3) et PHP ^8.1|^8.3. Le module central MelisLogin2fa doit être chargé en premier.

Une fois chargé, activez SMS (Primotexto) dans la configuration 2FA partagée (Configuration système → 2FA) et placez-le en première position pour en faire le canal principal. Renseignez les identifiants API Primotexto sous la clé de configuration melis_login_2fa_primotexto (voir Configuration).

Dans le back-office React

Ce module est un plugin de méthode 2FA côté serveur, et non un outil de back-office. Dans le back-office React (/melis-react), il n'a ni page, ni route, ni entrée de menu. Toute son empreinte React se limite à une brique de découverte réduite à un id : un public/ui-react/brick.manifest.json minimal (avec route, forwardKey et melisKey tous à null) et un brick.tsx qui n'enregistre que son id.

tsx

// ui-react/src/brick.tsx — the entire React contribution (id only, no UI).
window.__melisRegisterBrick?.({ id: 'melis-login-2fa-primotexto' })

C'est l'enregistrement de cet id qui fait apparaître le module dans GET /melis/react-api/react-modules, la liste de découverte des modules actifs qui fournissent une brique. Le useModuleActive('MelisLogin2faPrimotexto') de MelisCore s'appuie sur cette liste pour révéler le champ usr_phone sur le formulaire Utilisateurs natif — les utilisateurs ont besoin d'un numéro de téléphone pour la 2FA par SMS. Le module ne fournit aucun endpoint react-api ni aucune capability propre ; les paramètres de l'API Primotexto (url, api_key, sender) sont rendus par la section de configuration 2FA partagée appartenant au cœur 2FA, et non par ce module.

Configuration

php

// config/autoload/primotexto.local.php  (do NOT commit real keys)
return [
    'melis_login_2fa_primotexto' => [
        'url'     => 'https://api.primotexto.com/v2/notification/messages/send',
        'api_key' => 'YOUR_API_KEY',   // override per environment
        'sender'  => 'Melis',
    ],
];

Avertissement. Le fichier config/module.config.php livré dans le dépôt contient un api_key factice en clair. Remplacez-le toujours dans un fichier de configuration local ou propre à l'environnement, et révoquez toute clé réelle qui aurait pu être commitée.

Services principaux

Alias de service	Rôle
`SmsService`	Appelle l'API HTTP Primotexto pour envoyer l'OTP par SMS ; normalise les numéros français `0…` en `+33…` ; journalise les échecs curl/HTTP dans `CmaErrorLogsTable`
`MelisLogin2faPrimotextoControllerPlugin`	Plugin de contrôleur exposant `canSend($userData)` et `sendUserCode($user, $code)` ; pilote `SmsService`

Écouteurs d'événements

Écouteur	Événement	Comportement
`MelisCoreCanSendListener`	`canSend`	Retourne `['melis-login-2fa-primotexto' => bool]` ; si l'envoi est impossible mais qu'un canal email est ordonné juste après, stocke un `twofa_fallback_message` dans la session `melis_login_2fa`
`MelisCoreSendUserCodeListener`	`sendUserCode`	N'agit que si le code n'a pas encore été envoyé et que ce canal est `orderedModules[0]` ; réutilise ou crée la ligne `melis_core_login_2fa_codes`, envoie via `SmsService`, positionne `sent=true`, appelle `stopPropagation`

Tables de base de données

Table	Contenu
`melis_core_user`	Reçoit une colonne nullable `usr_phone` (ajoutée par le `dbdeploy` de ce module) — numéro de téléphone auquel les codes OTP sont envoyés
`melis_core_login_2fa_codes`	Codes OTP (appartenant au module central `MelisLogin2fa` ; ce canal réutilise ou crée des lignes via `MelisLogin2faService` + `MelisLogin2faCodesTable`)

Exemple

php

// Primotexto API call assembled by SmsService::sendSms()
$url = $config['url'] . '?' . http_build_query([
    'apiKey'     => $config['api_key'],
    'identifier' => $number,           // normalised to +33… for French numbers
    'sender'     => trim($config['sender']),
    'message'    => $message,
]);
// Sent via curl (GET). HTTP >= 400 or curl failure → logged + returns false.

Points d'attention

Dépendance à CmaErrorLogsTable. SmsService journalise les échecs dans CmaErrorLogsTable, issue d'un module client CMA. Si cette table ou ce service n'est pas enregistré dans une installation générique, le chemin de journalisation des erreurs échouera. Rendez cette dépendance optionnelle pour les déploiements hors contexte client d'origine.
Basculement vers l'email. Si Primotexto est en premier mais que l'utilisateur n'a pas de numéro de téléphone valide, et qu'un canal email est actif et ordonné après, le code est transmis par email accompagné d'un message explicatif.
Numéro masqué dans l'interface. L'écran de saisie du code affiche uniquement une version masquée du numéro de téléphone (ex. +3…**…07).

Fichiers clés

Élément	Chemin
Bootstrap du module	`vendor/melisplatform/melis-login-2fa-primotexto/src/Module.php`
Écouteur `canSend`	`vendor/melisplatform/melis-login-2fa-primotexto/src/Listener/MelisCoreCanSendListener.php`
Écouteur `sendUserCode`	`vendor/melisplatform/melis-login-2fa-primotexto/src/Listener/MelisCoreSendUserCodeListener.php`
Service API SMS	`vendor/melisplatform/melis-login-2fa-primotexto/src/Service/SmsService.php`
Plugin de contrôleur	`vendor/melisplatform/melis-login-2fa-primotexto/src/Controller/Plugin/MelisLogin2faPrimotextoControllerPlugin.php`
Brique React	`vendor/melisplatform/melis-login-2fa-primotexto/ui-react/src/brick.tsx`
Manifeste React	`vendor/melisplatform/melis-login-2fa-primotexto/public/ui-react/brick.manifest.json`
Configuration du module	`vendor/melisplatform/melis-login-2fa-primotexto/config/module.config.php`
Migration DB	`vendor/melisplatform/melis-login-2fa-primotexto/install/dbdeploy/`

Voir aussi : MelisLogin2fa · MelisLogin2faEmail · MelisCore

MelisLogin2faPrimotexto ​

Présentation ​

Activation ​

Dans le back-office React ​

Configuration ​

Services principaux ​

Écouteurs d'événements ​

Tables de base de données ​

Exemple ​

Points d'attention ​

Fichiers clés ​