Cum se configurează integrarea Etherpad în BigBlueButton

Integrarea Etherpad în BigBlueButton este configurată prin componenta de note partajate a serverului. Pe BigBlueButton 4.0 beta.4, Etherpad este opțional: instalați pachetele bbb-padsși bbb-etherpad, apoi selectați Etherpad pentru o întâlnire sau setați-l ca implicit la nivel de server. În instalările anterioare în care pachetele Etherpad sunt deja prezente, sarcina principală este alegerea editorului și repornirea serviciilor afectate.

Mai întâi confirmați versiunea BigBlueButton. Documentația actuală 4.0 descrie o modificare față de versiunea implicită anterioară: BlockNote este editorul implicit pentru note partajate, în timp ce pachetele Etherpad sunt opționale. Prin urmare, selectarea explicită a Etherpad evită să vă bazați pe o versiune implicită specifică versiunii. Consultați notele oficiale despre noile funcții BigBlueButton 4.0 și referința API-ului BigBlueButton .

Ce face integrarea

BigBlueButton prezintă notițe partajate în cadrul unei întâlniri și coordonează accesul la blocul de notițe. Etherpad oferă editorul de colaborare live utilizat în acea zonă. Într-o instalare standard, componentele Etherpad ale BigBlueButton sunt instalate pe același server; în mod normal, nu adăugați o adresă URL publică separată pentru Etherpad și nu lipiți o cheie API Etherpad în interfața întâlnirii.

Acest ghid prezintă configurarea serverului pachet și opțiunile acceptate la nivel de întâlnire și la nivel de server. O implementare de cluster sau reverse-proxy necesită o configurare suplimentară a adresei URL și a originii; setările acesteia nu înlocuiesc instalarea și activarea componentelor Etherpad.

1. Verificați versiunea BigBlueButton și pachetele instalate

Executați aceste comenzi pe gazda BigBlueButton:

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

Lista de pachete ajută la distingerea unei instalări Etherpad absente de o problemă de selecție. Pe un sistem BigBlueButton 4.0 beta.4, notele oficiale identifică bbb-shared-notes-server(BlockNote) ca implicit necesar și bbb-etherpadplus bbb-padsca pachete opționale. Versiunile anterioare pot afișa o combinație diferită de pachete, așadar folosiți documentația pentru versiunea instalată efectiv, în loc să copiați instrucțiunile 4.0 pe un server mai vechi.

2. Instalați pachetele Etherpad atunci când este nevoie

Pe BigBlueButton 4.0 beta.4, instalați pachetele opționale cu APT:

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

Verificați modificările propuse de managerul de pachete înainte de confirmare. Dacă APT nu găsește niciunul dintre pachete, verificați dacă depozitul BigBlueButton este configurat pentru aceeași versiune ca serverul. Nu descărcați un pachet construit pentru o versiune diferită de BigBlueButton doar pentru a continua instalarea.

După instalare, confirmați că ambele pachete apar în lista de pachete. Dacă actualizați un server de producție existent, urmați procedura oficială de actualizare a versiunii și programați o fereastră de mentenanță; instalarea pachetelor opționale este o modificare a serverului, nu o setare a clientului de întâlnire.

3. Activați Etherpad pentru o întâlnire

Pentru a utiliza Etherpad într-o anumită sesiune, lăsând setările implicite ale serverului neschimbate, setați sharedNotesEditorparametrul la în apelul API etherpadBigBlueButton al acelei întâlniri :create

sharedNotesEditor=etherpad

Parametrul aparține integrării pe server care creează întâlnirea. Aplicația trebuie să îl includă în cererea de creare semnată înainte de a calcula suma de control API. API-ul BigBlueButton acceptă etherpadsau blockNotepentru această opțiune. Verificați documentația API pentru comportamentul versiunii instalate, deoarece validarea și valorile implicite pot diferi în funcție de versiune.

Păstrați secretul partajat BigBlueButton pe server. Nu îl expuneți în JavaScript-ul browserului, în sursa paginii sau într-un client mobil. Oricine obține secretul poate crea apeluri API semnate ca serverul dvs. Dacă utilizați Greenlight sau un alt front-end pentru întâlniri, configurați parametrul prin setările acceptate ale integrării respective, în loc să editați adresa URL a întâlnirii în browser.

4. Setați Etherpad ca implicit la nivel de server

Dacă fiecare întâlnire ar trebui să utilizeze Etherpad, editați fișierul de suprascriere web BigBlueButton:

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

Adăugați această linie, păstrând celelalte setări din fișier:

sharedNotesEditor=etherpad

Salvați fișierul și reporniți BigBlueButton:

sudo bbb-conf --restart

Această setare se aplică întâlnirilor care nu furnizează propria sharedNotesEditorvaloare. Un parametru de creare la nivel de întâlnire poate face alegerea explicită pentru o anumită sesiune. Notele oficiale 4.0 documentează aceeași proprietate pentru selectarea Etherpad la nivel global și specifică repornirea cu bbb-conf --restart.

5. Testați rezultatul într-o nouă întâlnire

Folosește o nouă întâlnire de test după repornire; o sală deja activă poate să nu reflecte o modificare implicită. Alătură-te ca moderator și ca al doilea participant, deschide Note partajate și confirmă că ambii utilizatori pot vedea și edita același bloc de notițe. Fă o scurtă editare de test din fiecare cont, așteaptă ca vizualizarea celuilalt participant să se actualizeze și verifică rezultatul după închiderea și redeschiderea panoului de note.

Dacă testați o întâlnire creată printr-o integrare API, verificați solicitarea de creare a integrării respective și confirmați că este inclusă sharedNotesEditor=etherpad. Pentru un test implicit global, creați o întâlnire fără a seta parametrul. Aceasta separă o opțiune lipsă la nivel de întâlnire de o problemă de configurare la nivel de server.

Implementări proxy de cluster și URL-uri externe

Când browserele ajung la BigBlueButton printr-un proxy de cluster sau printr-un alt nume de gazdă public, adresele URL ale notelor partajate și originile browserului trebuie să corespundă designului proxy-ului. Ghidul oficial de proxy de cluster al BigBlueButton documentează pads.urlsetarea în /etc/bigbluebutton/bbb-html5.ymlși o listă de permisiuni pentru proxy-uri de cluster în /etc/bigbluebutton/etherpad.json. Adresa URL exemplu utilizează o /padcale pe gazda proxy publică. Urmați ghidul respectiv în întregime pentru configurarea clusterului, inclusiv originea și cerințele proxy; nu copiați doar linia URL într-o instalare pe un singur server, fără legătură.

După modificarea configurației unui cluster, urmați pașii de repornire și verificare pentru versiunea instalată de BigBlueButton. Dacă Etherpad se încarcă pe numele de gazdă direct al serverului, dar eșuează prin proxy, investigați ruta proxy, numele de gazdă, certificatul TLS și politica de origine a browserului înainte de a modifica selecția editorului. Un proxy invers trebuie să accepte și conexiunile necesare interfeței de editare live a Etherpad.

Depanarea defecțiunilor comune

• Se deschide Note partajate în BlockNote. Confirmați că întâlnirea a folosit sharedNotesEditor=etherpad, sau că sharedNotesEditor=etherpadeste prezentă în /etc/bigbluebutton/bbb-web.propertiespentru setările implicite globale. În versiunea 4.0 beta.4, verificați că sunt instalate cele două pachete opționale.
• Panoul de note lipsește sau nu se încarcă. Rulați sudo bbb-conf --check, verificați starea pachetului și inspectați jurnalele de servicii BigBlueButton și Etherpad pentru erori de pornire sau de conexiune. Confirmați că browserul utilizează numele de gazdă dorit și originea HTTPS securizată.
• Un participant poate edita, dar altul nu. Testează cu o întâlnire nouă și conturi din browsere separate. Verifică dacă ambii utilizatori s-au alăturat aceleiași întâlniri și dacă un proxy sau un strat de autentificare nu blochează sesiunea Etherpad sau traficul WebSocket.
• Modificările nu apar după modificările configurației. Creați o întâlnire nouă după repornire. Verificați și dacă creatorul întâlnirii transmite o valoare explicită a editorului care suprascrie valoarea implicită a serverului.
• Funcționează direct, dar eșuează în spatele unui proxy. Comparați URL-ul notelor publice, ruta proxy, configurația TLS, originea permisă și configurația clusterului cu ghidul oficial de proxy pentru cluster. Evitați regulile proxy generale care expun servicii interne fără legătură.

Verificări operaționale și de securitate

Păstrați BigBlueButton, pachetele Etherpad și sistemul de operare pe căile de actualizare acceptate. Restricționați secretele API administrative la codul server-side de încredere, utilizați HTTPS pentru punctele finale ale întâlnirilor publice și ale notelor și expuneți doar rutele necesare implementării. Dacă serviciul dvs. înregistrează întâlnirile, testați modul în care notele partajate sunt gestionate în înregistrări și după încheierea întâlnirilor; comportamentul înregistrărilor poate depinde de versiunea BigBlueButton și de configurația înregistrării.

Configurarea este finalizată atunci când o nouă întâlnire selectează editorul dorit, mai mulți participanți pot colabora, jurnalele consolei browserului și ale serverului nu afișează erori de conexiune, iar rezultatul rămâne consistent după redeschiderea panoului de note. Pentru o implementare 4.0 beta.4, modificarea cheie este că Etherpad trebuie instalat ca o componentă opțională și selectat explicit. Pentru alte versiuni, verificați comportamentul pachetului și al API-ului în raport cu documentația versiunii respective înainte de a modifica un server de producție.