Fermer les inscriptions à Matrix ou exiger des jetons d'invitation sur Synapse

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

  1. 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.
  2. 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.
  3. 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.
  4. 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

Laisser un commentaire

Fermer les inscriptions à Matrix ou exiger des jetons d'invitation sur Synapse

Empêchez la création de comptes ouverts sur un serveur Synapse auto-hébergé, ou limitez les inscriptions aux invitations uniquement avec des jetons d'inscription à usage limité.

Avertissement relatif à l'identité de session : vérifiez votre connexion en toute sécurité.

L'avertissement de session non vérifiée de Clear Element utilise un appareil de confiance ou une clé de récupération, avec des contrôles qui protègent votre historique de conversation chiffré.

Évitez les délais d'expiration de verrouillage de fichiers ownCloud grâce au bon backend

Distinguez les conflits de verrouillage de base de données des verrous WebDAV expirés, puis choisissez et configurez le correctif ownCloud 10 approprié.

Que vérifier lorsque ownCloud Web s'ouvre sur une page blanche

Que vérifier lorsque ownCloud Web s'ouvre sur une page blanche

Identifiez les causes d'un écran web ownCloud vide grâce à des vérifications ciblées : cache du navigateur, ressources web manquantes, erreurs de service ou paramètres d'URL du proxy inverse.

Effacer l'avertissement de mémoire PHP ownCloud dans le contexte d'exécution approprié

Définissez la limite de mémoire PHP web d'ownCloud, redémarrez le service correspondant et vérifiez la valeur active sans la confondre avec les paramètres de l'interface de ligne de commande ou les limites de téléchargement.

Résolution des problèmes de connexion MySQL à ownCloud 10

Découvrez si MySQL, PHP, les paramètres de socket ou les autorisations de base de données bloquent ownCloud 10, puis vérifiez une solution sûre.

Définissez une date d'expiration précise pour les liens publics ownCloud

Définissez une date d'expiration précise pour les liens publics ownCloud

Rendez obligatoire l'expiration des liens publics dans ownCloud Classic, définissez une durée de vie maximale et vérifiez les partages existants qui pourraient nécessiter un nettoyage séparé.

Ajoutez l'authentification à deux facteurs TOTP à ownCloud Infinite Scale avec Keycloak

Ajoutez l'authentification à deux facteurs TOTP à ownCloud Infinite Scale avec Keycloak

Activez le protocole TOTP via Keycloak, inscrivez les utilisateurs en toute sécurité et comprenez quand les paramètres MFA au niveau du routage d'Infinite Scale s'appliquent.

Rétablissez la synchronisation ownCloud en associant le client à votre serveur.

Vérifiez si le problème provient d'une incompatibilité entre OC10 et 7.x ou d'un journal CSync endommagé, puis appliquez le correctif approprié sans supprimer les fichiers synchronisés.

Sécurisez ownCloud avec HTTPS grâce à Let's Encrypt et Nginx.

Sécurisez ownCloud avec HTTPS grâce à Let's Encrypt et Nginx.

Choisissez HTTP-01 ou DNS-01, configurez un proxy inverse ownCloud et vérifiez que Certbot renouvelle automatiquement les certificats HTTPS.