Pour désactiver les inscriptions publiques sur un serveur Matrix auto-hébergé exécutant Synapse, configurez le système enable_registration: falseet homeserver.yamlredémarrez Synapse. Si vous souhaitez que les personnes invitées créent elles-mêmes leur compte, laissez l'inscription activée mais exigez un jeton d'inscription. Consultez le registration_shared_secretparamètre correspondant : toute personne connaissant ce paramètre peut toujours créer des comptes, y compris les administrateurs du serveur, même lorsque l'inscription classique est désactivée.
Choisissez la politique d'inscription appropriée
Le paramétrage approprié dépend de la manière dont les nouveaux comptes doivent être créés :
- Serveur privé, comptes gérés par un administrateur : désactiver l’inscription publique. Créer les utilisateurs via la commande Synapse
register_new_matrix_userou toute autre procédure administrative approuvée.
- Serveur sur invitation uniquement : les utilisateurs s’inscrivent via Element ou un autre client. Activez l’inscription et exigez un jeton. Attribuez à chaque utilisateur un jeton à usage limité via un canal privé.
- Serveur public : les jetons d’inscription, le CAPTCHA ou la vérification de l’adresse e-mail/du numéro de téléphone peuvent réduire les abus automatisés, mais ne garantissent pas la fiabilité de chaque compte.
Cet article traite de Synapse, l'implémentation de serveur domotique Matrix auto-hébergée la plus répandue. Les autres logiciels de serveur domotique possèdent leur propre configuration. La documentation de configuration actuelle de Synapse indique que l'enregistrement est désactivé par défaut et que les jetons d'enregistrement ne fonctionnent que lorsque l'enregistrement est activé. Si vous utilisez le service d'authentification Matrix (MAS), consultez sa documentation pour connaître les options d'enregistrement correspondantes ; l'API d'administration des jetons d'enregistrement de Synapse est désactivée lorsque l'intégration de MAS est activée.
Désactiver l'inscription publique sur Synapse
- Trouvez le fichier de configuration actif. Les installations de paquets classiques utilisent `/etc/packages`
/etc/matrix-synapse/homeserver.yaml ; les installations de conteneurs montent souvent le fichier sous `/etc/packages` /data/homeserver.yaml. Utilisez le chemin configuré pour votre service plutôt que de supposer un emplacement unique.
- Sauvegardez le fichier, puis activez l'indicateur d'enregistrement. Dans la configuration YAML principale, ajoutez ou modifiez le paramètre comme suit :
enable_registration: false
Si la clé existe déjà, modifiez l'entrée existante au lieu d'en ajouter une copie. L'indentation YAML et les clés dupliquées peuvent prêter à confusion ; conservez donc le paramètre au niveau supérieur et préservez la structure actuelle du fichier.
- Vérifiez le secret d'enregistrement partagé. Synapse
registration_shared_secret(ou registration_shared_secret_path) prend en charge le script d'enregistrement administratif. Le guide d'installation de Synapse indique qu'une personne connaissant ce secret peut créer des comptes standard ou administrateur, même si l'enregistrement public est désactivé. Conservez-le confidentiel, limitez l'accès à son fichier et ne le partagez pas dans un dépôt public, la configuration du client ou un message aux invités. Si vous n'utilisez pas l'enregistrement par secret partagé, supprimez ce paramètre uniquement après avoir vérifié qu'aucune automatisation n'en dépend. Vous pouvez créer des comptes à l'aide d'un autre flux de travail d'administrateur pris en charge.
- Validez et redémarrez Synapse. Utilisez le gestionnaire de services, l'orchestration de conteneurs ou la méthode de déploiement qui exécute votre serveur. Pour un service systemd généralement nommé `synapse`
matrix-synapse, un administrateur peut exécuter la commande suivante :
sudo systemctl restart matrix-synapse
sudo systemctl status matrix-synapse --no-pager
Le nom exact du service varie selon le type de déploiement (package ou conteneur). En cas d'échec du démarrage du service, consultez les journaux ; évitez de modifier un fichier de configuration de manière répétée sans avoir résolu l'erreur YAML ou de configuration signalée.
La désactivation de l'inscription ne supprime pas les comptes existants ni l'accès aux salles. Ce paramètre empêche les nouvelles inscriptions régulières via le processus d'inscription client ; il ne s'agit pas d'une suppression d'utilisateur ni d'une désactivation de serveur.
Autoriser les inscriptions uniquement avec des jetons d'enregistrement
Utilisez cette option si vous souhaitez que les invités s'inscrivent eux-mêmes, mais sans page d'inscription ouverte. Dans homeserver.yaml, configurez les deux paramètres :
enable_registration: true
registration_requires_token: true
Redémarrez Synapse après l'enregistrement. L'authentification par jeton ne signifie pas la désactivation de l'inscription : les personnes disposant d'un jeton valide peuvent créer des comptes. Le manuel de configuration de Synapse recommande des mesures anti-abus lorsque l'inscription est activée ; choisissez une politique adaptée à votre public et à vos capacités opérationnelles.
Pour les versions de Synapse compatibles avec l'API d'administration des jetons d'enregistrement (documentée), un administrateur peut créer un jeton à usage unique. L'exemple suivant utilise une URL et un jeton d'accès fictifs ; exécutez-le uniquement depuis un environnement d'administration de confiance, remplacez l'URL de base publique de votre serveur et le jeton d'accès par un jeton d'accès administrateur, et protégez l'historique et les journaux de la session :
curl -X POST "https://matrix.example.com/_synapse/admin/v1/registration_tokens/new" \
-H "Authorization: Bearer YOUR_SERVER_ADMIN_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
--data '{"uses_allowed":1}'
La réponse inclut le jeton généré. Partagez cette valeur en privé avec l'utilisateur concerné. L'API de Synapse prend également en charge une durée de validité, mesurée en millisecondes depuis l'époque Unix ; consultez la documentation officielle de l'API pour calculer et définir correctement cette durée pour votre déploiement. Un jeton sans limite d'utilisation ni date d'expiration est par défaut utilisable en illimité et sans date d'expiration ; définissez donc les limites avec soin. Les administrateurs peuvent lister, mettre à jour ou supprimer les jetons via cette même API. Ne publiez jamais un jeton porteur ou un jeton d'enregistrement dans un sujet ou un article public.
La gestion des jetons est soumise à des limitations de version et de déploiement : consultez la documentation de l’API d’administration correspondant à votre version de Synapse. La documentation actuelle indique que cette API Synapse est indisponible lorsque l’intégration MAS est activée ; dans ce cas, utilisez l’API d’administration ou l’interface de ligne de commande MAS.
Erreurs de configuration courantes
- Modification du mauvais fichier : les conteneurs peuvent lire un fichier monté alors que l’hôte en possède une copie distincte. Vérifiez le chemin d’accès utilisé par le processus Synapse en cours d’exécution.
- Oublier le redémarrage : les modifications de configuration sont lues par le service, donc une modification de texte réussie à elle seule ne démontre pas que la nouvelle politique est active.
- Si l'inscription est désactivée, toutes les routes sont bloquées : un secret partagé configuré reste une voie de création de compte. Protégez-le ou supprimez-le selon que l'automatisation administrative en a besoin ou non.
- L'activation des jetons sans désactiver l'inscription
registration_requires_token ne suffit pas à activer l'inscription. Les deux options doivent permettre le bon déroulement des opérations.
- Même si les jetons accessibles uniquement sur invitation empêchent tout abus, un jeton réutilisable divulgué peut être utilisé par des personnes non autorisées. Il est donc conseillé de limiter leur utilisation, de définir une date d'expiration lorsque cela est possible et de les distribuer de manière privée.
Vérifier le résultat
Après le redémarrage de Synapse, ouvrez le processus d'inscription de votre serveur d'accueil dans un client Matrix en étant déconnecté. Pour un serveur fermé, le client ne devrait pas proposer d'inscription publique réussie, tandis que les utilisateurs existants devraient toujours pouvoir se connecter. Pour une inscription protégée par jeton, testez le processus sans jeton et vérifiez qu'il en demande un ; utilisez ensuite un jeton de test dans un compte de test contrôlé et vérifiez que l'inscription réussit. Consultez les journaux de Synapse et l'état du jeton de l'API d'administration si le résultat diffère de la stratégie prévue. Évitez d'utiliser le jeton d'invitation réel si cela compromet son unique utilisation autorisée.
Références officielles