Desactivar usuarios inactivos de Matrix sin borrar el historial de la sala.

Para eliminar una cuenta local inactiva de Matrix del servicio, utilice POST /_synapse/admin/v1/deactivate/<user_id>el punto final de Synapse tras revisar la cuenta y sus dispositivos. Synapse denomina a esto desactivación: revoca las credenciales y elimina al usuario de las salas, pero no borra permanentemente el registro de la cuenta ni los mensajes del usuario. La documentación actual de Synapse v1.157 también distingue la desactivación del eraseindicador opcional, que tiene efectos más limitados de lo que muchos administradores esperan. Documentación de la API de administración de usuarios de Synapse . Estos pasos siguen la referencia de la API de Synapse v1.157, revisada el 10 de octubre de 2026; confirme el comportamiento con la documentación de su versión implementada.

¿"Eliminar" significa la eliminación permanente de la cuenta?

No. La API de administración admite la desactivación. Elimina los tokens de acceso activos, los dispositivos, las claves de cifrado de extremo a extremo, los pushers, el hash de contraseña, los ID de terceros y las membresías de sala del usuario. Las invitaciones pendientes se rechazan y se eliminan los datos de la cuenta. Este es un cambio importante incluso cuando erasees falso.

Esta configuración "erase": trueelimina el nombre de usuario, la URL del avatar y los campos de perfil personalizados, y marca la cuenta como borrada. No elimina los mensajes enviados o recibidos, los archivos multimedia subidos, las asignaciones de ID de SSO ni ningún otro registro que pueda contener datos personales. Los miembros existentes de la sala aún pueden ver los mensajes del usuario; la documentación indica que estos mensajes se ocultan para quienes se unan a la sala posteriormente. No considere esta opción de API como un proceso de borrado legal completo. Siga el proceso de retención y privacidad de su organización antes de usarla. Revise los efectos exactos de la desactivación y el borrado .

Si necesita una restricción reversible mientras se investiga una cuenta, considere la opción de suspensión de Synapse. La suspensión bloquea acciones como enviar mensajes, unirse a salas y enviar invitaciones, pero permite reactivar la cuenta. La desactivación es más adecuada para una cuenta que ha superado la política de baja o inactividad.

¿Cómo se puede confirmar que una cuenta está realmente inactiva?

No existe un umbral de inactividad universal. Establezca uno según la política de su organización y, a continuación, verifique la actividad real del dispositivo en lugar de utilizar una fecha de registro antigua como prueba. Una cuenta inactiva puede pertenecer a un servicio, a un cliente poco utilizado o a una persona de baja. Excluya las identidades de servicio y los administradores de servidores domésticos de la limpieza, a menos que el propietario haya aprobado su eliminación.

  1. Utilice un token de administrador de servidor de un host de confianza. Un administrador de sala no es suficiente. Synapse recomienda evitar /_synapse/admin/el acceso público a través de proxy inverso y realizar las solicitudes a la API de administración desde el host de Synapse cuando sea posible. Envíe el token en un encabezado de autorización; no lo pegue en un script compartido ni lo publique en los registros. Guía de autenticación y acceso a la API de administración de Synapse .
  2. Enumera las cuentas locales y revisa el candidato. El punto final de lista v2 pagina los resultados con ; usa su valor devuelto como valor next_tokende la siguiente solicitud . El filtro opcional excluye a los invitados, pero Synapse documenta que este parámetro no es compatible cuando la integración con Matrix Authentication Service está habilitada. Elimínalo en esa configuración.fromguests=false
curl -sS -H "Authorization: Bearer $SYNAPSE_ADMIN_TOKEN" \
  "$SYNAPSE_URL/_synapse/admin/v2/users?from=0&limit=100&guests=false"

nameInspeccione los campos , admin, user_type, y devueltos deactivated. La lista excluye las cuentas desactivadas por defecto. El ejemplo a continuación muestra un único candidato; un servidor real puede devolver varias páginas.

Ejemplo de respuesta de la API de administración de Synapse que muestra la lista de usuarios @inactive:example.org como una cuenta que no es de administrador y que no está desactivada.
Ejemplo de salida de la lista de usuarios: verifique el ID exacto de Matrix, el estado de administrador y el estado de desactivación actual antes de continuar.
  1. Verifique los dispositivos del candidato. Solicite la verificación GET /_synapse/admin/v2/users/<user_id>/devices. Compare la información de cada dispositivo last_seen_tscon el límite establecido en su política; se trata de una marca de tiempo Unix en milisegundos y puede tener un desfase de unos minutos. Trátela como evidencia para su revisión, no como una decisión de eliminación automática.
curl -sS -H "Authorization: Bearer $SYNAPSE_ADMIN_TOKEN" \
  "$SYNAPSE_URL/_synapse/admin/v2/users/%40inactive%3Aexample.org/devices"

Reemplace el ID de matriz de muestra con el usuario local que revisó. Si un dispositivo se usó recientemente, deténgase y confirme con su propietario. Si las marcas de tiempo son antiguas pero la cuenta es un administrador, bot, identidad de soporte o usuario vinculado a SSO, verifique la propiedad y las dependencias antes de continuar. Los documentos de la API del dispositivo last_seen_tsy sus unidades .

Ejemplo de respuesta device-list para @inactive:example.org con un dispositivo web y su marca de tiempo last_seen_ts.
Ejemplo de salida del dispositivo: compruebe el last_seen_ts más reciente en todos los dispositivos de la cuenta con respecto a su período de inactividad aprobado.

¿Cómo se desactiva una cuenta aprobada?

Utilice el ID de Matrix local completo, no un nombre para mostrar. El punto final de desactivación acepta un objeto JSON opcional con erase; por defecto es falso. Si se deja el valor predeterminado, se conservan los campos del perfil, pero se eliminan las sesiones, los dispositivos, las membresías de sala y otros datos de desactivación descritos anteriormente.

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"

Ejecute este proceso para un usuario revisado a la vez. Una respuesta exitosa no sustituye la verificación de que se dirigió a la cuenta correcta. No convierta una lista de marcas de tiempo antiguas en un bucle POST masivo hasta que cada cuenta haya superado sus controles de revisión y retención.

Ejemplo de solicitud POST de curl al punto final de desactivación de Synapse con la opción de borrado establecida en falso.
El cuerpo de la solicitud de ejemplo utiliza erase=false, evitando así las acciones adicionales de eliminación de perfil y de marcador borrado.

¿Cómo se verifica el resultado y se elige borrar?

Vuelva a consultar la cuenta con GET /_synapse/admin/v2/users/<user_id>. Confirme que la respuesta identifica el ID de Matrix esperado e informa "deactivated": true. La cuenta ya no debería tener tokens de acceso, dispositivos ni membresías de sala activos. Conserve la hora de la solicitud y el ID de la cuenta en su registro administrativo, pero nunca almacene el token de portador en dicho registro.

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

Esta opción solo debe configurarse "erase": truecuando su decisión de retención o privacidad requiera específicamente la eliminación del marcador borrado y del campo de perfil de Synapse. Esta configuración no elimina el historial de mensajes ni los archivos multimedia subidos. Si necesita gestionarlos, utilice los procedimientos documentados de eliminación de eventos y gestión de archivos multimedia , y verifique sus efectos de forma independiente. Además, planifique cuidadosamente antes de la desactivación: la reactivación puede requerir establecer una nueva contraseña para las cuentas con contraseña local, y las claves de cifrado del dispositivo eliminadas no se pueden restaurar simplemente reactivando la cuenta.

Ejemplo de respuesta a una consulta de usuario de Synapse con la opción desactivada establecida en verdadero para @inactive:example.org
Ejemplo de respuesta de verificación: confirm desactivated es verdadero para el ID de usuario exacto después de la solicitud POST.

Para la cuenta exacta a la que apuntaste, confirma que la consulta de seguimiento devuelva un resultado "deactivated": true. Si el resultado difiere o la solicitud presenta errores, detente e investiga la respuesta antes de repetir la solicitud POST.

Dejar un comentario

Desactivar usuarios inactivos de Matrix sin borrar el historial de la sala.

Desactivar usuarios inactivos de Matrix sin borrar el historial de la sala.

Revise la actividad del dispositivo, desactive las cuentas de Synapse inactivas confirmadas a través de la API de administración y descubra qué elimina realmente la opción de borrado.

Reduzca la presión de memoria de PostgreSQL en Matrix Synapse.

Determine si la memoria de PostgreSQL proviene del trabajo de consultas, búferes compartidos, conexiones o mantenimiento, y luego realice los cambios necesarios de forma segura para Synapse.

¿Por qué las conexiones de sala de Matrix Synapse son lentas y qué revisar?

¿Por qué las conexiones de sala de Matrix Synapse son lentas y qué revisar?

Antes de cambiar la configuración de Synapse, analice si hay problemas con las conexiones lentas de salas Matrix a un servidor remoto, el retroceso de la federación, la carga de la base de datos local o una cola de envío saliente.

Cerrar registros de Matrix o requerir tokens de invitación en Synapse

Impida la creación de cuentas abiertas en un servidor Synapse autogestionado o mantenga los registros solo por invitación con tokens de registro de uso limitado.

Advertencia sobre la identidad de la sesión de Element: verifique su inicio de sesión de forma segura.

Elimina la advertencia de sesión no verificada de Clear Element mediante el uso de un dispositivo de confianza o una clave de recuperación, con comprobaciones que protegen tu historial de chat cifrado.

Evita los tiempos de espera de bloqueo de archivos de ownCloud con el backend adecuado.

Distinga entre la contención de bloqueos de base de datos y los bloqueos WebDAV caducados, y luego elija y configure la solución adecuada para ownCloud 10.

Qué comprobar cuando ownCloud Web se abre en una página en blanco.

Qué comprobar cuando ownCloud Web se abre en una página en blanco.

Mediante comprobaciones específicas, puede rastrear el problema de una pantalla web de ownCloud en blanco hasta la caché del navegador, la falta de recursos web, errores del servicio o la configuración de la URL del proxy inverso.

Borre la advertencia de memoria PHP de ownCloud en el entorno de ejecución correcto.

Establezca el límite de memoria PHP web de ownCloud, reinicie el servicio correspondiente y verifique el valor activo sin confundirlo con la configuración de la CLI o los límites de carga.

Solución de problemas de conexión a MySQL en ownCloud 10

Averigua si MySQL, PHP, la configuración de sockets o los permisos de la base de datos están bloqueando ownCloud 10 y, a continuación, verifica si existe una solución segura.

Establece un límite de caducidad estricto para los enlaces públicos de ownCloud.

Establece un límite de caducidad estricto para los enlaces públicos de ownCloud.

En ownCloud Classic, haga obligatoria la caducidad de los enlaces públicos, establezca una duración máxima y compruebe los recursos compartidos existentes que puedan necesitar una limpieza por separado.