通过阅读本文,您可以了解创建及配置互动白板应用的方法。

前提条件

您已经开通互动白板服务。具体操作,请参见开通服务

背景信息

为保证互动白板服务的正常使用,必须为白板应用进行回调地址和回调鉴权码的配置。在控制台配置回调地址后,当打开或编辑白板时,白板服务将会向配置的回调地址发起HTTP POST请求,获取用户的权限及个人信息。由于采用HTTP请求进行回调,因此需要同时设置回调鉴权码,在HTTP(含HTTPS)回调时增加特定签名头,供回调消息接收服务端进行签名认证,以防止非法或无效请求。

同理,为保障资源安全,您需要为白板应用进行合法域名的配置。当客户端通过长连接访问互动白板服务时,只有访问域名存在于合法域名列表中时才可以正常访问白板服务。

操作步骤

  1. 创建互动白板应用。
    1. 单击互动白板OpenAPI-CreateApp
    2. 输入AppName,单击发起调用

      此处务必记录一下AppID,方便后续互动白板服务的使用。

      001
  2. 设置互动白板应用回调地址。

    您可以根据回调接口完成业务逻辑的开发,单击互动白板OpenAPI-SetAppCallbackUrl,为白板应用设置回调服务地址及回调鉴权码。关于回调接口详情,请参见回调接口详情

    说明 回调地址或回调出参错误可能会导致调用OpenWhiteBoard时提示回调服务失败、客户端访问白板无响应等问题。
  3. 设置互动白板应用合法域名。

    您可以通过单击互动白板OpenAPI-SetAppDomainNames为白板应用设置合法域名列表。其中,AppDomainNames表示所有会使用到白板应用的客户网站域名,多个使用英文逗号(,)分隔,最多传10个。

    注意

    配置合法域名时需要注意以下:

    • 配置的合法域名应符合域名格式,不能使用localhost、IP等,并且不能带有端口号,例如:域名:port。合法域名配置错误或未配置可能会导致客户端连接白板服务跨域拒绝。
    • 本地测试时可以编辑本地hosts文件,构造本地域名,例如:127.0.0.1 example.com,并设置应用的合法域名为example.com。设置完成后,可以使用80端口,用example.com进行本地测试,测试完毕后及时删除测试域名。