Inicio
» Cómo
»
Desactivar usuarios inactivos de Matrix sin borrar el historial de la sala.
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.
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 .
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
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 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.
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.
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 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.
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.
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.
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 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.