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

Para evitar registros públicos en un servidor doméstico Matrix autohospedado con Synapse, configure la opción correspondiente enable_registration: falsey homeserver.yamlreinicie Synapse. Si desea que las personas invitadas creen sus propias cuentas, deje el registro habilitado, pero requiera tokens de registro. Tenga en cuenta la registration_shared_secretconfiguración independiente: cualquier persona que la conozca podrá crear cuentas, incluidos los administradores del servidor, incluso cuando el registro ordinario esté deshabilitado.

Elige la política de registro adecuada.

La configuración correcta depende de cómo se deban crear las nuevas cuentas:

  • Servidor privado, cuentas gestionadas por un administrador: desactive el registro público. Cree usuarios mediante register_new_matrix_userel comando de Synapse u otro proceso administrativo autorizado.
  • Servidor solo por invitación; los usuarios se registran desde Element u otro cliente: habilitar el registro y requerir un token. Entregar a cada persona un token de uso limitado a través de un canal privado.
  • Servidor público: los tokens de registro, CAPTCHA o la verificación del correo electrónico/teléfono pueden reducir el abuso automatizado, pero no garantizan que todas las cuentas sean confiables.

Este artículo trata sobre Synapse, la implementación de servidor doméstico Matrix autohospedado más utilizada. Otros programas de servidor doméstico tienen su propia configuración. La documentación de configuración actual de Synapse indica que el registro está deshabilitado por defecto y que los tokens de registro solo funcionan cuando el registro está habilitado. Si utiliza el Servicio de Autenticación Matrix (MAS), consulte su documentación para conocer los controles de registro correspondientes; la API de administración de tokens de registro de Synapse se deshabilita cuando la integración con MAS está habilitada.

Deshabilitar el registro público en Synapse

  1. Localice el archivo de configuración activo. Las instalaciones de paquetes comunes utilizan /etc/matrix-synapse/homeserver.yaml; las instalaciones de contenedores suelen montar el archivo en /data/homeserver.yaml. Utilice la ruta configurada para su servicio en lugar de asumir una ubicación específica.
  2. Realice una copia de seguridad del archivo y, a continuación, active la bandera de registro. En la configuración YAML de nivel superior, añada o modifique la configuración a:
    enable_registration: false
    Si la clave ya existe, edite esa entrada en lugar de añadir una duplicada. La indentación YAML y las claves duplicadas pueden generar confusión, así que mantenga la configuración en el nivel superior y conserve la estructura existente del archivo.
  3. Revise la clave secreta de registro compartida. Synapse admite el script de registro administrativo. La guía de instalación de registration_shared_secretSynapse registration_shared_secret_pathadvierte que alguien con esta clave secreta puede crear cuentas estándar o de administrador incluso con el registro público desactivado. Manténgala privada, restrinja el acceso a su archivo y no la incluya en un repositorio público, en la configuración del cliente ni en un mensaje a los invitados. Si no utiliza el registro con clave secreta compartida, elimine la configuración solo después de confirmar que ninguna automatización depende de ella. En su lugar, puede crear cuentas utilizando otro flujo de trabajo de administrador compatible.
  4. Valida y reinicia Synapse. Utiliza el gestor de servicios, la orquestación de contenedores o el método de implementación que ejecute tu servidor. Para un servicio systemd comúnmente llamado matrix-synapse, un administrador podría ejecutar:
    sudo systemctl restart matrix-synapse
    sudo systemctl status matrix-synapse --no-pager
    El nombre exacto del servicio varía según el paquete o el contenedor. Si el servicio no se inicia, revise los registros; no edite repetidamente un archivo de configuración sin solucionar el error de configuración o de YAML que se reporte.

Las cuentas existentes y el acceso a las salas no se eliminan al deshabilitar el registro. Esta configuración impide nuevos registros regulares a través del proceso de registro del cliente; no se trata de una medida de eliminación de usuarios ni de desactivación del servidor.

Permitir registros únicamente con tokens de registro.

Utilice esta opción cuando desee que los invitados completen el registro por sí mismos, pero no desee una página de registro abierta. En homeserver.yaml, configure ambos ajustes:

enable_registration: true
registration_requires_token: true

Reinicia Synapse después de guardar. Una puerta de token no es lo mismo que deshabilitar el registro: las personas con tokens válidos pueden crear cuentas. El manual de configuración de Synapse recomienda controles antiabuso cuando el registro está habilitado; elige una política adecuada para tu público y capacidad operativa.

Para las versiones de Synapse que admiten la API de administración de tokens de registro documentada, un administrador puede crear un token de un solo uso. El siguiente ejemplo utiliza una URL de marcador de posición y un token de acceso; ejecútelo solo desde un entorno administrativo de confianza, sustituya la URL base pública de su servidor y un token de acceso de administrador, y proteja el historial y los registros de la consola:

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 respuesta incluye el token generado. Comparta ese valor de forma privada con el usuario previsto. La API de Synapse también admite un tiempo de caducidad, medido en milisegundos desde la época Unix; utilice la referencia oficial de la API para calcular y establecer correctamente la caducidad para su implementación. Un token sin límite de uso ni caducidad se configura por defecto con usos ilimitados y sin caducidad, por lo que debe establecer límites de forma deliberada. Los administradores pueden listar, actualizar o eliminar tokens a través de la misma API. No pegue un token de portador o un token de registro real en un problema o artículo público.

La gestión de tokens tiene limitaciones de versión e implementación: consulte la documentación de la API de administración correspondiente a la versión de Synapse instalada. La documentación actual indica que esta API de Synapse no está disponible cuando la integración con MAS está habilitada; en ese caso, utilice la API de administración o la interfaz de línea de comandos (CLI) de MAS.

Errores comunes de configuración

  • Modificar el archivo incorrecto: los contenedores pueden leer un archivo montado, mientras que el host tiene una copia separada. Confirme la ruta utilizada por el proceso Synapse en ejecución.
  • Olvidar el reinicio: el servicio lee los cambios de configuración, por lo que una edición de texto exitosa por sí sola no demuestra que la nueva política esté activa.
  • Suponiendo que el registro esté deshabilitado, todas las rutas se bloquean: un secreto compartido configurado sigue siendo una vía para la creación de cuentas. Protéjalo o elimínelo según si la automatización administrativa lo requiere.
  • Habilitar los tokens pero deshabilitar el registro registration_requires_token no activa el registro de forma independiente. Ambas opciones deben permitir el flujo previsto.
  • Suponiendo que los tokens de acceso restringido por invitación eviten cualquier abuso: un token reutilizable filtrado puede ser utilizado por personas no autorizadas. Limite los usos, establezca una fecha de caducidad cuando sea posible y distribuya los tokens de forma privada.

Verificar el resultado

Tras reiniciar Synapse, abre el flujo de registro de tu servidor en un cliente Matrix con una sesión cerrada. En un servidor cerrado, el cliente no debería permitir un registro público exitoso, pero los usuarios existentes sí deberían poder iniciar sesión. Para el registro con token, prueba el flujo sin token y confirma que lo solicita; luego, usa un token de prueba en una cuenta de prueba controlada y confirma que el registro se realiza correctamente. Si el resultado difiere de la política prevista, revisa los registros de Synapse y el estado del token de la API de administración. Evita realizar pruebas con el token de invitación real si esto consume su único uso permitido.

Referencias oficiales

Dejar un comentario

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.

Agregue el inicio de sesión de dos factores TOTP a ownCloud Infinite Scale con Keycloak.

Agregue el inicio de sesión de dos factores TOTP a ownCloud Infinite Scale con Keycloak.

Habilite TOTP a través de Keycloak, registre usuarios de forma segura y comprenda cuándo se aplican las configuraciones de MFA a nivel de ruta de Infinite Scale.

Restaura la sincronización de ownCloud haciendo coincidir el cliente con tu servidor.

Compruebe si el problema se debe a un fallo de compatibilidad entre OC10 y la versión 7.x o a un registro CSync dañado, y aplique la solución adecuada sin eliminar los archivos sincronizados.

Configura ownCloud con HTTPS usando Let's Encrypt y Nginx.

Configura ownCloud con HTTPS usando Let's Encrypt y Nginx.

Seleccione HTTP-01 o DNS-01, configure un proxy inverso de ownCloud y verifique que Certbot renueve automáticamente los certificados HTTPS.