BroadWorks Webex E911 紧急呼叫

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

E911 提供商

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

9 线/带宽
内部
RedSky

工作方式

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

查找 -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。

非固定设备的动态位置检测。这些设备是在内部移动的设备（支持 HELD 的桌面电话）。

对于支持 HELD 的桌面电话，位置检测基于网络发现。桌面电话设备使用称为 HTTP 启用位置传递（HELD）的协议向 E911 HELD 服务报告网络环境信息（启用 LLDP 的上行交换机、无线接入点（WAP） BSSID、IP 地址或 MAC 地址）。

E911 服务的动态位置检测。这些设备是非本地的 HELD+ 设备。

对于具备 HELD+ 功能的 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 设备。

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

PSTN和 E911 位置的路由

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

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

E911 集成的要求

组件

要求

E911 呼叫提供商

合作伙伴必须与 E911 呼叫提供商签订协议，以使用 Cisco 为应用程序桌面和Webex客户端提供的实现来路由紧急呼叫。

E911 提供商配置

合作伙伴必须配置 E911 提供商门户，为下列设备提供位置服务：

来自使用线图信息确定位置的被召开设备的呼叫（例如，Webex应用程序）
来自使用主叫号码进行位置确定的非 HELD 设备（DECT、ATA 和协作室/桌面/Board 设备）的呼叫

RedSky 支持文档

RedSky Horizon Mobility 管理指南 — 包含服务商职责。
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

设备

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

Webex 应用程序

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

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

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

E911 紧急呼叫配置任务流程

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

	命令或操作	目的
1	激活功能	使用 CLI 激活功能 101792。
2	配置第三方呼叫 URL	使用 CLI 配置设置，例如 E911 提供商使用的 URL。
3	检查紧急拨号字符串	验证 BroadWorks 用于紧急呼叫的拨号字符串。
4	配置 SIP 标头代理规则	在应用程序服务器上，配置 SIP 标头代理规则。
5	配置第三方紧急呼叫（企业/服务商服务）	在 CommPilot 上，为第三方紧急呼叫配置企业服务。
6	配置第三方紧急呼叫（组服务）	在 CommPilot 上，为第三方紧急呼叫配置组服务。

激活功能

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

AS_CLI/System/ActivatableFeature> activate 101792

配置第三方呼叫 URL

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

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

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

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

Set
    <attribute>, Multiple Choice = {primaryHELDServerURL, secondaryHELDServerURL, emergencyRouteHost, emergencyRoutePort, emergencyRouteTransport}
    <primaryHELDServerURL>, String {1 to 256 characters}
    <secondaryHELDServerURL>, String {1 to 256 characters} 
    <emergencyRouteHost>, IP address | host | domain (1 to 80 chars)
    <emergencyRoutePort>, Integer {1025 to 65355}
    <emergencyRouteTransport>, Choice = {udp, tcp, tls, unspecified}

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


设置	描述
主要 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 未指定 — 此为缺省值

检查紧急拨号字符串

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

AS_CLI/System/CallP/CallTypes> get

  Country Code  Digit Map  Call Type  
  ==================================
   	1       1911 	Emergency  
   	1        911 	Emergency  
   	1        933 	Emergency

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

AS_CLI/System/CallP/CallTypes> add <countryCode> <publicDigitMap> <callType>

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

配置 SIP 标头代理规则

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

1	运行以下 CLI 命令将 `keepOnEgressNetworkOffNet` 标记设置为 true。 `AS_CLI/Interface/SIP/ProxyPolicy/Rule> add proxy911 false false false true false false false false` `AS_CLI/Interface/SIP/ProxyPolicy/Rule> add proxy911 false false false true false false false false`
2	运行以下 CLI 命令将 SIP 标头添加到该规则： `AS_CLI/Interface/SIP/ProxyPolicy/HeaderPolicy> add geolocation proxy911` `AS_CLI/Interface/SIP/ProxyPolicy/HeaderPolicy> add geolocation-routing proxy911`

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

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

准备工作

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

企业预配置模式 — 客户组织为企业。不同组（例如，不同的站点）属于企业内部。
服务商预配置模式 — 组是客户组织。服务商下的不同组互不关联。

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

选中允许激活复选框。

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

企业设置模式 - 输入 E911 提供商提供的值。
服务商配置模式 — 输入虚拟值（下一个任务中的组配置会覆盖这些值）。

单击确定。

您也可以通过后端办公系统使用此命令自动配置这些设置： ServiceProviderThirdPartyEmergencyCallingModify 。

如果您为服务商自己的组织（而非服务商管理的客户组织）配置紧急呼叫，请使用企业预配置模式，然后为服务商自己的组织添加唯一的客户标识和密钥。


字段	描述
允许激活	此参数定义能否为企业内的组激活第三方紧急呼叫。此参数的有效值为 true 和 false。缺省值为 false。如果未指定系统级 HELD 服务器 URL 或未配置紧急路由信息，则不允许企业级激活。
客户标识	该参数定义 E911 客户标识，该标识用于第三方紧急呼叫服务。此值对于由服务商管理的特定客户组织而言是独一无二的。此参数的最大长度为 36 个字符。如果允许激活为 true，则客户标识不得为空。分配与您运行的预配置模式相对应的值：企业模型 - 输入 E911 提供商提供的值。服务商模式 — 输入虚拟值（组服务设置会覆盖此值）。
密钥	此参数定义企业在第三方紧急呼叫服务密钥（由客户标识定义）的唯一 E911 提供商网络。密钥格式为字母数字 UTF-8 格式。此字段在定义客户标识时为必填字段。分配与您运行的预配置模式相对应的值：企业模型 - 输入 E911 提供商提供的值。服务商模式 — 输入虚拟值（组服务设置会覆盖此值）。

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

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

准备工作

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

企业预配置模式 — 客户组织为企业。不同组（例如，不同的站点）属于企业内部。
服务商预配置模式 — 组是客户组织。服务商下的不同组互不关联。

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

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

选中以下两个复选框：

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

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

企业预配置模式 — 将字段留空。应用前一企业服务过程中的值。
服务商配置模型 - 输入 E911 提供商提供的值。

单击确定。

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


字段	描述
启用第三方紧急呼叫设备管理	此参数指定是否为组启用第三方紧急呼叫设备管理。如果企业级别不允许激活，则无法启用此参数。启用组第三方紧急路由时，无法禁用此参数。此参数的有效值为 true（已勾选）和 false（取消勾选）。缺省值为 false。
启用第三方紧急呼叫路由	此参数指定是否为组启用第三方紧急呼叫路由。如果企业级别不允许激活，则无法启用路由。如果没有启用第三方紧急设备管理，则无法启用路由。此参数的有效值为 true（已勾选）和 false（取消勾选）。缺省值为 false。
客户标识	此参数定义用于第三方紧急呼叫服务的 E911 客户标识。此值对于由服务商管理的特定客户组织而言是独一无二的。此参数的最大长度为 36 个字符。如果未定义组服务客户标识，则使用企业/服务商级别的客户标识。分配与您使用的预配置模式相对应的值：企业模式 — 将此字段留空。应用企业服务过程中的值。服务商 - 输入 E911 提供商提供的值。
密钥	该参数定义 E911 密钥第三方紧急呼叫服务所使用的 E911 呼叫。此密钥对于组（由客户标识定义）是独一无二的，并使用字母数字 UTF-8 格式。此字段在定义客户标识时为必填字段。如果未定义密钥，则使用企业/服务商级别的密钥。分配与您使用的预配置模式相对应的值：企业模式 — 将此字段留空。应用企业服务过程中的值。服务商 - 输入 E911 提供商提供的值。

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

动态标记

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

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

标记

数据源

%BWE911-PRIMARY-HELDURL%

AS_CLI/Service/ThirdPartyEmergencyCalling> 主HELD服务器URL

%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应用程序不支持紧急号码中的通配符。只有确切的紧急号码才能添加到保留的自定义标记中。

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

本机标记%BWE911-EMERGENCY-NUMBER-LIST%将添加到设备的模板文件中。
保留的自定义标记%RESERVEDBWE911-EMERGENCY-NUMBER-LIST%被添加到设备使用的标记集中，其值为 911, 1911, 933 。
重建文件时，%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%

描述：启用紧急位置平台
值： [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 日	已更新Webex 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% ，以便管理员编辑位置更新频率。