视频设备网络服务深度配置指南：API 集成、HTTP 安全与代理服务全解析

一、核心配置项解析（含依赖关系与场景适配）

1. 接口类配置：WebSocket 与 XMLAPI（远程管理与集成核心）

（1）Websocket（WebSocket 协议）

• 核心作用：支持通过 WebSocket 协议（不安全 ws / 安全 wss）与设备 API 交互，为二次开发（如自定义控制界面、自动化脚本）和第三方系统（如企业 OA、运维平台）集成提供通道。

• 关键依赖：与 HTTP Mode 强绑定 —— 必须启用 HTTP 或 HTTPS 服务（不可设为 Off），WebSocket 才能正常使用，默认 “FollowHTTPService”（跟随 HTTP 服务状态）。

• 安全建议：生产环境优先启用 HTTPS（禁用 HTTP），搭配 wss 协议访问 WebSocket，避免数据传输被窃听；同时通过防火墙限制 API 访问 IP，仅允许授权网段调用。

• 集成支持：若需对接自研系统，可联系黄经理（13414458918）获取 API 接口文档与对接案例。

（2）XMLAPI Mode（XML API 模式）

• 核心作用：启用设备的 XML API 接口，支持第三方管理平台（如 Poly TMS、企业自研运维系统）远程管控设备。

• 核心功能：可实现批量配置下发、设备状态监控、故障告警推送、会议调度等操作，是中大型企业多设备集中管理的必备配置。

• 安全权衡：

• 开启（默认 On）：降低多设备运维成本，提升管理效率；

• 关闭：提升设备安全性，但失去远程管理能力，仅支持本地操作（适用于单设备、无远程管控需求场景）。

• 配置提示：设备数量≥5 台或多分支机构部署时，务必保持开启；若关闭后需重新联动 TMS，可联系黄经理（13414458918）协助配置。

2. 访问安全类配置：WelcomeText 与 HTTP Mode

（1）WelcomeText（SSH 登录欢迎文本）

• 核心作用：控制用户通过 SSH 登录设备时的信息展示，可自定义设备型号、登录提示、安全须知等内容。

• 默认状态：On（开启），帮助运维人员确认登录设备身份，同时传递安全警示（如 “禁止未授权操作，违规追责”），无需关闭。

• 配置价值：强化运维规范性，避免误操作，是企业安全管理的基础配置。

（2）HTTP Mode（HTTP/HTTPS 访问模式）

• 核心作用：控制设备是否允许通过 HTTP/HTTPS 协议访问（含网页管理界面、API 接口调用），是设备远程访问的基础开关。

• 选项说明：

• HTTPS（推荐）：仅允许加密访问，保护登录凭证、配置数据等敏感信息，适用于生产环境；

• HTTP+HTTPS：兼容两种协议，适用于升级过渡或兼容旧系统场景（升级至 CE9.4 + 且未出厂重置设备默认值）；

• Off：禁用 HTTP/HTTPS 访问，无法使用网页界面，仅支持 SSH 本地操作（不推荐常规场景）。

• 安全建议：优先设置为 “HTTPS”，彻底关闭 HTTP 明文访问，从源头规避数据泄露风险。

3. 代理服务配置：HTTP Proxy（适配企业组网需求）

（1）Mode（代理模式）

• 核心作用：控制设备是否启用 HTTP/HTTPS/WebSocket 流量代理，适配企业内网需通过代理访问外网的场景。

• 选项说明：

• Off（默认）：禁用代理，直接访问网络；

• Manual：手动配置代理服务器地址与端口；

• PACUrl：通过 PAC（代理自动配置）脚本 URL 自动获取代理规则；

• WPAD：完全自动发现代理配置。

• 关键规则：

• 启用代理后，与 Webex 云的通信始终通过代理，与 CUCM/MRA（通过 Expressway 的 CUCM）从不走代理；

• 可通过 “HttpClient UseHttpProxy” 等设置，指定哪些服务使用代理。

• 配置提示：企业内网需代理访问外网时，可联系黄经理（13414458918）协助选择适配模式（如 Manual/PACUrl）。

（2）Authentication Method（代理认证方法）

• 核心作用：配置 HTTP 代理的身份验证方式，需与企业代理服务器认证规则匹配。

• 默认状态：Auto（自动适配），支持 Basic（基本认证）和 Digest-MD5（摘要式认证）。

• 生效条件：必须启用 NetworkServices CommonProxy（通用代理），此设置才能生效；设为 “Basic” 可节省认证往返时间，提升访问效率。

（3）LoginName/Password（代理登录凭据）

• 核心作用：存储 HTTP 代理的认证用户名（0-80 字符）与密码，用于通过代理服务器的身份验证。

• 配置要求：需与企业代理服务器的用户凭据一致，且仅在 Proxy Mode 非 Off 时生效。

（4）PACUrl（PAC 脚本网址）

• 核心作用：设置代理自动配置脚本的 URL（0-255 字符），设备将通过脚本获取动态代理规则。

• 生效条件：需将 Proxy Mode 设为 “PACUrl”，适用于代理规则复杂（如多区域、多服务不同代理）的企业网络。

二、配置联动实操与安全加固步骤

1. 安全访问基础配置：

• 进入 “配置”→“NetworkServices”→“HTTP”，将 Mode 设为 “HTTPS”（禁用 HTTP）；

• WelcomeText 保持 On，自定义安全提示（如 “本设备仅限授权运维人员操作，违规操作将追究责任”）。

2. 远程管理与集成配置：

• Websocket 保持 “FollowHTTPService”（跟随 HTTPS 自动启用 wss 协议）；

• XMLAPI Mode：多设备场景→On，单设备场景→按需 Off。

3. 代理服务配置（企业需代理访问外网时）：

• CommonProxy 设为 “Enabled”（保障代理认证生效）；

• Proxy Mode 选择 “Manual”（手动）或 “PACUrl”（自动），填写对应配置（代理地址 / PAC 脚本 URL）；

• 配置 LoginName/Password（代理认证凭据），Authentication Method 保持 Auto；

4. 验证测试：

• 网页访问：通过 https:// 设备 IP 登录管理界面，确认正常访问；

• API 测试：通过 wss 协议调用 WebSocket 接口，验证集成可用性；

• 代理测试：访问 Webex 云服务，确认通过代理正常连接。

三、关键注意事项

1. 依赖关系优先级：

• WebSocket 依赖 HTTP/HTTPS 服务，Proxy 认证依赖 CommonProxy 启用；

• 未理清依赖关系时，切勿随意关闭相关配置（如关闭 HTTP 导致 WebSocket 失效）。

2. 安全加固核心要点：

• 仅启用 HTTPS，禁用 HTTP 明文访问；

• 开启 API 接口（WebSocket/XMLAPI）后，限制访问 IP（配合防火墙规则）；

• 定期更新代理认证凭据、设备登录密码，避免泄露。

3. 代理特殊规则：设备与 CUCM/MRA 的通信从不走代理，无需为这类服务配置代理例外。

Websocket

FollowHTTPService

It is possible to interact with the API of the device over the WebSocket protocol, both the insecure and secure versions (ws and wss). A WebSocket is tied to HTTP, so that also HTTP or HTTPS must be enabled before you can use WebSockets (see the NetworkServices HTTP Mode setting).

可以通过WebSocket协议（包括不安全版本ws和安全版本wss）与设备的API进行交互。WebSocket与HTTP相关联，因此在使用WebSocket之前，必须启用HTTP或HTTPS（请参阅“网络服务HTTP模式”设置）。

WelcomeText 欢迎文本

On

Choose which information the user should see when logging on to the device through SSH.

选择用户通过SSH登录设备时应看到的信息。

XMLAPI Mode XMLAPI模式

On

Enable or disable the device's XML API. For security reasons this may be disabled. Disabling the XML API will limit the remote manageability with for example TMS, which no longer will be able to connect to the device.

启用或禁用设备的XML API。出于安全原因，此功能可能会被禁用。禁用XML API将限制远程管理能力，例如TMS将无法再连接到该设备。

HTTP 超文本传输协议

Mode 模式

HTTPS

Define whether or not to allow access to the device using the HTTP or HTTPS (HTTP Secure) protocols. Note that the device web interface use HTTP or HTTPS. If this setting is switched Off, you cannot use the device web interface. For additional security (encryption and decryption of requests and pages that are returned by the web server), allow only HTTPS. Note: The default value is HTTP+HTTPS for devices that have been upgraded to CE9.4 (or later) from an earlier software version, provided that the device has not been factory reset after the upgrade.

定义是否允许使用HTTP或HTTPS（HTTP安全）协议访问设备。请注意，设备的网页界面使用HTTP或HTTPS。如果此设置关闭，您将无法使用设备的网页界面。为了获得额外的安全性（对Web服务器返回的请求和页面进行加密和解密），请仅允许HTTPS。注意：对于从早期软件版本升级到CE9.4（或更高版本）且升级后未进行出厂重置的设备，默认值为HTTP+HTTPS。

Proxy 代理

Authentication Method 认证方法

Auto

When the device is configured to use an HTTP proxy with authentication, setting this to Basic makes the device send the outgoing proxy-authentication header in the initial HTTP CONNECT, saving an HTTP authentication challenge/response round trip for each new connection. The NetworkServices CommonProxy setting must be set to Enabled for this setting to take effect.

当设备配置为使用带身份验证的HTTP代理时，将此设置为“基本”会使设备在初始HTTP CONNECT中发送传出的代理身份验证标头，从而为每个新连接节省一次HTTP身份验证质询/响应往返。要使此设置生效，必须将NetworkServices CommonProxy设置设为“启用”。

LoginName 意大利名称

(0 to 80 characters) （0至80个字符）

This is the username part of the credentials for authentication towards the HTTP proxy. We support the following HTTP authentication schemes: Digest using the MD5 algorithm, and the Basic HTTP authentication scheme.

这是用于向HTTP代理进行身份验证的凭据中的用户名部分。我们支持以下HTTP身份验证方案：使用MD5算法的摘要式身份验证，以及基本HTTP身份验证方案。

Mode 模式

Off

You can configure a proxy server for HTTP, HTTPS, and WebSocket traffic. The HTTP proxy can be set up manually, it can be auto-configured (PACUrl), fully automated (WPAD), or it can be turned off. If NetworkServices HTTP Proxy Mode is not turned Off, you can further specify which services shall use the proxy in the HttpClient UseHttpProxy, HttpFeedback UseHttpProxy, and WebEngine UseHttpProxy settings. Communication with the Webex cloud will always go via the proxy if NetworkServices HTTP Proxy Mode is not turned Off. Regardless of the Proxy Mode, the device will never communicate with CUCM or MRA (CUCM via Expressway) via proxy. If NetworkServices CommonProxy is set to Enabled, HTTP proxy authentication is supported in all proxy modes. The authentication data is configured in the NetworkServices HTTP Proxy LoginName/Password settings. A PAC file can return any number of different proxies for a given request; the device will try to authenticate using these credentials to any proxy requesting it. If NetworkSerives CommonProxy set to Disabled, HTTP proxy authentication is supported only in Manual proxy mode.

您可以为HTTP、HTTPS和WebSocket流量配置代理服务器。HTTP代理可以手动设置，也可以自动配置（PACUrl）、完全自动配置（WPAD），或者关闭。如果NetworkServices HTTP代理模式未关闭，您可以在HttpClient UseHttpProxy、HttpFeedback UseHttpProxy和WebEngine UseHttpProxy设置中进一步指定哪些服务应使用代理。如果NetworkServices HTTP代理模式未关闭，与Webex云的通信将始终通过代理进行。无论代理模式如何，设备都绝不会通过代理与CUCM或MRA（通过Expressway的CUCM）进行通信。如果NetworkServices CommonProxy设置为启用，所有代理模式都支持HTTP代理认证。认证数据在NetworkServices HTTP代理登录名/密码设置中配置。PAC文件可以为给定请求返回任意数量的不同代理；设备将尝试使用这些凭据向任何请求认证的代理进行认证。如果NetworkSerives CommonProxy设置为禁用，则仅在手动代理模式下支持HTTP代理认证。

PACUrl PAC网址

(0 to 255 characters) （0到255个字符） PAC网址 （0到255个字符） 设置PAC（代理自动配置）脚本的网址。要求将网络服务HTTP代理模式设置为PAC网址。

Set the URL of the PAC (Proxy Auto Configuration) script. Requires that the NetworkServices HTTP Proxy Mode is set to PACUrl.

设置PAC（代理自动配置）脚本的URL。这要求将NetworkServices HTTP代理模式设置为PACUrl。