BigBlueButton에서 Etherpad 연동을 설정하는 방법

BigBlueButton의 Etherpad 통합은 서버의 공유 노트 구성 요소를 통해 설정됩니다. BigBlueButton 4.0 베타 4 버전에서는 Etherpad 사용이 선택 사항입니다. Etherpad bbb-pads패키지 를 설치한 bbb-etherpad후 특정 회의에 대해 Etherpad를 선택하거나 서버 전체의 기본값으로 설정할 수 있습니다. Etherpad 패키지가 이미 설치된 이전 버전에서는 편집기를 선택하고 관련 서비스를 재시작하기만 하면 됩니다.

먼저 사용 중인 BigBlueButton 버전을 확인하십시오. 현재 4.0 버전 문서에는 이전 기본값과의 변경 사항이 설명되어 있습니다. BlockNote가 기본 공유 노트 편집기이며, Etherpad 패키지는 선택 사항입니다. 따라서 Etherpad를 명시적으로 선택하면 특정 버전에 따른 기본값에 의존하지 않게 됩니다. 자세한 내용은 BigBlueButton 4.0의 새로운 기능 설명 과 BigBlueButton API 참조 문서를 확인하십시오 .

통합이 하는 일

BigBlueButton은 회의 중에 공유 메모를 표시하고 메모 패드에 대한 접근 권한을 관리합니다. Etherpad는 해당 영역에서 사용되는 실시간 공동 편집기를 제공합니다. 표준 패키지 설치에서 BigBlueButton의 Etherpad 구성 요소는 동일한 서버에 설치되므로 일반적으로 별도의 공개 Etherpad URL을 추가하거나 Etherpad API 키를 회의 인터페이스에 붙여넣을 필요가 없습니다.

이 가이드에서는 패키지 서버 설정과 지원되는 회의 수준 및 서버 전체 옵션에 대해 설명합니다. 클러스터 또는 리버스 프록시 배포에는 추가적인 URL 및 오리진 구성이 필요하며, 해당 설정은 Etherpad 구성 요소를 설치하고 활성화하는 것을 대체할 수 없습니다.

1. BigBlueButton 버전과 설치된 패키지를 확인하세요.

BigBlueButton 호스트에서 다음 명령을 실행하세요.

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

패키지 목록을 통해 Etherpad 설치 누락과 패키지 선택 오류를 구분할 수 있습니다. BigBlueButton 4.0 beta.4 시스템의 공식 설명서에는 bbb-shared-notes-server(BlockNote)가 필수 기본 패키지로, bbb-etherpadplus는 bbb-pads선택적 패키지로 명시되어 있습니다. 이전 버전에서는 패키지 구성이 다를 수 있으므로, 4.0 버전의 설명서를 이전 서버에 복사하는 대신 실제로 설치된 버전의 설명서를 참조하십시오.

2. 필요에 따라 Etherpad 패키지를 설치합니다.

BigBlueButton 4.0 beta.4에서 APT를 사용하여 선택적 패키지를 설치하세요.

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

패키지 관리자가 제안하는 변경 사항을 확인한 후 설치를 진행하십시오. APT에서 두 패키지 중 하나라도 찾을 수 없는 경우, BigBlueButton 저장소가 서버와 동일한 릴리스 버전으로 구성되어 있는지 확인하십시오. 설치를 진행하기 위해 다른 BigBlueButton 버전용으로 빌드된 패키지를 다운로드하지 마십시오.

설치 후 패키지 목록에 두 패키지가 모두 표시되는지 확인하십시오. 기존 운영 서버를 업그레이드하는 경우 해당 릴리스의 공식 업그레이드 절차를 따르고 유지 관리 기간을 예약하십시오. 선택적 패키지 설치는 서버 변경 사항이며 회의 클라이언트 설정이 아닙니다.

3. 한 회의에 대해 Etherpad를 활성화합니다.

서버의 기본 설정을 변경하지 않고 특정 세션에서 Etherpad를 사용하려면 해당 회의의 BigBlueButton API 호출 에서 sharedNotesEditor매개변수를 설정하십시오.etherpadcreate

sharedNotesEditor=etherpad

해당 매개변수는 회의를 생성하는 서버 측 통합에 속합니다. 애플리케이션은 API 체크섬을 계산하기 전에 서명된 생성 요청에 이 매개변수를 포함해야 합니다. BigBlueButton API는 이 옵션에 대해 etherpad또는 를 허용합니다 blockNote. 유효성 검사 및 기본값은 버전에 따라 다를 수 있으므로 설치된 릴리스의 동작에 대한 자세한 내용은 API 문서를 참조하십시오 .

BigBlueButton 공유 비밀 키는 서버에 보관하십시오. 브라우저 JavaScript, 페이지 소스 또는 모바일 클라이언트에 노출하지 마십시오. 비밀 키를 획득한 사람은 누구나 서버 권한으로 서명된 API 호출을 생성할 수 있습니다. Greenlight 또는 다른 회의 프런트엔드를 사용하는 경우 브라우저에서 회의 URL을 수정하는 대신 해당 통합 기능에서 지원하는 설정을 통해 매개변수를 구성하십시오.

4. Etherpad를 서버 전체의 기본값으로 설정합니다.

모든 회의에서 Etherpad를 사용해야 하는 경우 BigBlueButton 웹 재정의 파일을 편집하십시오.

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

파일의 다른 설정은 그대로 유지한 채 다음 줄을 추가하세요.

sharedNotesEditor=etherpad

파일을 저장하고 BigBlueButton을 다시 시작하세요.

sudo bbb-conf --restart

이 설정은 자체 sharedNotesEditor값을 제공하지 않는 회의에 적용됩니다. 회의 수준 생성 매개변수를 사용하여 특정 세션에 대한 선택을 명시적으로 지정할 수 있습니다. 공식 4.0 노트에서는 Etherpad를 전역적으로 선택하고 재시작을 지정하는 동일한 속성을 설명합니다 bbb-conf --restart.

5. 새로운 회의에서 결과를 검증하십시오.

재시작 후 새 테스트 회의를 사용하세요. 이미 실행 중인 회의실에는 기본 설정 변경 사항이 반영되지 않을 수 있습니다. 사회자와 두 번째 참가자로 참여하여 공유 메모를 열고 두 사용자 모두 동일한 메모장을 보고 편집할 수 있는지 확인하세요. 각 계정에서 간단한 테스트 편집을 수행하고 다른 참가자의 화면이 업데이트될 때까지 기다린 후 메모 패널을 닫았다가 다시 열어 결과를 확인하세요.

API 연동을 통해 생성된 회의를 테스트하는 경우, 해당 연동의 생성 요청을 검사하고 해당 매개변수가 포함되어 있는지 확인하십시오 sharedNotesEditor=etherpad. 전역 기본값 테스트를 위해서는 해당 매개변수를 설정하지 않고 회의를 생성하십시오. 이렇게 하면 회의 수준 옵션 누락과 서버 전체 구성 문제를 구분할 수 있습니다.

클러스터 프록시 및 외부 URL 배포

브라우저가 클러스터 프록시 또는 다른 공용 호스트 이름을 통해 BigBlueButton에 접속할 경우, 공유 노트 URL과 브라우저 출처는 프록시 설정과 일치해야 합니다. BigBlueButton의 공식 클러스터 프록시 가이드pads.url 에는 설정 파일 /etc/bigbluebutton/bbb-html5.yml과 클러스터 프록시 허용 목록 파일이 설명되어 있습니다 /etc/bigbluebutton/etherpad.json. 가이드의 예제 URL은 /pad공용 프록시 호스트의 경로를 사용합니다. 클러스터 설정 시에는 출처 및 프록시 요구 사항을 포함하여 해당 가이드 전체를 따르십시오. URL 부분만 복사하여 단일 서버 설치에 사용하지 마십시오.

클러스터 구성을 변경한 후에는 설치된 BigBlueButton 버전에 맞는 재시작 및 확인 단계를 따르십시오. Etherpad가 서버의 호스트 이름으로 직접 접속했을 때는 로드되지만 프록시를 통해 접속했을 때는 실패하는 경우, 편집기 선택을 변경하기 전에 프록시 경로, 호스트 이름, TLS 인증서 및 브라우저의 출처 정책을 확인하십시오. 또한 역방향 프록시는 Etherpad의 실시간 편집 인터페이스에 필요한 연결을 지원해야 합니다.

일반적인 오류 해결 방법

• 공유 메모는 BlockNote에서 열립니다. 회의에서 사용된 항목이 전역 기본값으로 설정되어 있는지 sharedNotesEditor=etherpad확인 하십시오. 4.0 베타 4 버전에서는 두 개의 선택적 패키지가 설치되어 있는지 확인하십시오.sharedNotesEditor=etherpad/etc/bigbluebutton/bbb-web.properties
• 메모 패널이 없거나 로드되지 않습니다. 명령어를 실행하고 sudo bbb-conf --check, 패키지 상태를 확인하고, BigBlueButton 및 Etherpad 서비스 로그에서 시작 또는 연결 오류를 검사하십시오. 브라우저가 의도한 호스트 이름과 안전한 HTTPS 출처를 사용하고 있는지 확인하십시오.
• 한 참가자는 편집할 수 있지만 다른 참가자는 편집할 수 없습니다. 새 회의를 열고 서로 다른 브라우저의 계정을 사용하여 테스트해 보세요. 두 사용자가 동일한 회의에 참여했는지, 그리고 프록시 또는 인증 계층이 Etherpad의 세션이나 WebSocket 트래픽을 차단하지 않는지 확인하세요.
• 설정을 편집해도 변경 사항이 반영되지 않습니다. 재부팅 후 새 회의를 생성해 보세요. 또한 회의 생성자가 서버 기본값을 재정의하는 명시적인 편집기 값을 전달하고 있는지 확인해 보세요.
• 직접 연결 시에는 작동하지만 프록시 서버를 거치면 작동하지 않습니다. 공개 노트 URL, 프록시 경로, TLS 설정, 허용된 출처 및 클러스터 구성을 공식 클러스터 프록시 가이드와 비교하십시오. 관련 없는 내부 서비스를 노출하는 광범위한 프록시 규칙은 피하십시오.

운영 및 보안 점검

BigBlueButton, Etherpad 패키지 및 운영 체제를 지원되는 업데이트 경로에 따라 유지하십시오. 관리자 API 비밀 키는 신뢰할 수 있는 서버 측 코드에만 제공하도록 제한하고, 공개 회의 및 메모 엔드포인트에는 HTTPS를 사용하며, 배포에 필요한 경로만 노출하십시오. 서비스에서 회의를 녹화하는 경우, 녹화 중 및 회의 종료 후 공유 메모가 어떻게 처리되는지 테스트하십시오. 녹화 동작은 BigBlueButton 릴리스 및 녹화 구성에 따라 달라질 수 있습니다.

새 회의에서 의도한 편집기가 선택되고, 여러 참가자가 공동 작업할 수 있으며, 브라우저 콘솔과 서버 로그에 연결 오류가 표시되지 않고, 메모 패널을 다시 열었을 때도 결과가 일관되게 유지되면 구성이 완료된 것입니다. 4.0 베타 4 배포의 경우, 핵심 변경 사항은 Etherpad를 선택적 구성 요소로 설치하고 명시적으로 선택해야 한다는 점입니다. 다른 릴리스의 경우, 프로덕션 서버를 변경하기 전에 해당 릴리스의 설명서를 참조하여 패키지 및 API 동작을 확인하십시오.