#许可证管理

#功能说明

许可证功能管理入口为「系统配置 -> 许可证管理」。

请及时联系我方技术团队申请许可证。申请许可证时，需要提供以下信息：

• 实例 ID
• 域名或 IP 地址（例如 example.com）

支持为一个实例配置多个域名，多个域名之间用逗号分隔，例如 example.com, app.example.com, 192.168.1.10。

如果访问地址包含端口，请在域名或 IP 地址中一并提供端口，例如 example.com:13000 或 192.168.1.10:13000。

#使用建议

申请许可证前，请先确认当前部署环境的实际访问地址。许可证会按照提供的实例 ID 与域名或 IP 地址进行匹配，信息不一致可能导致许可证校验失败。配置多个域名后，任一域名命中即可通过校验。

调用 Data Agent API 时，请求必须提供可用于许可证域名校验的来源信息：浏览器通常会自动发送 Origin；curl、Postman 和服务端程序应显式发送 Referer。来源的域名和端口必须与颁发许可证时登记的任一地址一致。

浏览器跨域调用还需要配置 CORS_ORIGIN_WHITELIST。CORS 白名单和许可证域名列表是两层独立校验，具体规则和排查方式请参考 API 请求来源与许可证校验。

如果可信调用方无法设置请求头，可以在受控的 Nginx 反向代理中统一补充 Referer：

location /api {
    proxy_pass http://localhost:13000;
    proxy_set_header Host $host;

    # 补充与许可证登记域名一致的 Referer
    proxy_set_header Referer "https://your-license-domain.com/";
}

不要覆盖浏览器的真实 Origin。服务端会优先校验 Origin，只有请求未携带 Origin 时才读取 Referer。