Désactiver les utilisateurs inactifs de Matrix sans supprimer l'historique des salles

Pour désactiver un compte Matrix local inactif, utilisez POST /_synapse/admin/v1/deactivate/<user_id>le point de terminaison Synapse après avoir vérifié le compte et ses appareils. Synapse appelle cette action une désactivation : elle révoque les identifiants et supprime l’utilisateur des salons, mais ne supprime pas définitivement l’enregistrement du compte ni les messages de l’utilisateur. La documentation Synapse v1.157 fait également la distinction entre la désactivation et l’option ` erase--device`, dont les effets sont plus limités que ce à quoi s’attendent de nombreux administrateurs. Consultez la documentation de l’API d’administration des utilisateurs Synapse . Ces étapes suivent la référence de l’API Synapse v1.157 (vérifiée le 10 octobre 2026) ; veuillez vérifier le comportement par rapport à la documentation de votre version déployée.

Le terme « supprimer » signifie-t-il la suppression définitive d'un compte ?

Non. L'opération prise en charge par l'API d'administration est la désactivation. Elle supprime les jetons d'accès actifs, les appareils et les clés de chiffrement de bout en bout, les outils de diffusion, le hachage du mot de passe, les identifiants tiers et les appartenances aux salles de l'utilisateur. Les invitations en attente sont rejetées et les données du compte sont supprimées. Cette modification a des conséquences même si la erasevaleur est fausse.

Ce paramètre "erase": truesupprime également le nom d'affichage, l'URL de l'avatar et les champs personnalisés du profil de l'utilisateur, et marque le compte comme effacé. Il ne supprime pas les messages envoyés ou reçus, les médias téléchargés, les correspondances d'identifiants SSO ni aucun autre enregistrement pouvant contenir des données personnelles. Les membres actuels du salon peuvent toujours voir les messages de l'utilisateur ; la documentation précise que ces messages sont masqués pour les personnes qui rejoignent le salon ultérieurement. N'utilisez pas cette option d'API comme une procédure d'effacement légal complète. Veuillez suivre les procédures de conservation et de confidentialité de votre organisation avant de l'utiliser. Consultez les effets précis de la désactivation et de l'effacement .

Si vous avez besoin d'une restriction réversible pendant qu'un compte fait l'objet d'une enquête, privilégiez la suspension via le point de terminaison de Synapse. La suspension bloque des actions telles que l'envoi de messages, l'accès à des salons et l'envoi d'invitations, tout en permettant la réactivation du compte. La désactivation est plus adaptée à un compte ayant satisfait à votre politique de désactivation ou d'inactivité.

Comment confirmer qu'un compte est réellement inactif ?

Il n'existe pas de seuil d'inactivité universel. Définissez-en un conformément à la politique de votre organisation, puis vérifiez l'activité réelle des appareils plutôt que de considérer une ancienne date d'enregistrement comme preuve. Un compte inactif peut appartenir à un service, à un client rarement utilisé ou à une personne en congé. Excluez les identités de service et les administrateurs de serveur personnel du nettoyage, sauf si le propriétaire a approuvé leur suppression.

  1. Utilisez un jeton d'administrateur serveur provenant d'un hôte de confiance. Un jeton d'administrateur de salle ne suffit pas. Synapse recommande d'éviter /_synapse/admin/l'accès via un proxy inverse public et d'effectuer les requêtes API d'administration depuis l'hôte Synapse lorsque cela est possible. Transmettez le jeton dans un en-tête Authorization ; ne le collez pas dans un script partagé et ne le publiez pas dans les journaux. Consultez le guide d'authentification et d'accès à l'API d'administration de Synapse .
  2. Affichez la liste des comptes locaux et examinez le candidat. Le point de terminaison de liste v2 pagine les résultatsnext_token ; utilisez sa valeur de retour comme fromvaleur de la requête suivante. Le guests=falsefiltre optionnel exclut les invités, mais Synapse indique que ce paramètre n'est pas pris en charge lorsque l'intégration du service d'authentification Matrix est activée. Supprimez-le dans cette configuration.
curl -sS -H "Authorization: Bearer $SYNAPSE_ADMIN_TOKEN" \
  "$SYNAPSE_URL/_synapse/admin/v2/users?from=0&limit=100&guests=false"

Examinez les champs renvoyés . namePar défaut, les comptes désactivés sont exclus. L'exemple ci-dessous présente un seul candidat ; un serveur réel peut renvoyer plusieurs pages admin.user_typedeactivated

Exemple de réponse de l'API d'administration Synapse à la liste des utilisateurs montrant @inactive:example.org comme un compte non administrateur qui n'est pas désactivé.
Exemple de résultat de la liste des utilisateurs : vérifiez l’identifiant Matrix exact, le statut d’administrateur et l’état de désactivation actuel avant de continuer.
  1. Vérifiez les appareils du candidat. Demandez une vérification GET /_synapse/admin/v2/users/<user_id>/devices. Comparez l'horodatage de chaque appareil last_seen_tsavec la date limite fixée par votre politique ; il s'agit d'un horodatage Unix en millisecondes, qui peut être obsolète de quelques minutes. Considérez-le comme un élément à examiner, et non comme un motif de suppression automatique.
curl -sS -H "Authorization: Bearer $SYNAPSE_ADMIN_TOKEN" \
  "$SYNAPSE_URL/_synapse/admin/v2/users/%40inactive%3Aexample.org/devices"

Remplacez l'identifiant Matrix d'exemple par celui de l'utilisateur local que vous avez examiné. Si un appareil a été utilisé récemment, arrêtez-vous et vérifiez auprès de son propriétaire. Si les horodatages sont anciens, mais que le compte est un administrateur, un bot, un compte de support ou un utilisateur lié à l'authentification unique (SSO), vérifiez la propriété et les dépendances avant de continuer. Consultez la documentation de l'API de l'appareil last_seen_tset ses unités .

Exemple de réponse device-list pour @inactive:example.org avec un périphérique Web et son horodatage last_seen_ts
Exemple de résultat pour un appareil : comparez les dernières connexions (last_seen_ts) de tous les appareils du compte avec votre période d’inactivité autorisée.

Comment désactiver un compte approuvé ?

Utilisez l'identifiant Matrix local complet, et non un nom d'affichage. Le point de terminaison de désactivation accepte un objet JSON facultatiferase ; sa valeur par défaut est « false ». Conserver la valeur par défaut préserve les champs de profil tout en supprimant les sessions, les appareils, les appartenances aux salles et les autres données de désactivation décrites ci-dessus.

curl -sS -X POST \
  -H "Authorization: Bearer $SYNAPSE_ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"erase": false}' \
  "$SYNAPSE_URL/_synapse/admin/v1/deactivate/%40inactive%3Aexample.org"

Exécutez cette procédure pour un utilisateur à la fois. Une réponse positive ne remplace pas la vérification que vous avez bien ciblé le compte souhaité. N'utilisez pas une liste d'horodatages anciens pour lancer une requête POST en masse tant que chaque compte n'a pas passé vos contrôles de validation et de conservation.

Exemple de requête POST curl vers le point de terminaison de désactivation de Synapse avec l'option erase définie sur false.
Le corps de la requête d'exemple utilise erase=false, évitant ainsi les actions supplémentaires de suppression de profil et d'effacement du marqueur.

Comment vérifier le résultat et choisir d'effacer ?

Interrogez à nouveau le compte GET /_synapse/admin/v2/users/<user_id>. Vérifiez que la réponse identifie l'ID Matrix attendu et indique que "deactivated": truele compte ne possède plus de jetons d'accès, d'appareils ni d'abonnements à une salle actifs. Conservez l'heure de la requête et l'ID du compte dans vos archives administratives, mais n'y stockez jamais le jeton d'accès.

curl -sS -H "Authorization: Bearer $SYNAPSE_ADMIN_TOKEN" \
  "$SYNAPSE_URL/_synapse/admin/v2/users/%40inactive%3Aexample.org"

N'activez cette option "erase": trueque si votre décision en matière de conservation ou de confidentialité exige spécifiquement la suppression du marqueur effacé et du champ de profil de Synapse. Ce paramètre ne supprime pas l'historique des messages ni les médias téléchargés. Si vous devez gérer ces éléments, suivez les procédures documentées de suppression d'événements et de gestion des médias , et vérifiez leurs effets indépendamment. Prévoyez également soigneusement la désactivation : la réactivation peut nécessiter la définition d'un nouveau mot de passe pour les comptes à mot de passe local, et les clés de chiffrement de l'appareil supprimées ne peuvent pas être restaurées par simple réactivation du compte.

Exemple de réponse à une requête utilisateur Synapse avec l'attribut « deactivated » défini sur « true » pour @inactive:example.org
Exemple de réponse de vérification : confirmer que la désactivation est vraie pour l’identifiant utilisateur exact après la requête POST.

Pour le compte ciblé, vérifiez que la requête de suivi renvoie bien une réponse "deactivated": true. Si le résultat diffère ou si une erreur se produit, interrompez la requête et examinez la réponse avant de la répéter.

Laisser un commentaire

Désactiver les utilisateurs inactifs de Matrix sans supprimer l'historique des salles

Désactiver les utilisateurs inactifs de Matrix sans supprimer l'historique des salles

Consultez l'activité des appareils, désactivez les comptes Synapse inactifs confirmés via l'API d'administration et découvrez ce que supprime réellement l'option d'effacement.

Réduire la pression sur la mémoire de PostgreSQL dans Matrix Synapse

Déterminez si la mémoire utilisée par PostgreSQL provient des requêtes, des tampons partagés, des connexions ou de la maintenance, puis apportez des modifications ciblées compatibles avec Synapse.

Pourquoi les jonctions de salles Matrix Synapse sont-elles lentes ? Que vérifier ?

Pourquoi les jonctions de salles Matrix Synapse sont-elles lentes ? Que vérifier ?

Avant de modifier les paramètres Synapse, vérifiez si la lenteur des connexions à une salle Matrix se fait à un serveur distant, si le délai de fédération est dépassé, si la charge de la base de données locale est excessive ou si la file d'attente de l'expéditeur est trop longue.

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é.