rtsp-stream安全部署教程：JWT认证与CORS配置最佳实践

rtsp-stream安全部署教程：JWT认证与CORS配置最佳实践

【免费下载链接】rtsp-streamOut of box solution for RTSP - HLS live stream transcoding. Makes RTSP easy to play in browsers.项目地址: https://gitcode.com/gh_mirrors/rt/rtsp-stream

rtsp-stream是一款开箱即用的RTSP-HLS直播流转码解决方案，能让RTSP流轻松在浏览器中播放。本教程将详细介绍如何通过JWT认证和CORS配置来安全部署rtsp-stream，保护你的直播流不被未授权访问和跨域攻击。

为什么需要安全部署rtsp-stream？

在默认配置下，rtsp-stream可能存在安全隐患，如未授权用户可以访问和控制直播流。通过JWT认证可以验证用户身份，CORS配置则能防止跨域请求伪造等攻击，确保直播流的安全性和稳定性。

JWT认证配置步骤

启用JWT认证

JWT（JSON Web Token）是一种轻量级的身份验证机制，rtsp-stream通过core/config/config.go文件中的Auth结构体来配置JWT相关参数。要启用JWT认证，需要设置以下环境变量：

AUTH_JWT_ENABLED=true

配置JWT密钥

JWT支持两种加密方式：secret（HMAC）和rsa（RSA）。你可以通过以下环境变量进行配置：

• 使用HMAC加密：

  AUTH_JWT_METHOD=secret AUTH_JWT_SECRET=your_strong_secret_key

• 使用RSA加密：

  AUTH_JWT_METHOD=rsa AUTH_JWT_PUB_PATH=/path/to/your/public_key.pub

注意：无论使用哪种加密方式，都要确保密钥的安全性，避免泄露。

在代码中验证JWT

rtsp-stream在core/controller.go中通过jwt.Validate方法验证JWT令牌：

token, claims := c.jwt.Validate(r.Header.Get("Authorization"))

JWT的验证逻辑在core/auth/jwt.go中实现，支持HMAC和RSA两种验证方式：

func (jp JWTProvider) verify(token *jwt.Token) (interface{}, error) { if _, ok := token.Method.(*jwt.SigningMethodHMAC); ok { // HMAC验证逻辑 } if _, ok := token.Method.(*jwt.SigningMethodRSA); ok { // RSA验证逻辑 } }

CORS配置最佳实践

启用CORS

CORS（跨域资源共享）配置可以控制哪些域可以访问rtsp-stream的资源。在core/config/config.go文件中，CORS结构体定义了相关配置参数。要启用CORS，设置以下环境变量：

CORS_ENABLED=true

配置允许的源

为了限制只有特定域可以访问你的rtsp-stream服务，设置AllowedOrigins环境变量：

CORS_ALLOWED_ORIGINS=https://yourdomain.com,https://anotherdomain.com

注意：不要使用*通配符，这会允许所有域访问，存在安全风险。

其他CORS配置

• 允许凭据：如果需要在跨域请求中发送cookies等凭据，设置：

  CORS_ALLOW_CREDENTIALS=true

• 预检请求缓存时间：设置预检请求结果的缓存时间（秒）：

  CORS_MAX_AGE=86400

完整的安全部署步骤

1. 克隆仓库：

   git clone https://gitcode.com/gh_mirrors/rt/rtsp-stream cd rtsp-stream

2. 配置JWT认证环境变量：

   export AUTH_JWT_ENABLED=true export AUTH_JWT_METHOD=secret export AUTH_JWT_SECRET=your_strong_secret_key

3. 配置CORS环境变量：

   export CORS_ENABLED=true export CORS_ALLOWED_ORIGINS=https://yourdomain.com export CORS_ALLOW_CREDENTIALS=true export CORS_MAX_AGE=86400

4. 构建并运行：

   make build ./rtsp-stream

验证安全配置

启动rtsp-stream后，你可以通过UI界面测试安全配置是否生效。rtsp-stream提供了简洁的UI界面，位于ui/目录下。

在UI界面中，尝试添加RTSP流并访问，系统应该会要求你提供JWT令牌。同时，通过浏览器的开发者工具，你可以检查CORS响应头是否符合你的配置。

总结

通过本教程，你已经了解了如何为rtsp-stream配置JWT认证和CORS，以提高直播流的安全性。记住，安全配置是一个持续的过程，你需要定期更新密钥和检查配置，确保你的rtsp-stream服务始终受到保护。

如果你想了解更多关于rtsp-stream的配置选项，可以查看core/config/config.go文件，其中包含了所有可用的配置参数。

【免费下载链接】rtsp-streamOut of box solution for RTSP - HLS live stream transcoding. Makes RTSP easy to play in browsers.项目地址: https://gitcode.com/gh_mirrors/rt/rtsp-stream