Cómo configurar la integración de Etherpad en BigBlueButton

La integración de Etherpad en BigBlueButton se configura mediante el componente de notas compartidas del servidor. En BigBlueButton 4.0 beta.4, Etherpad es opcional: instale los paquetes bbb-padsy bbb-etherpad, a continuación, seleccione Etherpad para una reunión o configúrelo como predeterminado para todo el servidor. En instalaciones anteriores donde los paquetes de Etherpad ya están presentes, la tarea principal consiste en elegir el editor y reiniciar los servicios afectados.

Primero, confirme su versión de BigBlueButton. La documentación actual de la versión 4.0 describe un cambio con respecto a la configuración predeterminada anterior: BlockNote es el editor de notas compartidas predeterminado, mientras que los paquetes de Etherpad son opcionales. Por lo tanto, seleccionar explícitamente Etherpad evita depender de una configuración predeterminada específica de la versión. Consulte las notas oficiales sobre las nuevas funciones de BigBlueButton 4.0 y la referencia de la API de BigBlueButton .

Lo que hace la integración

BigBlueButton presenta notas compartidas dentro de una reunión y coordina el acceso al bloc de notas. Etherpad proporciona el editor colaborativo en tiempo real que se utiliza en esa área. En una instalación estándar, los componentes de Etherpad de BigBlueButton se instalan en el mismo servidor; normalmente no es necesario agregar una URL pública de Etherpad por separado ni pegar una clave API de Etherpad en la interfaz de la reunión.

Esta guía describe la configuración del servidor empaquetado y las opciones compatibles a nivel de reunión y de servidor. La implementación en clúster o proxy inverso requiere configuración adicional de URL y origen; su configuración no sustituye la instalación y activación de los componentes de Etherpad.

1. Comprueba tu versión de BigBlueButton y los paquetes instalados.

Ejecute estos comandos en el host de BigBlueButton:

sudo bbb-conf --check
dpkg -l | grep -E 'bbb-(etherpad|pads|shared-notes-server)'

La lista de paquetes ayuda a distinguir entre una instalación de Etherpad ausente y un problema de selección. En un sistema BigBlueButton 4.0 beta.4, las notas oficiales identifican bbb-shared-notes-server(BlockNote) como el paquete predeterminado requerido y bbb-etherpadplus bbb-padscomo paquetes opcionales. Las versiones anteriores pueden mostrar una combinación de paquetes diferente, por lo que se recomienda usar la documentación de la versión instalada en lugar de copiar las instrucciones de la versión 4.0 a un servidor antiguo.

2. Instale los paquetes de Etherpad cuando sea necesario.

En BigBlueButton 4.0 beta.4, instale los paquetes opcionales con APT:

sudo apt update
sudo apt install bbb-pads bbb-etherpad

Revise los cambios propuestos por el gestor de paquetes antes de confirmar. Si APT no encuentra ninguno de los paquetes, compruebe que el repositorio de BigBlueButton esté configurado para la misma versión que el servidor. No descargue un paquete compilado para una versión diferente de BigBlueButton solo para que la instalación continúe.

Tras la instalación, confirme que ambos paquetes aparecen en la lista de paquetes. Si está actualizando un servidor de producción existente, siga el procedimiento de actualización oficial de la versión y programe una ventana de mantenimiento; la instalación de paquetes opcionales implica un cambio en el servidor, no una configuración del cliente de la reunión.

3. Habilitar Etherpad para una reunión.

Para usar Etherpad en una sesión específica sin modificar la configuración predeterminada del servidor, establezca el sharedNotesEditorparámetro en la llamada a la API etherpadde BigBlueButton de esa reunión create:

sharedNotesEditor=etherpad

El parámetro pertenece a la integración del servidor que crea la reunión. La aplicación debe incluirlo en la solicitud de creación firmada antes de calcular la suma de verificación de la API. La API de BigBlueButton acepta etherpado blockNotepara esta opción. Consulte la documentación de la API para conocer el comportamiento de su versión instalada, ya que la validación y los valores predeterminados pueden variar según la versión.

Mantén la clave secreta compartida de BigBlueButton en el servidor. No la expongas en JavaScript del navegador, en el código fuente de la página ni en un cliente móvil. Cualquiera que obtenga la clave secreta podrá realizar llamadas a la API firmadas haciéndose pasar por tu servidor. Si utilizas Greenlight u otra plataforma para reuniones, configura el parámetro mediante los ajustes compatibles de esa integración, en lugar de editar la URL de la reunión en el navegador.

4. Establecer Etherpad como la opción predeterminada para todo el servidor.

Si todas las reuniones deben usar Etherpad, edite el archivo de configuración web de BigBlueButton:

sudo nano /etc/bigbluebutton/bbb-web.properties

Agregue esta línea, conservando las demás configuraciones del archivo:

sharedNotesEditor=etherpad

Guarda el archivo y reinicia BigBlueButton:

sudo bbb-conf --restart

Esta configuración se aplica a las reuniones que no proporcionan su propio sharedNotesEditorvalor. Un parámetro de creación a nivel de reunión puede hacer explícita la elección para una sesión en particular. Las notas oficiales de la versión 4.0 documentan esta misma propiedad para seleccionar Etherpad globalmente y especificar el reinicio con bbb-conf --restart.

5. Comprueba el resultado en una nueva reunión.

Después de reiniciar, inicie una nueva reunión de prueba; una sala que ya esté en funcionamiento podría no reflejar los cambios en la configuración predeterminada. Únase como moderador y segundo participante, abra Notas compartidas y confirme que ambos usuarios pueden ver y editar el mismo bloc de notas. Realice una edición de prueba breve desde cada cuenta, espere a que se actualice la vista del otro participante y verifique el resultado después de cerrar y volver a abrir el panel de notas.

Si está probando una reunión creada mediante una integración de API, inspeccione la solicitud de creación de dicha integración y confirme que incluye el sharedNotesEditor=etherpadparámetro. Para una prueba global predeterminada, cree una reunión sin configurar el parámetro. Esto permite diferenciar una opción faltante a nivel de reunión de un problema de configuración general del servidor.

Implementaciones de proxy de clúster y URL externas

Cuando los navegadores acceden a BigBlueButton a través de un proxy de clúster o un nombre de host público diferente, las URL de notas compartidas y los orígenes del navegador deben coincidir con el diseño del proxy. La guía oficial de proxy de clúster de BigBlueButton documenta la pads.urlconfiguración en /etc/bigbluebutton/bbb-html5.ymly una lista de permitidos de proxy de clúster en /etc/bigbluebutton/etherpad.json. Su URL de ejemplo utiliza una /padruta en el host del proxy público. Siga esa guía en su totalidad para la configuración del clúster, incluidos sus requisitos de origen y proxy; no copie solo la línea de URL en una instalación de servidor único no relacionada.

Tras modificar la configuración del clúster, siga los pasos de reinicio y verificación para la versión de BigBlueButton instalada. Si Etherpad se carga en el nombre de host directo del servidor, pero falla a través del proxy, revise la ruta del proxy, el nombre de host, el certificado TLS y la política de origen del navegador antes de cambiar la selección del editor. Un proxy inverso también debe ser compatible con las conexiones necesarias para la interfaz de edición en tiempo real de Etherpad.

Solución de problemas comunes

  • Notas compartidas se abre en BlockNote. Confirme que la reunión usó sharedNotesEditor=etherpad, o que sharedNotesEditor=etherpadestá presente en /etc/bigbluebutton/bbb-web.propertiespara el valor predeterminado global. En 4.0 beta.4, verifique que los dos paquetes opcionales estén instalados.
  • El panel de notas no aparece o no se carga. Ejecute el comando sudo bbb-conf --check, revise el estado del paquete e inspeccione los registros de servicio de BigBlueButton y Etherpad en busca de errores de inicio o conexión. Confirme que el navegador esté utilizando el nombre de host previsto y el origen HTTPS seguro.
  • Un participante puede editar, pero el otro no. Realice una prueba con una reunión nueva y cuentas desde navegadores diferentes. Verifique que ambos usuarios se hayan unido a la misma reunión y que ningún proxy o capa de autenticación esté bloqueando la sesión de Etherpad ni el tráfico WebSocket.
  • Los cambios no se reflejan tras editar la configuración. Cree una nueva reunión después de reiniciar. Compruebe también si el creador de la reunión está pasando un valor de editor explícito que anule el valor predeterminado del servidor.
  • Funciona directamente, pero falla detrás de un proxy. Compare la URL, la ruta del proxy, la configuración TLS, el origen permitido y la configuración del clúster en las notas públicas con la guía oficial de cluster-proxy. Evite reglas de proxy generales que expongan servicios internos no relacionados.

Controles operativos y de seguridad

Mantenga BigBlueButton, los paquetes de Etherpad y el sistema operativo en rutas de actualización compatibles. Restrinja el acceso a la API administrativa al código del servidor de confianza, utilice HTTPS para los puntos de acceso públicos a las reuniones y notas, y exponga solo las rutas necesarias para su implementación. Si su servicio graba reuniones, pruebe cómo se gestionan las notas compartidas en las grabaciones y una vez finalizadas las reuniones; el comportamiento de la grabación puede depender de la versión de BigBlueButton y de la configuración de grabación.

La configuración se completa cuando en una nueva reunión se selecciona el editor deseado, varios participantes pueden colaborar, la consola del navegador y los registros del servidor no muestran fallos de conexión y el resultado se mantiene constante tras volver a abrir el panel de notas. Para una implementación de la versión 4.0 beta.4, el cambio clave es que Etherpad debe instalarse como un componente opcional y seleccionarse explícitamente. Para otras versiones, verifique el comportamiento del paquete y la API con la documentación de dicha versión antes de modificar un servidor de producción.

Dejar un comentario

Cómo configurar un servidor Matrix Coturn TURN/STUN para llamadas de audio y vídeo

Cómo configurar un servidor Matrix Coturn TURN/STUN para llamadas de audio y vídeo

Configura Coturn con Synapse para llamadas Matrix WebRTC. Configura las credenciales compartidas, NAT, puertos del firewall, opciones TLS y distingue entre TURN heredado, MatrixRTC y LiveKit.

Cómo configurar la aplicación de correo de Nextcloud con autenticación OAuth2

Cómo configurar la aplicación de correo de Nextcloud con autenticación OAuth2

Configura Nextcloud Mail con OAuth2 para Gmail o Microsoft 365, verifica el acceso IMAP/SMTP, soluciona problemas de redireccionamiento y conoce los límites.

Cómo solucionar la advertencia de sesión "No se puede verificar la identidad" en Element

Cómo solucionar la advertencia de sesión "No se puede verificar la identidad" en Element

Solucione el problema de la advertencia de sesión "No se puede verificar la identidad" de Element verificándola con otro dispositivo de confianza o una clave de recuperación, y aprenda cuándo es seguro restablecer la configuración.

Migrar buzones de correo de Kopano a Grommunio o Zammad: Elija la ruta correcta

Migrar buzones de correo de Kopano a Grommunio o Zammad: Elija la ruta correcta

Compara la migración de Kopano con la de grommunio y Zammad. Descubre qué datos de buzón puede conservar cada método, cómo realizar pruebas piloto y verificar los resultados, y cuándo es apropiado utilizar IMAP o una importación personalizada.

Cómo migrar de forma segura una carpeta de datos de Nextcloud a un disco duro externo.

Cómo migrar de forma segura una carpeta de datos de Nextcloud a un disco duro externo.

Traslada un directorio de datos de Nextcloud a un disco duro externo sin romper las referencias de archivos. Utiliza copias de seguridad, un montaje persistente, rsync, permisos y enlaces simbólicos de forma segura.

Solucione el problema de Nextcloud Cron Jobs que no se ejecuta automáticamente con systemd.

Solucione el problema de Nextcloud Cron Jobs que no se ejecuta automáticamente con systemd.

Solucione los problemas con los temporizadores cron de systemd de Nextcloud en Ubuntu comprobando el usuario del servicio, las rutas de PHP y Nextcloud, la activación del temporizador y el historial de ejecución de trabajos.

Cómo configurar la integración de Etherpad en BigBlueButton

Cómo configurar la integración de Etherpad en BigBlueButton

Habilite las notas compartidas de Etherpad en BigBlueButton 4.0 beta.4 o versiones anteriores. Instale paquetes opcionales, elija una configuración predeterminada para la reunión o global y solucione problemas de proxy.

Solucionar el límite de subida de archivos de Nextcloud de 2 GB: Cómo permitir la subida de archivos grandes

Solucionar el límite de subida de archivos de Nextcloud de 2 GB: Cómo permitir la subida de archivos grandes

Soluciona el límite de subida de 2 GB en Nextcloud revisando PHP, Nginx o Apache, los proxies inversos, los tiempos de espera y el almacenamiento. Prueba el cambio de forma segura con un archivo que supere el límite anterior.

Cómo configurar SSL/HTTPS para ownCloud Server con Let's Encrypt

Cómo configurar SSL/HTTPS para ownCloud Server con Let's Encrypt

Configura Let's Encrypt HTTPS para ownCloud Server en Apache. Verifica el DNS y los puertos, emite un certificado con Certbot, habilita las redirecciones y prueba la renovación.

Solucionar el error "Error en la comprobación de integridad" de ownCloud tras una actualización de versión.

Solucionar el error "Error en la comprobación de integridad" de ownCloud tras una actualización de versión.

Diagnostica las advertencias de integridad de ownCloud después de una actualización y elige una solución segura para archivos principales que no coinciden, archivos faltantes, archivos adicionales o errores de firma de la aplicación.