主屏幕网页管理工具使用OpenAPI

使用OpenAPI

设置流程

如需使用应用程序通过OpenAPI与本机通信，请配置本机的OpenAPI设置。

如果已注册本机证书，当使用本机充当服务器时可以使用SSL加密本机与客户端之间的通信。

通过使用本机的简单服务协议(SSDP)功能，可以与OpenAPI连接应用程序顺畅关联。

如需通过OpenAPI执行关联，请按照以下步骤配置设置。

  1. 配置本机的网络设置(此处)

  2. 配置用于OpenAPI认证的基本设置(此处)

  3. 请根据您的环境配置设置

配置基本OpenAPI设置

配置通过OpenAPI建立通信的设置

  1. 在Web Connection的管理员模式下(或在本机的[机器设置]-[管理员]中)选择[网络]-[SSDP设置]，然后配置以下设置。

    设置

    说明

    [SSDP]

    启用SSDP时，请将该选项设置为开启(默认值为开启)。

    这样可以实现以下效果：

    • 通知已在本机开启的OpenAPI服务。

    • 返回搜索OpenAPI服务的响应信息。

    [多点传送TTL设置]

    如有必要，更改SSDP多播信息包的TTL(存活时间)(默认值为[1])

  2. 在Web Connection的管理员模式下(或在本机的[机器设置]-[管理员]中)选择[网络]-[OpenAPI 设置]-[OpenAPI 设置]，然后配置以下设置。

    设置

    说明

    [端口号]

    如有必要，请更改OpenAPI通信的端口号(默认值为[50001])。

    [HTTP版本设置]

    选择HTTP通信的协议版本(默认值为[HTTP/1.1])。

    • [HTTP/1.1]：仅使用HTTP/1.1。

    • [HTTP/2,HTTP/1.1]：连接到HTTP/2时使用HTTP/2。在其它情况下，使用HTTP/1.1。

  • 如果在Web Connection中或本机屏幕上同时更改多个端口号，将会出现端口号重复错误。如果出现端口号重复错误，请逐一更改多个端口号，不要同时更改。

使用代理服务器

当在您的环境中安装了代理服务器时，请注册代理服务器。

在Web Connection的管理员模式下(或在本机的[机器设置]-[管理员]中)选择[网络]-[OpenAPI 设置]-[OpenAPI 设置]，然后配置以下设置。

设置

说明

[代理设置]

注册代理服务器以适合您的操作环境。

  • [代理服务器地址]：输入代理服务器地址。采用下列任意一种格式。
    输入主机名的示例："host.example.com"
    输入IP地址(IPv4)的示例："192.168.1.1"
    输入IP地址(IPv6)的示例："fe80::220:6bff:fe10:2f16"

  • [代理服务器端口号]：如有必要，更改用于HTTP的代理服务器端口号(默认值为[8080])。

  • [代理服务器端口号(HTTPS)]：如有必要，更改代理服务器端口号(默认值为[8080])。

  • [代理服务器端口号(FTP)]：如有必要，更改用于FTP的代理服务器端口号(默认值为[21])。

  • [用户名]：输入用于代理认证的用户名(最多可使用63个字符)。

  • [密码]：输入用于代理认证的密码(最多可使用63个字符)。

使用SSL通信

使用SSL加密本机与应用程序之间通过OpenAPI建立的通信。

  1. 注册本机证书并启用SSL通信(此处)

  2. 在Web Connection的管理员模式下(或在本机的[机器设置]-[管理员]中)选择[网络]-[OpenAPI 设置]，然后配置以下设置。

    设置

    说明

    [SSL/端口设置]

    选择通信时是否使用SSL(默认值为[仅限非-SSL])。

    • [仅限非-SSL]：仅允许非SSL通信。

    • [仅限SSL]：仅允许SSL通信。

    • [SSL/非-SSL]：允许SSL通信和非SSL通信。

    [端口号(SSL)]

    如有必要，请更改SSL通信的端口号(默认值为[50003])。

    [证书验证等级设置]

    如需在SSL通信中验证证书，请选择需要验证的项目。

    • [客户端证书]：选择是否要求连接至本机的客户端提供证书(默认值为关闭)。

    • [有效期]：确认证书是否处于有效期内(默认值为开启)。

    • [CN]：确认证书的CN (公用名)是否匹配服务器地址(默认值为关闭)。

    • [键使用方法]：确认证书的使用是否符合证书发行机构的目标用途(默认值为关闭)。

    • [链式]：确认证书链(证书路径)是否存在问题(默认值为关闭)。系统参照本机管理的外部证书验证证书链。

    • [过期确认]：确认证书是否过期(默认值为关闭)。按照先OCSP(联机证书状态协议)服务，再CRL(证书吊销列表)的顺序执行过期确认。

  • 验证通讯对方的证书(此处)