适用于BroadWorks的Webex RedSky的E911紧急呼叫

此集成符合《Ray Baum Act》第 2 阶段的规定。截至 2022 年 1 月，包括平板电脑在内的所有设备均完全合规。

E911 提供商

本文可以使用以下 E911 供应商配置 E911 紧急呼叫：

  • 9 线/带宽

  • 内部

  • RedSky

工作方式

E911呼叫服务提供RedSky服务提供用户位置服务和网络，将紧急呼叫路由到美国、其领土和加拿大的公共安全应答点(PSAP)。E911 服务可基于每个地点启用。启用位置后，从分配给该位置的电话和客户端发出的紧急呼叫（911用于紧急呼叫，933用于测试呼叫）将使用RedSkyE911呼叫服务，执行以下操作：

  • 查找 -E911 呼叫服务 查找用户位置。应用程序Webex和桌面电话都向 E911 呼叫服务发送 MAC 或网络信息，E911 呼叫服务使用公司线图确定位置。对于 Webex 应用程序用户，如果无法确定其位置，系统会提示用户输入 位置信息，然后提交到 E911 呼叫服务。

  • 路由 - 对于 911 和 933 呼叫，位置信息添加到 SIP 标头，SIP 标头也会将用户标识为 E911 呼叫 用户。E911 服务 将呼叫路由到相应位置的 PSAP。

  • 通知 -E911 服务会向相应的人员（例如，安全或紧急服务）发送通知。

E911 服务 可处理以下任务：

  • E911 提供商 维护合作伙伴/客户预配置数据库，该数据库将紧急呼叫映射到可派遣的位置。

  • 根据呼叫设备的可调度 位置，E911 提供商 会将紧急呼叫引导至正确的 PSAP。该呼叫包括位置信息，以便 PSAP 知道在哪里调度紧急人员以及回呼号码。

  • E911 提供商 会向企业人员生成可选通知。

  • 对于具有增强许可证的订阅 ，E911 提供商 将企业人员桥接到企业用户拨打的紧急呼叫，并提供弹出通知。

位置检测

E911 呼叫服务支持两种主要的位置检测类型：HELD 和非 HELD。

非固定设备的动态位置检测。这些是在本地移动的设备（支持<UNK>的座机）。

  • 对于支持<UNK>的座机，位置检测基于网络发现。桌面电话设备使用名为“启用HTTP的位置传递(HELD)”的协议向E911 <UNK>服务报告其网络环境信息(启用LLDP的上游交换机、无线访问点(WAP) BSSID、IP地址或MAC地址)。

  • 对于桌面上具有HELD+功能的WEBEX应用程序，位置检测也基于网络发现，以向E911 HELD+服务报告其网络环境信息(上游LLDP开关、无线接入点(WAP) BSSID、IP地址或上游网关默认MAC地址)。不支持Cisco Discovery协议(CDP)。

E911 服务的动态位置检测。这些是场外使用的<UNK> +设备。

  • 对于没有蜂窝连接的桌面和移动平台（平板电脑）上支持<UNK> +的Webex应用程序，位置检测基于网络发现，其中包括无线接入点(WAP) BSSID、IP地址、上游网关缺省MAC地址。Webex桌面和平板电脑应用程序不支持LLDP。当 Webex 应用程序确定设备位于已知位置时，用户的位置会自动更新。Webex应用程序会将上面列出的任何可用网络标识符发送给E911提供商。如果E911提供商确定设备位于已知位置，则用户的位置将自动更新。登录时，如果Webex应用程序检测到设备已移至无法识别的位置，系统会提示用户更新新地址。但是，如果在检测到无法识别的位置时用户已登录，系统不会提示用户并在Webex应用程序页脚中显示红色的X。用户可以单击红色X以更新其位置（假定%EMERGENCY_REDSKY_USER_LOCATION_PROMPTING_WXT% 配置标签设置为默认）。E911提供程序会在其数据库中验证并存储新位置。

应忽略Webex桌面（Windows和MacOS）上的所有VPN和虚拟网络接口。对于Windows，Webex应用程序使用MSFT_NetAdapter-“布尔虚拟”参数用于过滤VPN和虚拟接口。

修复了设备位置检测。这些是非持有设备，不会移动。

  • 基于电话号码的位置检测：对于不支持 HELD 的设备（包括没有蜂窝接入的移动设备）、软电话客户端、Cisco ATA、Cisco DECT 系统和任何非 Cisco 客户驻地设备 (CPE)，位置决定基于测试或紧急呼叫中声明的主叫号码。

启用PSTN和RedSkyE911位置的路由

BroadWorks将紧急呼叫路由到RedSkyE911服务，以便呼叫可以发送到适当的PSAP，而不是PSTN。此路由用于从启用RedSkyE911的位置发起紧急呼叫的所有终端。其中包括硬电话和便携式终端（例如手机、平板电脑和笔记本电脑）。

该规则有一个例外情况，即蜂窝电话客户端。这些客户端使用电话内置的拨号程序将紧急呼叫直接发送至公共陆地移动网络（PLMN，即 PSTN 的移动等同项）。

适用于 BroadWorks 的 Webex 中的 E911 紧急呼叫

RedSky E911 集成的要求

组件

要求

RedSky

E911 呼叫提供商

合作伙伴必须与RedSkyan E911呼叫提供商签订协议，使用思科为Webex应用程序桌面和平板电脑客户提供的实现以及MPP电话(HELD)路由紧急呼叫。

RedSky配置 E911提供商配置

合作伙伴必须配置RedSkyE911提供程序门户，为以下类型的设备提供位置服务：

  • 来自使用线图信息确定位置的被召开设备的呼叫（例如，Webex应用程序）

  • 来自使用主叫号码进行位置确定的非 HELD 设备（DECT、ATA 和协作室/桌面/Board 设备）的呼叫

RedSky 支持文档

  • RedSky Horizon移动管理指南—包含服务提供商职责。

  • RedSky Horizon Mobility用户指南—适用于企业管理人员。本指南描述了如何设置接线图。

  • EON客户端安装程序（紧急现场通知）—说明如何设置紧急通知。

内部支持文档

  • 紧急路由服务 LIS 集成指南

  • 紧急路由服务用户指南

9 行/带与支持文档

  • BroadWorks 9Line 管理指南

BroadWorks

要使用此功能，您必须安装下列 BroadWorks 补丁。仅安装适用于您的 BroadWorks 发行版的补丁：

  • 对于 R22：

    • AP.as.23.0.1075.ap381498

    • AP.xsp.22.0.1123.ap381498

    • AP.platform.22.0.1123.ap381498

  • 对于 R23

    • AP.as.22.0.1123.ap381498

    • AP.xsp.23.0.1075.ap381498

    • AP.platform.23.0.1075.ap381498

    • ADP RI 应用程序：CommPilot-23_2021.11_1.160.bwar

  • 对于 R24：

    • AP.as.24.0.944.ap381498

    • ADP RI 应用程序：CommPilot-24_2021.11_1.160.bwar

电话

MPP 电话使用下载的配置参数访问 RedSky 的位置信息服务器 (LIS)。这些电话在已启用 RedSky 的用户拨打 911 或 933 时，会收到通过对等连接向前传递到 RedSky 的一个令牌。

设备

支持 HELD 的设备：为RedSkyE911服务启用位置后，Cisco BroadWorks设备管理系统将生成更新的设备配置以启用功能。每台 HELD 设备必须重新同步或重新初始化才能继续新的配置，然后设备才能将 HELD 用于位置服务。

Webex 应用程序

Webex桌面和平板电脑应用程序使用下载的配置参数访问RedSkyE911提供者的位置信息服务器(LIS)。用户必须一次输入每个位置的位置信息。RedSkyE911提供商维护每个位置的记录。当用户从新位置登录时，系统会提示他们输入位置信息并添加到数据库。

当用户拨打 911 或 933 时，地理位置信息会传递到 SIP 标头。

添加 E911 地址
缺省情况下，Webex应用程序会提示用户在登录未知位置时更新其位置。但是，%EMERGENCY_REDSKY_USER_LOCATION_PROMPTING_WXT% 配置标签允许管理员重新配置频率，以包含任何网络更改到未知位置。请参阅 Webex呼叫的客户端配置标记 了解配置选项。

E911 紧急呼叫配置任务流程

在 BroadWorks 上完成以下任务，为使用 RedSky 的 E911 紧急呼叫配置 Webex for Cisco BroadWorks。在 BroadWorks 上，使用第三方紧急呼叫功能配置 E911。
1

激活功能

使用 CLI 激活功能 101792。

2

配置第三方呼叫 URL

使用CLI配置设置，例如RedSkythe E911提供程序使用的URL。

3

检查紧急拨号字符串

验证 BroadWorks 用于紧急呼叫的拨号字符串。

4

配置 SIP 标头代理规则

在应用程序服务器上，配置 SIP 标头代理规则。

5

配置第三方紧急呼叫（企业/服务商服务）

在 CommPilot 上，为第三方紧急呼叫配置企业服务。

6

配置第三方紧急呼叫（组服务）

在 CommPilot 上，为第三方紧急呼叫配置组服务。

激活功能

在应用程序服务器上，运行以下 CLI 命令激活功能 101792。

AS_CLI/System/ActivatableFeature> 激活101792

配置第三方呼叫 URL

使用CLI使用第三方紧急呼叫参数（例如RedSkyE911提供商URL）配置AS。

1

运行以下 CLI 命令查看当前参数设置：

AS_CLI/Service/ThirdPartyEmergencyCalling> get primaryHELDServerURL= secondaryHELDServerURL= emergencyRouteHost= emergencyRoutePort= emergencyRouteTransport=
2

运行以下 CLI 命令设置参数。参阅后续表格了解以下字段的信息：

设置，多选= {primaryHELDServerURL， secondaryHELDServerURL， emergencyRouteHost， emergencyRoutePort， emergencyRouteTransport} ，字符串{1到256个字符} ，字符串{1到256个字符} ， IP地址 | 主机| 域（1到80个坦克） ，整数{1025 to 65355} ，选择= {udp， tcp， tls，未指定}

有关参数帮助，请参阅下表：

设置

描述

主要 HELD 服务器 URL

此参数定义 HELD 服务器的主要 URL。如果系统中有任何企业允许第三方紧急呼叫激活，则无法清除此参数。此参数的有效值为 1 到 256 个字符的字符串。它应是有效的 http 或 https URL。无缺省值。

次要 HELD 服务器 URL

此参数定义 HELD 服务器的次要 URL。此字段不得与主要 HELD 服务器 URL 相同。此参数的有效值为 1 到 256 个字符的字符串。它应是有效的 http 或 https URL。无缺省值。

紧急路由主机

此参数定义紧急路由主机地址。此参数的值应为有效的 FQDN、IPv4 地址或 IPv6 地址。如果系统中有任何企业允许第三方紧急呼叫激活，则无法清除此参数。无缺省值。

紧急路由端口

此参数定义紧急路由端口。此参数的有效值为 1025 到 65355 之间的整数。无缺省值。

紧急路由传输

此参数定义紧急路由传输协议。此参数的可能值为：

  • UDP

  • TCP

  • TLS

  • 未指定—这是默认值

检查紧急拨号字符串

1

在 AS 上，运行以下 CLI 命令来验证用于紧急呼叫的拨号字符串。请注意，除 911 外还应包含 933。933 前缀用于测试呼叫。

AS_CLI/System/CallP/CallTypes> 获取国家/地区代码数字地图呼叫类型 ================================== 1,1911紧急1,911紧急1,933紧急
2

如果需要添加拨号字符串，请使用以下命令： 

AS_CLI/System/CallP/CallTypes> 添加
有关这些CLI命令的详细信息，请参阅 Cisco BroadWorks应用程序服务器命令行界面管理指南。

配置 SIP 标头代理规则

在应用程序服务器上，结合RedSkyE911提供程序服务器配置SIP标头规则。这是必需的，以便AS可以将地理位置和地理位置路由SIP标头代理到RedSkyE911提供商SIP服务器。
1

运行以下CLI命令，将 keepOnEgressNetworkOffNet 标记设置为 true。

AS_CLI/Interface/SIP/ProxyPolicy/Rule> 添加redsky911代理911 false false true false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false

AS_CLI/Interface/SIP/ProxyPolicy/Rule> 添加redsky911代理911 false false true false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false false

2

运行以下 CLI 命令将 SIP 标头添加到该规则：

AS_CLI/Interface/SIP/ProxyPolicy/HeaderPolicy> 添加地理位置redsky911代理911

AS_CLI/Interface/SIP/ProxyPolicy/HeaderPolicy> 添加地理位置路由redsky911代理911

配置第三方紧急呼叫（企业/服务商服务）

在企业级别配置第三方紧急呼叫设置。

准备工作

请确保了解哪些用作客户标识和密钥配置的预配置模式与该模式相关：

  • 企业预配置模式 — 客户组织为企业。不同组（例如，不同的站点）属于企业内部。

  • 服务商预配置模式 — 组是客户组织。服务商下的不同组互不关联。

1

在“Comm Pilot 服务”窗口中，选择第三方紧急呼叫。

2

选中允许激活复选框。

3

输入客户标识和密钥字段的值，具体取决于您运行的预配置模式：

  • 企业预配置模型—输入RedSky提供商E911提供程序提供的值。

  • 服务商配置模式 — 输入虚拟值（下一个任务中的组配置会覆盖这些值）。

4

单击 确定。

您也可以通过后端办公系统使用此命令自动配置这些设置：服务提供商第三方紧急呼叫修改。
如果您要为服务提供商自己的组织（而不是由服务提供商管理的客户组织）配置紧急呼叫，请使用企业配置模型为服务提供商自己的组织添加唯一的客户ID 和秘密密钥 。

字段

描述

允许激活

此参数定义能否为企业内的组激活第三方紧急呼叫。此参数的有效值为 true 和 false。缺省值为 false。

如果未指定系统级 HELD 服务器 URL 或未配置紧急路由信息，则不允许企业级激活。

客户标识

此参数定义在第三方紧急呼叫服务中使用的RedSkyE911客户ID。此值对于由服务商管理的特定客户组织而言是独一无二的。此参数的最大长度为 36 个字符。如果允许激活为 true，则客户标识不得为空。

分配与您运行的预配置模式相对应的值：

  • 企业模型—输入RedSky提供商E911提供程序提供的值。

  • 服务商模式 — 输入虚拟值（组服务设置会覆盖此值）。

密钥

此参数定义企业（根据客户ID定义）在第三方紧急呼叫服务中使用的唯一RedSkyE911提供程序密钥。密钥格式为字母数字 UTF-8 格式。此字段在定义客户标识时为必填字段。

分配与您运行的预配置模式相对应的值：

  • 企业模型—输入RedSky提供商E911提供程序提供的值。

  • 服务商模式 — 输入虚拟值（组服务设置会覆盖此值）。

配置第三方紧急呼叫（组服务）

如果您使用的是服务商预配置模式，请配置显示在组服务下的第三方紧急呼叫。

准备工作

请确保了解哪些用作客户标识和密钥配置的预配置模式与该模式相关：

  • 企业预配置模式 — 客户组织为企业。不同组（例如，不同的站点）属于企业内部。

  • 服务商预配置模式 — 组是客户组织。服务商下的不同组互不关联。

对于组 档案设置，国家 /地区必须是美国 或 CAN （ 加拿大）。

1

在“Comm Pilot 组服务”窗口中，选择第三方紧急呼叫。

2

选中以下两个复选框：

  • 启用第三方紧急呼叫设备管理

  • 启用第三方紧急呼叫路由

3

根据预配置模式输入此组相应的客户标识和密钥值：

  • 企业预配置模式 — 将字段留空。应用前一企业服务过程中的值。

  • 服务商预配置模式—输入RedSky提供商E911提供商提供的值。

4

单击 确定。

有关字段帮助，请参阅下表。

字段

描述

启用第三方紧急呼叫设备管理

此参数指定是否为组启用第三方紧急呼叫设备管理。如果企业级别不允许激活，则无法启用此参数。启用组第三方紧急路由时，无法禁用此参数。此参数的有效值为 true（已勾选）和 false（取消勾选）。缺省值为 false。

启用第三方紧急呼叫路由

此参数指定是否为组启用第三方紧急呼叫路由。如果企业级别不允许激活，则无法启用路由。如果没有启用第三方紧急设备管理，则无法启用路由。

此参数的有效值为 true（已勾选）和 false（取消勾选）。缺省值为 false。

客户标识

此参数定义在第三方紧急呼叫服务中使用的RedSkyE911客户ID。此值对于由服务商管理的特定客户组织而言是独一无二的。此参数的最大长度为 36 个字符。如果未定义组服务客户标识，则使用企业/服务商级别的客户标识。

分配与您使用的预配置模式相对应的值：

  • 企业模式 — 将此字段留空。应用企业服务过程中的值。

  • 服务商模式—输入RedSky提供商E911提供商提供的值。

密钥

此参数定义与第三方紧急呼叫服务一起使用的RedSkyE911密钥。此密钥对于组（由客户标识定义）是独一无二的，并使用字母数字 UTF-8 格式。此字段在定义客户标识时为必填字段。如果未定义密钥，则使用企业/服务商级别的密钥。

分配与您使用的预配置模式相对应的值：

  • 企业模式 — 将此字段留空。应用企业服务过程中的值。

  • 服务商模式—输入RedSky提供商E911提供商提供的值。

用于紧急呼叫的 Webex 客户端配置标记

动态标记

下表汇总了显示在 Webex 客户端配置文件 (config.wxt-xml) 中的动态 Webex DMS 标记以及如何通过 BroadWorks 配置动态派生。

这些标记是“内置动态”标记，不是由管理员直接创建和填充的自定义标记。

标记

数据源

%BWE911-PRIMARY-HELDURL%

AS_CLI/Service/ThirdPartyEmergencyCalling> 主HELDServerURL

%BWE911-SECONDARY-HELDURL%

AS_CLI/Service/ThirdPartyEmergencyCalling> 辅HELDServerURL

%BWE911-EMERGENCY-NUMBER-LIST%

AS_CLI/System/CallP/CallTypes> 标记为“紧急”的数字映射值

要使用此标签，必须将%RESERVEDBWE911-EMERGENCY-NUMBER-LIST% 保留的自定义标签添加到设备类型使用的标签集中。保留标签必须包含 AS_CLI/System/CallP/CallTypes>下定义的紧急号码，以逗号分隔格式，例如 911、0911、933。

请注意，Webex应用程序不支持紧急号码中的通配符。只有确切的紧急号码才能添加到保留的自定义标记中。

下例显示保留标记功能的使用方式：

  1. 将本地标签%BWE911-EMERGENCY-NUMBER-LIST% 添加到设备的模板文件。

  2. 已保留的自定义标签将在设备使用的标签集中添加，%RESERVEDBWE911-EMERGENCY-NUMBER-LIST%值为911、1911、933。

  3. 重新构建文件后，%BWE911-EMERGENCY-NUMBER-LIST% 原生标签将解析为 911、1911、933。

%BWE911-CUSTOMERID%

已配置的组客户标识（如果不为空）或者服务商/企业配置的标识

%BWE911-SECRETKEY%

已配置的组密钥（如果不为空）或者服务商/企业密钥

自定义标记

以下是用于紧急呼叫的 Webex 应用程序桌面设备和平板电脑自定义标记列表。请参阅 Webex for Cisco BroadWorks 配置指南了解更多详细信息：

有些自定义标记在标记名称中会使用“REDSKY”，但这些标记还可用于使用 9Line/带宽或内部网作为 E911 提供商的 E911 呼叫集成。

%ENABLE_EMERGENCY_DIALING_WXT%

  • 描述：启用紧急呼叫检测

  • 值：[true|false]

  • 默认值：false

%EMERGENCY_DIALING_ENABLE_REDSKY_WXT%

  • 描述：启用 RedSky 紧急位置平台

  • 值：[true|false]

  • 默认值：false

%EMERGENCY_REDSKY_USER_LOCATION_PROMPTING_WXT%

  • 描述：定义 E911 位置提示行为。每次更改到未知位置时，“积极”的值会向用户显示对话框。“”once_per_login值仅在登录未知位置时显示对话框，避免进一步弹出消息并干扰用户。

  • 值：[积极|once_per_login]

  • 默认值： once_per_login

%EMERGENCY_REDSKY_USER_MANDATORY_LOCATION_WXT%

  • 描述：允许用户在位置成为必填字段之前关闭位置对话框的时间。值为“-1”允许用户无限期地关闭对话框。

  • 值：[-1 - 100]

  • 默认值：-1

%EMERGENCY_REDSKY_USER_REMINDER_TIMEOUT_WXT%

  • 描述：以分钟为单位的超时时间，如果当前位置未输入或无效，则用于提醒用户更新紧急位置。如果已设置为 0，则不会提醒。

  • 值： [0 - 43200]

  • 默认值：0

更改历史记录

更改

详细信息

2023年10月25日

更新了 检 测 部分。

2023年5月9日

更新了 bex for BroadWorks中的E911紧急呼 叫 部分。

2022年12月13日

在位置检 测部分添加了说明。

2022 年 8 月 24 日

更新PSTN和 E911 位置启用路由。

2022 年 4 月 25 日

在组服务配置中添加了国家/地区要求。

2022 年 3 月 23 日

向%BWE911-EMERGENCY-NUMBER-LIST% 标签信息添加了通配符限制。

2022年3月21日

添加注释，其中包含有关%BWE911-EMERGENCY-NUMBER-LIST% 本地标签要求的信息。

2022 年 3 月 14 日

添加了新的配置标签 %EMERGENCY_REDSKY_USER_LOCATION_PROMPTING_WXT%，可让管理员编辑位置更新频率。