bigbluebutton/bbb-lti-broker

LTI Broker Web应用Docker镜像文档

镜像概述

该Docker镜像包含一个作为LTI（Learning Tools Interoperability）代理的Web应用程序，核心功能是充当中间层，连接LTI工具消费者（如学习管理系统LMS）与BigBlueButton（一款开源的虚拟教室和 webinar 平台）应用，实现两者之间的协议转换、认证授权及数据通信，简化集成流程。

核心功能与特性

• LTI协议支持：兼容主流LTI协议版本（如LTI 1.1/1.3），确保与各类LTI工具消费者（如Moodle、Canvas、Blackboard等LMS）的兼容性。
• 集成中间层：无需工具消费者直接对接BigBlueButton API，通过代理层统一处理认证、请求转发与响应转换。
• 安全通信：支持LTI标准的OAuth认证机制，保障工具消费者与BigBlueButton之间数据传输的安全性。
• 简化配置：提供集中化配置界面，减少手动配置步骤，降低集成复杂度。

使用场景与适用范围

适用于需要将BigBlueButton的虚拟教室功能集成到现有学习或培训系统中的场景，例如：

• 教育机构：在LMS中集成BigBlueButton，为师生提供一键进入虚拟教室的功能。
• 企业培训平台：将BigBlueButton的在线会议/培训功能嵌入内部培训系统。
• 在线教育服务商：为客户提供标准化的LMS与BigBlueButton集成方案。

使用方法与配置说明

基本部署（Docker Run）

bash
docker run -d \
  --name lti-broker \
  -p 8080:8080 \
  -e LTI_CONSUMER_KEY="your_lti_consumer_key" \
  -e LTI_CONSUMER_SECRET="your_lti_consumer_secret" \
  -e BBB_API_URL="https://your-bigbluebutton-server/bigbluebutton/api" \
  -e BBB_API_SECRET="your_bigbluebutton_api_secret" \
  [镜像名称]:[标签]

Docker Compose配置示例

yaml
version: '3'
services:
  lti-broker:
    image: [镜像名称]:[标签]
    container_name: lti-broker
    ports:
      - "8080:8080"
    environment:
      - LTI_CONSUMER_KEY=your_lti_consumer_key  # LTI工具消费者的唯一标识
      - LTI_CONSUMER_SECRET=your_lti_consumer_secret  # LTI工具消费者的密钥（用于认证）
      - BBB_API_URL=https://your-bigbluebutton-server/bigbluebutton/api  # BigBlueButton服务器API基础URL
      - BBB_API_SECRET=your_bigbluebutton_api_secret  # BigBlueButton服务器的API密钥
      - PORT=8080  # 应用监听端口（默认8080）
    restart: unless-stopped

环境变量配置说明

使用步骤

1. 准备配置信息：获取LTI工具消费者的LTI_CONSUMER_KEY和LTI_CONSUMER_SECRET（从LMS管理员处获取），以及BigBlueButton服务器的BBB_API_URL和BBB_API_SECRET（从BigBlueButton管理员处获取）。
2. 启动容器：使用上述docker run命令或docker-compose配置启动容器，确保环境变量正确设置。
3. 验证服务：访问http://<服务器IP>:<映射端口>，若返回应用状态页，说明服务启动成功。
4. 在LMS中配置LTI工具：在LMS（如Moodle）中添加LTI外部工具，配置工具URL为http://<服务器IP>:<映射端口>/lti/launch，并填入LTI_CONSUMER_KEY和LTI_CONSUMER_SECRET，完成集成。

注意事项

• 确保BigBlueButton服务器与LTI代理应用之间网络互通，且BBB_API_URL可被应用访问。
• LTI_CONSUMER_SECRET和BBB_API_SECRET属于敏感信息，建议通过环境变量或密钥管理工具注入，避免明文暴露。
• 若需使用HTTPS，可搭配Nginx等反向代理服务器配置SSL证书，确保LTI通信符合安全标准。