概览
为了增强设备智能,您可以将 Aruba 设备数据与 Cato 的信息搜集进行集成,以提供 IoT/OT 安全服务。来自两个平台的数据被合并,从而创建统一的设备配置文件来增强可见性和分类。
组合视图显示在主页 > 设备 > 库存选项卡中,并帮助改善对已管理和未管理资产的识别。通过更准确和完整的设备数据,您可以在网络中做出更好的安全决策。有关设备清单的更多信息,请参阅什么是设备清单?。.
要配置设备管理集成,您需要:
在 Aruba Networks 中配置集成
在 CMA 中创建 API 连接器
此功能需要IoT/OT安全许可证。
配置 Aruba Networks 集成
配置 Aruba Networks 集成时,需要为 Central 或 Classic Central 创建 API 凭证,并将其输入到 Cato 管理应用程序(CMA)中。
条件
一个 HPE Aruba 网络设备中心 或 经典中心账户,能够访问您要监控的站点
对于 Central:需要权限在 HPE GreenLake 为您的 Central 实例创建一个个人 API 客户端
对于 Classic Central:需要权限创建应用程序和令牌在 Classic Central API 网关中
仅限 Central:设备分配到站点,因为 Central 的监控 API 仅报告分配到站点的设备的遥测数据
访问令牌继承相同的权利和权限,比如您的 Central 用户角色。使用一个角色有权限读取您想收集的监控数据的账户。
步骤 1: 在 Aruba Networks 中配置集成
连接器支持 Central(新 Central)和经典 Central。创建一个 Aruba Networks 连接器为每个 Central 账户。
Central: 使用此选项用于独立 Central 账户或运行 AOS 10 的接入点
经典中心: 使用此选项如果你看到经典中心切换或管理的 AOS 8 Instant APs 在经典中心内
配置 Aruba Central:
登录到您的 HPE Aruba 网络设备中心账户。
导航到 菜单 > API 网关,并选择 REST API 标签页。
点击复制在基本网址旁边。复制并保存基本网址以便输入到 CMA 中。
基本网址是特定于您的账户的托管区域。如果您使用错误的网址,请求将会失败。
在 HPE GreenLake 中,选择 管理工作区。
选择 个人 API 客户端类别并点击 创建个人 API 客户端。
输入一个凭证昵称,例如
Cato 网络基础设施,然后从服务管理器下拉列表中选择您的 Central 实例。点击 创建个人 API 客户端。
复制并保存客户端 ID和客户端密钥,以便在 CMA 中输入。
确认您想监控的接入点已分配到一个站点。未分配设备不返回监控数据,也不会出现 Cato 中。
配置 Aruba 经典 Central:
识别您账户集群的经典 API 网关 URL。经典 Central 使用不同的 API 网关域名。
US-1:
https://app1-apigw.central.arubanetworks.comUS-2:
https://apigw-prod2.central.arubanetworks.comUS-East1:
https://apigw-us-east-1.central.arubanetworks.comUS-West4:
https://apigw-uswest4.central.arubanetworks.comUS-West5:
https://apigw-uswest5.central.arubanetworks.comEU-1:
https://eu-apigw.central.arubanetworks.comEU-Central2:
https://apigw-eucentral2.central.arubanetworks.comEU-Central3:
https://apigw-eucentral3.central.arubanetworks.comCanada-1:
https://apigw-ca.central.arubanetworks.comChina-1:
https://apigw.central.arubanetworks.com.cnAPAC-1:
https://api-ap.central.arubanetworks.comAPAC-EAST1:
https://apigw-apaceast.central.arubanetworks.comAPAC-SOUTH1:
https://apigw-apacsouth.central.arubanetworks.comUAE-NORTH1:
https://apigw-uaenorth1.central.arubanetworks.com
复制并保存 经典 API 网关 URL,以便输入到 CMA 中。
登录到经典 Central。在账户主页页面下,点击全局设置中的API 网关。
打开我的应用程序&令牌标签页。(管理员用户可以使用系统应用程序&令牌标签页。)
点击+ 添加应用程序&令牌。
输入一个应用程序名称,例如
Cato 网络基础设施。将 重定向 URI 留空,并选择网络运维作为应用。单击 生成。应用程序已添加到表格中,令牌已添加到令牌列表中。
从应用程序的行中复制并保存 客户端 ID 和 客户端密钥,以便输入到 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 网关网址
Aruba Classic Central 的 OAuth2 刷新令牌认证:客户端 ID、客户端密钥、刷新令牌、令牌端点和 Aruba Classic Central API 网关网址
要在CMA中创建API连接器:
从导航菜单中,点击资源 > 集成。
点击已配置集成标签页。
点击新建。新集成面板打开。
选择您要添加的SaaS应用程序。
在功能下拉菜单中选择设备管理。
添加在步骤一中创建的详细信息。
点击保存。
该应用在集成应用表格中可见,并具有已连接状态。
通过 Central,Cato 自动发现您账户中的所有站点,并开始收集每个站点的事件。通过经典中央,Cato 收集事件、访问点和无线客户端,并自动更新令牌。
如果连接显示Aruba Classic Central 刷新令牌无效,则代表令牌已过期,被撤销或被其他工具刷新。在API 网关 > My Apps & Tokens中为应用程序生成新令牌。复制并保存刷新令牌以便输入到 CMA。在 Cato 中编辑连接器并粘贴新的刷新令牌。
已知局限性
经典中央不收集有线客户端。经典中央选项仅收集无线客户端。
用户名仅在 802.1X 网络上可用。当 SSID 使用 802.1X / WPA-Enterprise 与 RADIUS 后端对抗时,Aruba 仅填充客户端用户名。在预共享密钥 SSID 上:通常为访客、物联网和 BYOD 网络:没有要报告的用户身份,因此这些网络的客户端事件没有用户归属。
只有中央指派的设备才会被报告。在 Central 中未被分配到站点的设备在 Central API中是不可见的。如果您的设备在经典 Central 中进行管理,请改用经典 Central 认证选项。
经典 Central 令牌必须专用于 Cato。如果其他工具刷新同一令牌,或者令牌未使用超过15天,连接将停止,您需要生成一个新令牌。
API配额。 Central 在整个 Central 账户中实施每秒10次 API 调取的共享速率限制。经典 Central 每秒强制7次 API 调用并每日为每个账户设置 API 调用配额:每天基础5,000次调用,当订阅的设备数超过5,000时,每台基础设备增加30次,每台高级设备增加90次。经典 Central 连接器每天使用约400次调用(每次轮询至少四次:令牌刷新、接入点、客户端和事件),对于大账户来说更多,因为每个列表都以1000页的形式读取。其他共享账户的工具会影响同一配额。