概览
体验监控提供增强的上下文,例如丢包率或隧道存续时间,以便您获得所需的信息,以确定问题是与您的ISP、Cato Cloud还是其他来源相关。
显示特定于应用程序的指标需要DEM许可证。如需有关购买DEM许可证的更多信息,请联系您的Cato代表。
要配置此集成,您需要:
在您的 Aruba 网络中配置集成
在Cato管理应用程序(CMA)中创建API连接器
配置 Aruba 网络集成
要配置 Aruba 网络集成,请为 Central 或 Classic Central 创建 API 凭证,并将其输入到 Cato 管理应用程序(CMA)中。
Prerequisites
一个 HPE Aruba Networking Central 或 Classic Central 账户,可访问您要监控的站点
对于 Central:权限在 HPE GreenLake 中创建 个人 API 客户端,用于您的 Central 实例
对于 Classic Central:权限在 Classic Central API 网关中创建应用程序和令牌
仅限 Central:分配给站点的设备,因为 Central 的监控 API 仅报告与站点分配设备相关的遥测数据
访问令牌继承与您的 Central 用户角色相同的权限和权限。使用角色有读取访问权限的账户,以便访问您要收集的监控数据。
步骤 1:在 Aruba 网络中配置集成
该连接器支持 Central(新 Central)和 Classic Central。针对每个 Central 账户创建一个 Aruba 网络连接器。
Central: 为独立 Central 账户或运行 AOS 10 的接入点使用此选项
Classic Central: 如果您看到 Classic Central 切换或有 AOS 8 即时 APs 在 Classic Central 中管理,请使用此选项
要配置 Aruba Central:
登录到您的 HPE Aruba 网络 Central 账户。
导航到菜单 > API 网关,并选择REST API标签页。
点击复制旁边的基本 URL。复制并保存基本 URL,以便输入到 CMA 中。
基本 URL 特定于您账户的托管区域。如果您使用错误的网址,请求将失败。
在 HPE GreenLake 中,选择管理工作区。
选择个人 API 客户端类别,然后点击创建个人 API 客户端。
输入一个凭证昵称,例如
Cato 网络基础设施,并从服务管理器下拉菜单中选择您的Central 实例。点击创建个人 API 客户端。
复制并保存 客户端 ID 和 ServiceNow 客户端密钥,以便在 CMA 中输入。
确认您要监控的接入点已分配到一个站点。未分配的设备无法返回监控数据,并且不会显示在 Cato 中。
配置 Aruba Classic Central:
识别您的账户集群的经典 API 网关网址。 Classic Central 使用与 Central 不同的 API 网关域名。
美国-1:
https://app1-apigw.central.arubanetworks.com美国-2:
https://apigw-prod2.central.arubanetworks.com美国东部-1:
https://apigw-us-east-1.central.arubanetworks.com美国-西部4:
https://apigw-uswest4.central.arubanetworks.com美国-西部5:
https://apigw-uswest5.central.arubanetworks.com欧盟-1:
https://eu-apigw.central.arubanetworks.com欧盟中心2:
https://apigw-eucentral2.central.arubanetworks.com欧盟中心3:
https://apigw-eucentral3.central.arubanetworks.com加拿大-1:
https://apigw-ca.central.arubanetworks.com中国-1:
https://apigw.central.arubanetworks.com.cn亚太区-1:
https://api-ap.central.arubanetworks.com亚太-东部1:
https://apigw-apaceast.central.arubanetworks.com亚太-南部1:
https://apigw-apacsouth.central.arubanetworks.com阿联酋-北部1:
https://apigw-uaenorth1.central.arubanetworks.com
复制并保存 经典 API 网关网址,以便在 CMA 中输入。
登录到经典中央系统。在账户主页页下,点击全局设置中的API 网关。
打开我的应用程序&令牌标签页。(管理员用户可以使用系统应用程序&令牌标签页。)
点击+ 添加应用程序&令牌。
输入应用程序名称,例如
Cato 网络基础设施。将 重定向 URI 留空,选择 网络运维 作为应用程序。单击 生成。应用程序已添加到表格中,并且令牌已添加到 令牌列表中。
从应用程序的行中,复制并保存 客户端 ID 和 ServiceNow 客户端密钥,以便在 CMA 中输入。
在令牌列表中,点击下载令牌以获取新令牌。复制并保存 刷新令牌(
refresh_token),以便在 CMA 中输入。在生成令牌后的15分钟内完成 Cato 连接。仅将此应用程序和令牌用于 Cato。经典中心在令牌刷新时发出新的令牌对。如果其他工具或脚本刷新相同的令牌,Cato 的副本将停止工作。
通过在经典 API 网关网址后追加
/oauth2/token来构建令牌端点。对于 US-2,请使用https://apigw-prod2.central.arubanetworks.com/oauth2/token。
步骤 2: 在CMA中创建API连接器
在应用程序需要的集成设置之后,将详情添加到 CMA。
对于Aruba Networks,使用与您的账户匹配的认证选项:
为 Aruba Central 提供 OAuth2 客户端凭证授权:客户端 ID、客户端密钥和 Aruba Central API 网关 URL
为 Aruba Classic Central 提供 OAuth2 刷新令牌认证:客户端 ID、客户端密钥、刷新令牌、令牌端点和 Aruba Classic Central API 网关 URL
要在CMA中创建API连接器:
从导航菜单中,点击资源 > 集成。
点击已配置集成标签页。
点击新建。新集成面板打开。
选择您要添加的SaaS应用程序。
在功能下拉菜单中选择设备管理。
添加在步骤一中创建的详细信息。
点击保存。
该应用在集成应用表格中可见,并具有已连接状态。
使用 Central,Cato 自动发现账户中的所有站点,并开始从每个站点收集事件。使用经典中心,Cato 收集事件、访问点和无线客户端,并自动更新令牌。
如果连接显示 Aruba Classic Central 刷新令牌无效,则说明令牌已过期、被撤销或被其他工具刷新。在API 网关 > 我的应用程序 & 令牌中,为该应用程序生成新的令牌。复制并保存刷新令牌,以便将其输入到 CMA 中。编辑 Cato 中的连接器并粘贴新的刷新令牌。
步骤2:在CMA中创建API连接器
在应用程序需要的集成设置之后,将详情添加到 CMA。
使用与您的 Aruba 账户匹配的认证选项:
为 Aruba Central 提供 OAuth2 客户端凭证授权:客户端 ID、客户端密钥和 Aruba Central API 网关 URL
为 Aruba Classic Central 提供 OAuth2 刷新令牌认证:客户端 ID、客户端密钥、刷新令牌、令牌端点和 Aruba Classic Central API 网关 URL
为连接器输入名称和可选的描述。在生成令牌后的 15 分钟内完成经典中心连接。
要在CMA中创建API连接器:
从导航菜单中,点击资源 > 集成。
点击已配置集成标签页。
点击新建。新集成面板打开。
选择您要添加的SaaS应用程序。
在功能下拉菜单中选择 体验监控。
加入在步骤1中创建的详细信息。
点击 保存。
该应用在集成应用表格中可见,并具有已连接状态。
在中央,Cato会自动发现您账户中的所有站点,并开始收集每个站点的事件。在经典中央,Cato在整个账户中收集事件、接入点和无线客户端,并自动更新令牌。
如果连接显示Aruba经典中央刷新令牌无效,则表明令牌已过期、被撤销或由其他工具刷新。在API网关 > 我的应用程序 & 令牌中为应用程序生成新令牌。复制并保存刷新令牌,以便输入到CMA。然后编辑Cato中的连接器,并输入新的刷新令牌。
已知局限性
信号强度仅在Classic Central中收集。中央的客户端监控API不公开RSSI/dBm。在经典中央中,事件上显示的信号强度是Cato收集时客户端的当前值,而不是事件当下的值。
客户端健康状况、使用量和连接速度在两种选项中均不收集。
有线客户端不会在Classic Central中收集。经典中央选项仅收集无线客户端。
用户名仅在802.1X网络中可用。 Aruba仅在SSID使用802.1X/WPA-Enterprise对抗RADIUS后端时填充客户端用户名。在预共享密钥SSID中,通常是访客、物联网和BYOD网络,没有每个用户的身份可报告。来自这些网络的客户端事件没有用户归属。
使用Central后,仅报告站点分配的设备。不能分配到中央站点的设备对中央API不可见。如果您的设备在经典中央管理,请改用经典中央认证选项。
Classic Central令牌必须专用于Cato。如果其他工具刷新相同的令牌,或者令牌在15天内未使用,连接将停止,您需要生成新令牌。
API配额。中央对整个账户实施10个API调用每秒的共享速率限制。经典中央每秒强制执行 7 个 API 调用,并设置每个账户的每日 API 调用配额:每天 5,000 个基本调用,绑定设备数量上涨,一旦总量超过 5,000,每台基础设备每天 30 个调用,每次高级设备加 90 个调用。经典中央连接器每天使用约 400 个调用(至少每轮调用四次:令牌刷新、接入点、客户端和事件)。对于大型账户,使用量更多,因为每个列表采用每页 1,000 条记录的阅读方式。共享账户的其他工具也计算在同一个配额中。